db-ojb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From to...@apache.org
Subject cvs commit: db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials pb-tutorial.xml otm-tutorial.xml odmg-tutorial.xml jdo-tutorial.xml
Date Sun, 03 Oct 2004 15:27:54 GMT
tomdz       2004/10/03 08:27:54

  Modified:    src/doc/forrest/src/documentation/content/xdocs/docu/tutorials
                        Tag: OJB_1_0_RELEASE pb-tutorial.xml
                        otm-tutorial.xml odmg-tutorial.xml jdo-tutorial.xml
  Log:
  Updated tutorials to reflect the fact that the tutorial source now resides in its own jar
file and is easily usable with the ojb-blank project
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.1.2.2   +7 -6      db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/pb-tutorial.xml
  
  Index: pb-tutorial.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/pb-tutorial.xml,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- pb-tutorial.xml	27 Jul 2004 00:29:31 -0000	1.1.2.1
  +++ pb-tutorial.xml	3 Oct 2004 15:27:54 -0000	1.1.2.2
  @@ -66,11 +66,12 @@
                       <link href="site:mapping-tutorial">mapping tutorial</link>
                   </p>
                   <p>
  -                    The source code for this tutorial is available with the source distribution
  -                    of OJB in the
  -                    <link href="ext:PBExamples">
  -                        <code>src/test/org/apache/ojb/tutorials/</code>
  -                    </link> directory.
  +                    The source code for all tutorials is available in the seperate
  +                    <code>tutorials-src.jar</code> which you can download
  +                    <link href="ext:ojb/binaries-version">here</link>. If you're
eager
  +                    to try them out, you can use them with the ojb-blank project which
  +                    can be downloaded from the same place. It is described in the
  +                    <link href="site:getting-started">Getting started</link>
section.
                   </p>
               </section>
   
  
  
  
  1.1.2.1   +5 -4      db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/otm-tutorial.xml
  
  Index: otm-tutorial.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/otm-tutorial.xml,v
  retrieving revision 1.1
  retrieving revision 1.1.2.1
  diff -u -r1.1 -r1.1.2.1
  --- otm-tutorial.xml	20 Jun 2004 09:12:33 -0000	1.1
  +++ otm-tutorial.xml	3 Oct 2004 15:27:54 -0000	1.1.2.1
  @@ -73,9 +73,10 @@
                               <link href="site:mapping-tutorial">mapping tutorial</link>.
                           </p>
                           <p>
  -                            The source code for this tutorial is available with the source
distribution
  -                            of OJB in the
  -                            <code>src/test/org/apache/ojb/tutorials/</code>
directory.
  +			                As always the source code for this tutorial can be found in the
  +                            <code>tutorials-src.jar</code> available from
  +			                <link href="ext:ojb/binaries-version">here</link>, more
specifically
  +                            in the <code>org/apache/ojb/tutorials/</code> directory.
                           </p>
                       </section>
   
  
  
  
  1.1.2.1   +8 -4      db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/odmg-tutorial.xml
  
  Index: odmg-tutorial.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/odmg-tutorial.xml,v
  retrieving revision 1.1
  retrieving revision 1.1.2.1
  diff -u -r1.1 -r1.1.2.1
  --- odmg-tutorial.xml	20 Jun 2004 09:12:33 -0000	1.1
  +++ odmg-tutorial.xml	3 Oct 2004 15:27:54 -0000	1.1.2.1
  @@ -61,9 +61,13 @@
                   <link href="site:mapping-tutorial">mapping tutorial</link>
               </p>
               <p>
  -                The source code for this tutorial is available with the source distribution
  -                of OJB in the
  -                <code>src/test/org/apache/ojb/tutorials/</code> directory.
  +                As with the other tutorials, the source code for this tutorial is
  +                contained in the <code>tutorials-src.jar</code> which can be
downloaded
  +                <link href="ext:ojb/binaries-version">here</link>. The source
files
  +                are contained in the <code>org/apache/ojb/tutorial2/</code>
directory.<br/>
  +                You can try it out with the ojb-blank project which can be downloaded from
  +                the same place and is described in the
  +                <link href="site:getting-started">Getting started</link> section.
               </p>
           </section>
   
  
  
  
  1.1.2.1   +39 -34    db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/jdo-tutorial.xml
  
  Index: jdo-tutorial.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/tutorials/jdo-tutorial.xml,v
  retrieving revision 1.1
  retrieving revision 1.1.2.1
  diff -u -r1.1 -r1.1.2.1
  --- jdo-tutorial.xml	20 Jun 2004 09:12:33 -0000	1.1
  +++ jdo-tutorial.xml	3 Oct 2004 15:27:54 -0000	1.1.2.1
  @@ -38,11 +38,10 @@
                       This document demonstrates how to use ObjectRelationalBridge and the
