Index: api20/src/java/javax/jdo/PersistenceManager.java
===================================================================
--- api20/src/java/javax/jdo/PersistenceManager.java (revision 291465)
+++ api20/src/java/javax/jdo/PersistenceManager.java (working copy)
@@ -571,6 +571,16 @@
* @see #makeNontransactional(Object pc)
*/
void makeNontransactionalAll (Collection pcs);
+
+ /** Retrieve field values of an instance from the store. This tells
+ * the PersistenceManager that the application intends to use the
+ * instance, and its field values must be retrieved.
+ *
The PersistenceManager might use policy information about the
+ * class to retrieve associated instances.
+ * @param pc the instance
+ * @param FGOnly Whether to only retrieve the fields in the current fetch group
+ */
+ void retrieve (Object pc, boolean FGOnly);
/** Retrieve field values of an instance from the store. This tells
* the PersistenceManager that the application intends to use the
@@ -593,15 +603,15 @@
/** Retrieve field values of instances from the store. This tells
* the PersistenceManager that the application intends to use the
* instances, and their field values should be retrieved. The fields
- * in the default fetch group must be retrieved, and the implementation
- * might retrieve more fields than the default fetch group.
+ * in the current fetch group must be retrieved, and the implementation
+ * might retrieve more fields than the current fetch group.
*
The PersistenceManager might use policy information about the
* class to retrieve associated instances.
* @param pcs the instances
- * @param DFGOnly whether to retrieve only the default fetch group fields
+ * @param FGOnly whether to retrieve only the fields in the current fetch group
* @since 1.0.1
*/
- void retrieveAll (Collection pcs, boolean DFGOnly);
+ void retrieveAll (Collection pcs, boolean FGOnly);
/** Retrieve field values of instances from the store. This tells
* the PersistenceManager that the application intends to use the
@@ -615,15 +625,15 @@
/** Retrieve field values of instances from the store. This tells
* the PersistenceManager that the application intends to use the
* instances, and their field values should be retrieved. The fields
- * in the default fetch group must be retrieved, and the implementation
- * might retrieve more fields than the default fetch group.
+ * in the current fetch group must be retrieved, and the implementation
+ * might retrieve more fields than the current fetch group.
*
The PersistenceManager might use policy information about the
* class to retrieve associated instances.
* @param pcs the instances
- * @param DFGOnly whether to retrieve only the default fetch group fields
+ * @param FGOnly whether to retrieve only the fields in the current fetch group
* @since 1.0.1
*/
- void retrieveAll (Object[] pcs, boolean DFGOnly);
+ void retrieveAll (Object[] pcs, boolean FGOnly);
/** The application can manage the PersistenceManager instances
* more easily by having an application object associated with each