svn commit: r888244 - in /websites/staging/isis/trunk: cgi-bin/ content/ content/components/objectstores/jdo/eagerly-registering-entities.html

[bu...@apache.org]

Author: buildbot
Date: Wed Nov 27 08:26:24 2013
New Revision: 888244

Log:
Staging update by buildbot for isis

Modified:
    websites/staging/isis/trunk/cgi-bin/   (props changed)
    websites/staging/isis/trunk/content/   (props changed)
    websites/staging/isis/trunk/content/components/objectstores/jdo/eagerly-registering-entities.html

Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Nov 27 08:26:24 2013
@@ -1 +1 @@
-1544583
+1545960

Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Nov 27 08:26:24 2013
@@ -1 +1 @@
-1544583
+1545960

Modified: websites/staging/isis/trunk/content/components/objectstores/jdo/eagerly-registering-entities.html
==============================================================================
--- websites/staging/isis/trunk/content/components/objectstores/jdo/eagerly-registering-entities.html (original)
+++ websites/staging/isis/trunk/content/components/objectstores/jdo/eagerly-registering-entities.html Wed Nov 27 08:26:24 2013
@@ -278,30 +278,34 @@
 <p>In any case, it's probably not good practice to have DataNucleus work this way.  The <code>RegisterEntities</code> service can therefore be registered in order to do the eager registration.  It searches for all <code>@PersistenceCapable</code> entities under specified package(s), and registers them all.</p>
 
 <blockquote>
-  <p><strong><em>We strongly recommend that you register this service 
-  as a matter of course</em></strong></p>
+  <p>in 1.3.x, it is not mandatory to eagerly register entity types; however we strongly recommend it.
+  in 1.4.0-SNAPSHOT, it <em>is</em> mandatory to eager register entity types.</p>
 </blockquote>
 
-<h3>Register the Service</h3>
+<h3>Specify the Package Prefix(es)</h3>
 
-<p>Register like any other service in <code>isis.properties</code>:</p>
+<p>In the <code>persistor_datanucleus.properties</code>, specify the package prefix(es) of your application, to provide a hint for finding the <code>@PersistenceCapable</code> classes.  </p>
 
 <pre>
-isis.services=<i>...other services...</i>,\
-              org.apache.isis.objectstore.jdo.service.RegisterEntities,\
-              ...
+isis.persistor.datanucleus.RegisterEntities.packagePrefix=com.mycompany.dom
 </pre>
 
-<h3>Specify the Package Prefix(es)</h3>
+<p>The value of this property can be a comma-separated list (if there is more than one package or Maven module that holds persistable entities).</p>
 
-<p>In the <code>persistor_datanucleus.properties</code>, specify the package prefix(es) of your application, to provide a hint for finding the <code>@PersistenceCapable</code> classes.  </p>
+<h3>Register the Service (1.3.x only)</h3>
+
+<blockquote>
+  <p>In 1.4.0-SNAPSHOT this step is no longer required.</p>
+</blockquote>
+
+<p>(If using 1.3.x), register like any other service in <code>isis.properties</code>:</p>
 
 <pre>
-isis.persistor.datanucleus.RegisterEntities.packagePrefix=com.mycompany.dom
+isis.services=<i>...other services...</i>,\
+              org.apache.isis.objectstore.jdo.service.RegisterEntities,\
+              ...
 </pre>
 
-<p>The value of this property can be a comma-separated list, if you wish.</p>
-
 
 
       </div>