docs: public synchronized void clear(Transaction transaction)
                      throws ObjectManagerException
      {
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.entry(this, cclass
                          , "clear"
                            + "transaction=" + transaction + "(Transaction)"
                              );
  
          // Move through the map deleting each entry as we go.
          Entry entry = firstEntry(transaction);
          while (entry != null) {
              entry.remove(transaction);
              entry = successor(entry
                                , transaction
                              );
          } // while (entry != null).
          if (Tracing.isAnyTracingEnabled() && trace.isEntryEnabled())
              trace.exit(this, cclass
                         , "clear"
                              );
      }