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