d061001g.txt 0.04                    UTF-8                   dh:2007-03-10

                       Practical Java ODMA Access 1.00
                       -------------------------------

         CONTENT OF d061001g-practical100-0.56beta.zip ARCHIVE


        ODMJNI 1.0 practical100 0.56beta Evolutionary Development
        ---------------------------------------------------------


     *********************************************************************
     *  WARNING: Earlier versions of this manifest and the corresponding *
     *  d061001g-practical100-0.56beta.zip archives are OBSOLETE.  An    *
     *  additional change was made to provide forward compatibility with *
     *  the interim 0.57beta release of the odmjni100 package and there  *
     *  is correction of an OdmFormat defect and packaging updates.      *
     *      Use archives with d061001g.txt version 0.04 or later.        *
     *********************************************************************


        For the latest version of this material, consult web page
        <http://ODMA.info/dev/devNotes/2006/10/d061001g.htm>.
        There is additional information on the origin and usage of
        this material at that location.

        This package updates the ODMJNI 1.0 practical100 with the
        0.56beta improvements for text-parameter format checking.
        For more information on the releases of which this is a part,
        consult the web page at
        <http://odma.info/dev/devNotes/2006/12/d061201h.htm>.


   If there is any concern for the authenticity of the archive and its
   content, obtain a full replacement copy from the ODMA.info site.


              The software in this package is released under the
              Open Document Management API License 1.0, an open-
              source software license using the BSD template
              license.

              A copy of the license should accompany the
              computer software that is contained in this archive.
              If the license has has been separated from the
              material, obtain a copy at
                 <http://DMware.info/license/>.


The info.odma.practical100 package provides basic interfaces, classes, and
other definitions for implementing ODMA 1.0 access from Java-based
desktop applications on Microsoft Windows.  The component interfaces are
designed to shield Java-based applications from ODMA API details.  The
package provides a practical level of ODMA-aware operations suitable for
typical office-desktop applications.

This distribution updates info.odma.practical100 components to provide
additional format checking of text-string parameters to ODMJNI functions.


   CONTENT

     1. Prerequisites
     2. Manifest
     3. Tools Required
     4. Installation and Usage
     Copyright Notice
     Revision History


1. PREREQUISITES

   To make use of this distribution, it is necessary to have already
   satisfied the following minimum prerequisites:

      * Extraction of Zip material into subdirectories of folders on the
        Microsoft Windows platform (Windows 2000 and later)

      * Execution of console (command-line) sessions, navigation among
        directories, and executing Windows console applications and
        batch scripts.

      * Customization of batch scripts to correctly work with installed
        Java Standard Edition (J2SE) SDK software.

      * Creation of a development tree, starting at some folder, <folder>,
        in which are installed and customized the 0.50beta, 0.52beta, and
        0.54beta distributions of the ODMJNI 1.0 development packages.

   THIS IS AN INCREMENTAL UPDATE.  IT IS ASSUMED THAT THE PREVIOUS BETA
   DISTRIBUTIONS HAVE BEEN INSTALLED IN SEQUENCE, in accordance with the
   instructions for those distributions.


2. MANIFEST

   This archive is designed to be extracted to the <folder> location that is
   the Java classpath point for the ODMJNI 1.0 packages on your computer.

   The material must be extracted ON TOP OF the existing practical100
   materials.

   The update will install material in the following hierarchy when
   extraction is into the directory at <folder>:

            <folder>/
                    d061001g.txt 0.04 this manifest, 10,335 byte file
                        dated 2007-03-10-23:43
                    d061001g-license.txt 0.00 copy of the Open Document
                        Management API License 1.0 applied to this archive,
                        3,215 byte file dated 2007-02-23-12:16
                    d061001g-ReleaseNotes.txt 0.07, 14,562 byte file
                        dated 2007-03-10-23:30 with updates to reflect
                        the final release characteristics
                info/
                    odma/
                        practical100/
                                BuildClasses.bat 0.02, 2,608 byte file
                                    dated 2007-02-28-14:37

                                OdmError.java 0.04, 2007-03-01-15:02
                                OdmFormat.java 0.10, 2007-03-10-17:51
                                OdmInterface.java 0.09, 2007-03-01-15:11
                                OdmNull.java 0.01, 2006-12-18-20:30

                                OdmNullBind.java 0.02, 2007-02-28-20:42
                                OdmNullConnection.java 0.13,
                                    2007-03-01-15:59
                                OdmNullDocument.java 0.06, 2007-03-01-15:52
                                OdmNullFormat.java 0.02, 2007-03-02-13:54
                                OdmNullWorkingDocument.java 0.08,
                                    2007-03-01-16:16

                                [plus all other source-code, scripts, and
                                 compiled classes for the complete
                                 practical100 package]


