Index: src/java/javax/jdo/PersistenceManager.java =================================================================== --- src/java/javax/jdo/PersistenceManager.java (revision 378143) +++ src/java/javax/jdo/PersistenceManager.java (working copy) @@ -570,7 +570,59 @@ * @param pcs the instances to make transient. */ void makeTransientAll (Collection pcs); + + /** Make an instance transient, removing them from management by this + * PersistenceManager. If the useFetchPlan parameter is + * false, this method behaves exactly as makeTransient(Object pc). + *

The affected instance(s) lose their JDO identity and are no longer + * associated with any PersistenceManager. The state + * of fields is unchanged. + *

If the useFetchPlan parameter is true, then the current FetchPlan + * is applied to the pc parameter and the entire graph of instances + * reachable via the FetchPlan is made transient. The state of fields + * in the affected instances is as specified by the FetchPlan. + * @param pc the root instance to make transient. + * @param useFetchPlan whether to use the current fetch plan to determine + * which fields to load and which instances to make transient + * @since 2.0 + */ + void makeTransient (Object pc, boolean useFetchPlan); + + /** Make instances transient, removing them from management + * by this PersistenceManager. If the useFetchPlan parameter + * is false, this method behaves exactly as makeTransientAll(Object[] pcs). + *

The affected instance(s) lose their JDO identity and are no longer + * associated with any PersistenceManager. The state + * of fields is unchanged. + *

If the useFetchPlan parameter is true, then the current FetchPlan + * is applied to the pcs parameters and the entire graph of instances + * reachable via the FetchPlan is made transient. The state of fields + * in the affected instances is as specified by the FetchPlan. + * @param pcs the root instances to make transient. + * @param useFetchPlan whether to use the current fetch plan to determine + * which fields to load and which instances to make transient + * @since 2.0 + */ + void makeTransientAll (Object[] pcs, boolean useFetchPlan); + /** Make instances transient, removing them from management + * by this PersistenceManager. If the useFetchPlan parameter + * is false, this method behaves exactly as + * makeTransientAll(Collection pcs). + *

The affected instance(s) lose their JDO identity and are no longer + * associated with any PersistenceManager. The state + * of fields is unchanged. + *

If the useFetchPlan parameter is true, then the current FetchPlan + * is applied to the pcs parameters and the entire graph of instances + * reachable via the FetchPlan is made transient. The state of fields + * in the affected instances is as specified by the FetchPlan. + * @param pcs the root instances to make transient. + * @param useFetchPlan whether to use the current fetch plan to determine + * which fields to load and which instances to make transient + * @since 2.0 + */ + void makeTransientAll (Collection pcs, boolean useFetchPlan); + /** Make an instance subject to transactional boundaries. * *

Transient instances normally do not observe transaction boundaries.