docs: public final Token removeNamedObject(String name
                                           , Transaction transaction)
                      throws ObjectManagerException {
          final String methodName = "removeNamedObject";
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.entry(this, cclass
                          , methodName
                          , new Object[] { name, transaction }
                              );
  
          Token tokenOut = null; // For return.
  
          // See if there is a definitive namedObjdects tree. 
          if (objectManagerState.namedObjects == null) {
              if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
                  trace.exit(this, cclass
                             , methodName
                             , "via NoRestartablebjectStoresAvailableException"
                                  );
              throw new NoRestartableObjectStoresAvailableException(this);
          } // if (objectManagerState.namedObjects == null).
  
          // Loop over all of the ObjectStores.
          java.util.Iterator objectStoreIterator = objectManagerState.objectStores.values().iterator();
          while (objectStoreIterator.hasNext()) {
              ObjectStore objectStore = (ObjectStore) objectStoreIterator.next();
  
              // Don't bother with ObjectStores that can't be used for recovery.
              if (objectStore.getContainsRestartData()) {
  
                  // Locate any existing copy.
                  Token namedObjectsToken = new Token(objectStore,
                                                      ObjectStore.namedObjectTreeIdentifier.longValue());
                  // Swap for the definitive Token, if there is one.
                  namedObjectsToken = objectStore.like(namedObjectsToken);
  
                  TreeMap namedObjectsTree = (TreeMap) namedObjectsToken.getManagedObject();
                  tokenOut = (Token) namedObjectsTree.remove(name, transaction);
  
              } // if (objectStore.getContainsRestartData()).
          } // While objectStoreIterator.hasNext().
  
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.exit(this, cclass
                         , methodName
                         , new Object[] { tokenOut });
          return tokenOut;
      }