db-ojb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From arm...@apache.org
Subject cvs commit: db-ojb/src/doc/forrest/src/documentation/content/xdocs index.xml status.xml
Date Fri, 18 Mar 2005 22:29:27 GMT
arminw      2005/03/18 14:29:27

  Modified:    src/doc/forrest/src/documentation/content/xdocs/docu/guides
                        Tag: OJB_1_0_RELEASE basic-technique.xml
                        repository.xml
               src/doc/forrest/src/documentation/content/xdocs/docu/tutorials
                        Tag: OJB_1_0_RELEASE odmg-tutorial.xml
               src/doc/forrest/src/documentation/content/xdocs Tag:
                        OJB_1_0_RELEASE index.xml status.xml
  Log:
  update docs, changed odmg-api auto-xxx settings
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.1.2.2   +15 -7     db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/basic-technique.xml
  
  Index: basic-technique.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/basic-technique.xml,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- basic-technique.xml	27 Jul 2004 00:29:31 -0000	1.1.2.1
  +++ basic-technique.xml	18 Mar 2005 22:29:26 -0000	1.1.2.2
  @@ -1011,13 +1011,21 @@
                       <em>false</em>
                   </li>
               </ul>
  -            <note>
  -                When using a top-level api (ODMG, OTM, JDO) it is mandatory to use the
  -                <em>default</em> auto-XXX settings (or don't specify the attributes)
  -                for proper work.
  +            <warning>
  +                When using a top-level api (ODMG, OTM, JDO) it is <strong>mandatory
to use specific
  +                auto-xxx settings</strong>.<br/>
  +                <br/>For OTM- and JDO-api the settings are:
  +                <br/>- <em>auto-retrieve="true"</em>
  +                <br/>- <em>auto-update="false"</em>
  +                <br/>- <em>auto-retrieve="false"</em>
  +                <br/>This are at the same time the <em>default</em> auto-XXX
settings (so don't
  +                specify any of this attributes will have the same effect).
                   <br/>
  -                This may change in future.
  -            </note>
  +                <br/>For the ODMG-api the mandatory settings are (since OJB 1.0.2):
  +                <br/>- <em>auto-retrieve="true"</em>
  +                <br/>- <em>auto-update="none"</em>
  +                <br/>- <em>auto-retrieve="none"</em>
  +            </warning>
               <p>
                   The attribute
                   <em>auto-update</em> and
  
  
  
  1.1.2.4   +35 -31    db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml
  
  Index: repository.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml,v
  retrieving revision 1.1.2.3
  retrieving revision 1.1.2.4
  diff -u -r1.1.2.3 -r1.1.2.4
  --- repository.xml	9 Mar 2005 15:23:05 -0000	1.1.2.3
  +++ repository.xml	18 Mar 2005 22:29:26 -0000	1.1.2.4
  @@ -1085,7 +1085,8 @@
                       More info about the <link href="site:basic-technique/cascading">auto-XXX
settings here</link>.
                   </p>
                   <note>
  -                    This attribute must be set to false if using the OTM, ODMG or JDO layer.
  +                    This attribute must be set to <em>false</em> if using the
OTM or JDO layer.
  +                    <br/> For ODMG-api <em>none</em> is mandatory (since
OJB 1.0.2).
                   </note>
                   <p>
                       The <em>auto-delete</em> attribute specifies whether OJB
automatically deletes
  @@ -1094,7 +1095,8 @@
                       More info about the <link href="site:basic-technique/cascading">auto-XXX
settings here</link>.
                   </p>
                   <note>
  -                    This attribute must be set to false if using the OTM, ODMG or JDO layer.
  +                    This attribute must be set to <em>false</em> if using the
OTM or JDO layer.
  +                    <br/> For ODMG-api <em>none</em> is mandatory (since
OJB 1.0.2).
                   </note>
                   <p>
                       The <em>otm-dependent</em> attribute specifies whether
the OTM layer automatically
  @@ -1105,17 +1107,17 @@
                   </p>
                   <source><![CDATA[
   <!ATTLIST reference-descriptor
  -    name CDATA #REQUIRED
  -    class-ref IDREF #REQUIRED
  +	name CDATA #REQUIRED
  +	class-ref IDREF #REQUIRED
   
  -    proxy (true | false) "false"
  -    proxy-prefetching-limit CDATA #IMPLIED
  -    refresh (true | false) "false"
  -
  -    auto-retrieve (true | false) "true"
  -    auto-update (true | false) "false"
  -    auto-delete (true | false) "false"
  -    otm-dependent (true | false) "false"
  +	proxy (true | false) "false"
  +	proxy-prefetching-limit CDATA #IMPLIED
  +	refresh (true | false) "false"
  +
  +	auto-retrieve (true | false) "true"
  +	auto-update (none | link | object | true | false) "false"
  +	auto-delete (none | link | object | true | false) "false"
  +	otm-dependent (true | false) "false"
   >]]></source>
               </section>
   
  @@ -1250,7 +1252,8 @@
                       More info about the <link href="site:basic-technique/cascading">auto-XXX
settings here</link>.
                   </p>
                   <note>
  -                    This attribute must be set to false if using the OTM, ODMG or JDO layer.
  +                    This attribute must be set to <em>false</em> if using the
OTM or JDO layer.
  +                    <br/> For ODMG-api <em>none</em> is mandatory (since
OJB 1.0.2).
                   </note>
                   <p>
                       The <em>auto-delete</em> attribute specifies whether OJB
automatically deletes
  @@ -1259,7 +1262,8 @@
                       More info about the <link href="site:basic-technique/cascading">auto-XXX
settings here</link>.
                   </p>
                   <note>
  -                    This attribute must be set to false if using the OTM, ODMG or JDO layer.
  +                    This attribute must be set to <em>false</em> if using the
OTM or JDO layer.
  +                    <br/> For ODMG-api <em>none</em> is mandatory (since
OJB 1.0.2).
                   </note>
                   <p>
                       The <em>otm-dependent</em> attribute specifies whether
the OTM layer automatically
  @@ -1271,22 +1275,22 @@
                   </p>
                   <source><![CDATA[
   <!ATTLIST collection-descriptor
  -    name CDATA #IMPLIED
  -    collection-class CDATA #IMPLIED
  -    element-class-ref IDREF #REQUIRED
  -    orderby CDATA #IMPLIED
  -    sort (ASC | DESC) "ASC"
  -
  -    indirection-table CDATA #IMPLIED
  -
  -    proxy (true | false) "false"
  -    proxy-prefetching-limit CDATA #IMPLIED
  -    refresh (true | false) "false"
  -
  -    auto-retrieve (true | false) "true"
  -    auto-update (true | false) "false"
  -    auto-delete (true | false) "false"
  -    otm-dependent (true | false) "false"
  +	name CDATA #IMPLIED
  +	collection-class CDATA #IMPLIED
  +	element-class-ref IDREF #REQUIRED
  +	orderby CDATA #IMPLIED
  +	sort (ASC | DESC) "ASC"
  +
  +	indirection-table CDATA #IMPLIED
  +
  +	proxy (true | false) "false"
  +	proxy-prefetching-limit CDATA #IMPLIED
  +	refresh (true | false) "false"
  +
  +	auto-retrieve (true | false) "true"
  +	auto-update (none | link | object | true | false) "false"
  +	auto-delete (none | link | object | true | false) "false"
  +	otm-dependent (true | false) "false"
   >]]></source>
               </section>
   
  
  
  
  No                   revision
  No                   revision
  1.1.2.3   +7 -1      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.2.2
  retrieving revision 1.1.2.3
  diff -u -r1.1.2.2 -r1.1.2.3
  --- odmg-tutorial.xml	23 Jan 2005 03:09:13 -0000	1.1.2.2
  +++ odmg-tutorial.xml	18 Mar 2005 22:29:27 -0000	1.1.2.3
  @@ -61,6 +61,12 @@
                   <link href="site:mapping-tutorial">mapping tutorial</link>
               </p>
               <p>
  +                When using 1:1, 1:n and m:n references the ODMG-api need specific metadata
  +                settings on relationship definition - more info see
  +                <link href="site:basic-technique/cascading">auto-xxx settings</link>
and
  +                <link href="site:repository">repository file settings</link>.
  +            </p>
  +            <p>
                   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
  
  
  
  No                   revision
  No                   revision
  1.1.2.2   +2 -1      db-ojb/src/doc/forrest/src/documentation/content/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/index.xml,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- index.xml	23 Jan 2005 03:09:13 -0000	1.1.2.1
  +++ index.xml	18 Mar 2005 22:29:27 -0000	1.1.2.2
  @@ -71,6 +71,7 @@
                   <p>
                       See
                       <link href="site:faq/apis">the FAQ</link> for a detailed
view of the OJB layering.
  +                    API's <link href="site:status">status here</link>. 
                   </p>
   
               </section>
  
  
  
  1.1.2.2   +9 -9      db-ojb/src/doc/forrest/src/documentation/content/xdocs/status.xml
  
  Index: status.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/src/doc/forrest/src/documentation/content/xdocs/status.xml,v
  retrieving revision 1.1.2.1
  retrieving revision 1.1.2.2
  diff -u -r1.1.2.1 -r1.1.2.2
  --- status.xml	23 Jan 2005 03:09:13 -0000	1.1.2.1
  +++ status.xml	18 Mar 2005 22:29:27 -0000	1.1.2.2
  @@ -31,24 +31,22 @@
           <section>
               <title>PB API (Persistence Broker API)</title>
               <p>
  -                The PB API implementation is <strong>stable</strong>.
  +                The PB API implementation is <strong>stable</strong>, known
  +                issues can be found in
  +                <link href="ext:release-notes">release-notes</link>.
               </p>
           </section>
   
           <section>
               <title>ODMG API</title>
               <p>
  -                The ODMG API implementation is <strong>stable</strong>, but
there some <strong>known
  -                issues</strong> - see
  +                The ODMG API implementation is <strong>stable</strong>, known
  +                issues can be found in
                   <link href="ext:release-notes">release-notes</link>.
               </p>
               <note>
                   OQL is currently not
                   fully implemented (Aggregations and Method Invocations).
  -                <br/>
  -                ODMG implicit locking is partly implemented but does currently not
  -                maintain transaction isolation properly. To achieve safe transaction
  -                isolation client application must use explicit lock acquisition.
               </note>
   
           </section>
  @@ -57,7 +55,9 @@
               <title>JDO API</title>
               <p>
                   By providing a plugin to the SUN JDO Reference Implementation we provide
  -                a complete JDO 1.0.1 <strong>prototype</strong> O/R mapping
tool.
  +                a complete JDO 1.0.1 <strong>prototype</strong> O/R mapping
tool. Integration in
  +                <em>managed environments</em> (in particular JTA integration)
is not supported for JDO 1.0 prototype.
  +                <br/>
                   A complete Apache licensed JDO 2.0 implementation is scheduled for OJB
2.0.
               </p>
           </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