3. TOOLS REQUIRED

   To access and use the material in this archive, the following resources
   are required:

       Internet Connection and Browser
                      for access to the material and download of the
                      d061003g-practical100-0.56beta.zip file.  Microsoft
                      Internet Explorer 7 has been used to confirm
                      download from the web on the http://ODMA.info/ site.

       Zip-format archive access utility
                      The archive was produced with WinZip 9.0 SR-1 (6224)

       Utility for viewing or editing simple text files
                      Windows Notepad is sufficient.  No tabs are used
                      and word wrap should not be used in viewing. Most
                      lines of text in the body are not wider than 80
                      characters.  Some command lines in logs are wider.
                      The text files in this archive are all in UTF-8
                      encoding and were produced using jEdit 4.2final.

       A Java SE JDK such as the JDK 1.5 used to develop all of the Java
                      applications in this distribution.



4. INSTALLATION AND USAGE

   The entire archive should be extracted into a folder that can be used
   for review of all of the material.  A folder that is chosen for extracts
   of all ODMJNI 1.0 distributions is satisfactory.

   ** NOTE: If the same <folder> has been used to hold earlier materials
   from practical100 development, DO NOT DELETE THE PREVIOUS MATERIAL.
   This archive is designed for extraction on top of a development tree that
   is current to 0.54beta.

   The existing practical100\test\Null01 test will operate.  All of the
   programs for confirmation of odmjni100 0.54beta will also operate without
   change.

   The ReleaseNotes.txt file provides further information on the nature of
   the changes introduced to practical100 for 0.56beta operation.

 - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - -

Questions, comments, discussion and feedback about ODMA concepts, status,
and materials are welcome.  Please send comments to the discussion list at
<mailto:activeodma-discuss@lists.sourceforge.net>.  For further details
visit <http://ODMA.info/contact.htm>.

             Copyright © 2007 NuovoDoc <http://NuovoDoc.com>

           This work is licensed under the Creative Commons Attribution
           License.  To view a copy of this license, visit web site
           http://creativecommons.org/licenses/by/2.5/ or send a letter
           to Creative Commons, 559 Nathan Abbott Way, Stanford,
           California 94305, USA.

Attributions can be made in any suitable scholarly-citation format.  It is
requested that citations identify the material sufficiently for others
to be able to locate the material on their own.   This citation example
can be adapted to your purpose and format:

    Hamilton, Dennis E.
        Content of d061001g-practical100-0.56beta.zip Archive: ODMJNI 1.0
        practical100 0.56beta Evolutionary Development. ODMA Interopera-
        bility Exchange, ODMdev Development Note page d061001g.txt 0.04,
        March 10, 2007.  Current version available as part of the archive at
        <http://ODMA.info/dev/devNotes/2006/10/d061001g.htm>.

 - - - - - - - - - - - - - - - - - - | - - - - - - - - - - - - - - - - - -

0.04 2007-03-10-23:39 Update to reflect changes and content for package
     0.04 with its repair to an OdmFormat defect.  Some text touch-ups have
     also been made.
0.03 2007-03-07-16:40 Correct the attribution version identification and
     update the warning to treat 0.02 and later as correct to use.
0.02 2007-03-07-11:24 Clean up line breaks and declare previous archives
     and manifests obsolete.
0.01 2007-03-06-17:22 Update to reflect change to OdmFormat.java and the
     d061001g-ReleaseNotes.txt file to support integration of the 0.57beta
     odmjni100 release.
0.00 2007-03-04-17:58 Adapt from d061001f.txt 0.04 to provide an account of
     the 0.56beta incremental update to the practical100 package.

$Header: /ODMdev/d061001g.txt 11    07-03-10 23:43 Orcmid $

                       *** end of d061001g.txt ***