JDO API
                       in a simple application scenario. The tutorial application implements
a
                       product catalog database with some basic use cases. The source code
for the
  -                    tutorial application is shipped with the OJB source distribution and
resides
  -                    in the directory
  -                    <strong>
  -                        <code>[db-ojb]/src/jdori/org/apache/ojb/tutorial5</code>
  -                    </strong>.
  +                    tutorial application is shipped in the <code>tutorials-src.jar</code>
which
  +                    can be downloaded <link href="ext:ojb/binaries-version">here</link>.
The
  +                    source for this tutorial is found in the directory
  +                    <strong><code>org/apache/ojb/tutorial5</code></strong>.
                   </p>
                   <p>
                       This document is not meant as a complete introduction to JDO.
  @@ -54,25 +53,28 @@
                       A full JDO implementation is in the scope of the 2.0 release.
                       <br/>
                       For the time being we provide a plugin to the JDO reference implementation
  -                    called
  -                    <code>OjbStore</code>. The
  -                    <code>OjbStore</code> plugin resides in
  -                    the package
  -                    <code>org.apache.ojb.jdori.sql</code>.
  -                    <br/>
  -                    The work on the
  -                    <em>native OJB-JDO</em> implementation has started. A first
beta
  -                    version is announce for OJB 1.1 version.
  +                    called <code>OjbStore</code>. The <code>OjbStore</code>
plugin resides in
  +                    the package <code>org.apache.ojb.jdori.sql</code>.
                   </note>
               </section>
   
               <section>
                   <title>Running the Tutorial Application</title>
                   <p>
  -                    To install and run the demo application please follow the following
steps:
  -                    </p>
  +                    To install and run the demo application with the <code>ojb-blank</code>
sample
  +                    project (which is described in more detail
  +                    <link href="site:getting-started">here</link>) please follow
the following steps:
  +                </p>
                       <ol>
                           <li>
  +                            Extract the <code>tutorial-src.jar</code> that
you downloaded from
  +                            <link href="ext:ojb/binaries-version">here</link>
into the <code>src/java</code>
  +                            subdirectory of the <code>ojb-blank</code> project.<br/>
  +                            The JDO tutorial source files are contained in the
  +                            <code>org/apache/ojb/tutorial5</code> subdirectory,
and you can safely
  +                            erase the subdirectories of the other tutorials.
  +                        </li>
  +                        <li>
                               Download the JDO Reference Implementation from
                               <link href="ext:sun/jdo">Sun's JDO site</link>.
                               <br/>
  @@ -85,28 +87,31 @@
                                       <code>jdo.jar</code>
                                   </li>
                               </ul>
  -                            into the OJB
  -                            <strong>
  -                                <code>[db-ojb]/lib</code>
  -                            </strong> directory.
  +                            into the <code>lib</code> directory of the project.
                           </li>
                           <li>
  -                            Now compile the sources, setup the test database and perform
bytecode
  -                            enhancement by executing
  -                            <br/>
  -                            <br/>
  -                            <code>
  -                                ant with-jdori prepare-tutorials enhance-jdori
  -                            </code>
  -                            <br/>
  -                            <br/>
  -                            from the ojb toplevel directory.
  +                            Now you can run the test application with these commands:
  +<source><![CDATA[
  +ant build enhance-jdori
  +]]></source>
  +                            from the toplevel project directory. The latter of these commands
  +                            will enhance the jdo tutorial classes. Note that due to some
limitations
  +                            in the JDO reference implementation, the ant target will only
work
  +                            for the JDO tutorial, so if you want to create you own JDO
application
  +                            using the ojb-blank project, you have to adapt the build file
accordingly.<br/>
  +                            To setup the test database you can issue this command
  +<source><![CDATA[
  +ant setup-db
  +]]></source>
                           </li>
                           <li>
                               Now you can start the tutorial application by executing
  -                            <code>bin\tutorial5</code> or
  -                            <code>bin/tutorial5.sh</code>
  -                            from the ojb toplevel directory.
  +<source><![CDATA[
  +cd build/resources
  +
  +java org.apache.ojb.tutorial5.Main
  +]]></source>
  +                            from the project toplevel directory.
                           </li>
                       </ol>
               </section>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org


Mime
View raw message