bug 3526 - adding Slice comment about recreating OA

1 files changed, 7 insertions, 5 deletions

diff --git a/slice/Ice/ObjectAdapter.ice b/slice/Ice/ObjectAdapter.ice
index 2be7351178e..264aa046784 100644
--- a/slice/Ice/ObjectAdapter.ice
+++ b/slice/Ice/ObjectAdapter.ice
@@ -105,7 +105,9 @@ local interface ObjectAdapter
      * otherwise. Attempts to use a deactivated object adapter raise
      * [ObjectAdapterDeactivatedException]; however, attempts to
      * [deactivate] an already deactivated object adapter are ignored
-     * and do nothing.
+     * and do nothing. Once deactivated, it is possible to destroy the
+     * adapter to clean up resources and then create and activate a
+     * new adapter with the same name.
      *
      * <p class="Note"> After [deactivate] returns, no new requests are
      * processed by the object adapter. However, requests that have
@@ -150,11 +152,11 @@ local interface ObjectAdapter
     /**
      *
      * Destroys the object adapter and cleans up all resources
-     * held by the object adapter. If object adapter has not yet
+     * held by the object adapter. If the object adapter has not yet
      * been deactivated, [destroy] implicitly initiates the
-     * deactivation and waits for it to finish. Once [destroy] has
-     * returned it is possible to recreate an object adapter with
-     * the same name. Subsequent calls to [destroy] are ignored.
+     * deactivation and waits for it to finish. Subsequent calls to
+     * [destroy] are ignored. Once [destroy] has returned, it is
+     * possible to create another object adapter with the same name.
      * 
      * @see deactivate
      * @see waitForDeactivate