svn commit: r16006 - trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java

Author: tfmorris
Date: 2008-11-10 11:54:18-0800
New Revision: 16006

Modified:
   trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java

Log:
Improve Javadoc with greater emphasis


Modified: trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java
Url: http://argouml.tigris.org/source/browse/argouml/trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java?view=diff&rev=16006&p1=trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java&p2=trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java&r1=16005&r2=16006
==============================================================================
--- trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java	(original)
+++ trunk/src/argouml-core-model/src/org/argouml/model/UmlFactory.java	2008-11-10 11:54:18-0800
@@ -164,14 +164,14 @@
     /**
      * Check whether a model element has been deleted.<p>
      *
-     * <em>NOTE:</em>Not thread-safe!
+     * <em>NOTE:</em>You probably don't want to use this.  It's not thread-safe!
      * Without external synchronization there's no guarantee that the
      * element won't be deleted by thread after this method returns, but
      * before the caller can do anything with it.<p>
      *
      * If the calling code isn't protected by a lock or some other type of
-     * synchronization, an alternative to using this call is to use a 
-     * try/catch block which catches InvalidElementExceptions.
+     * synchronization, a much, <em>MUCH</em> better alternative to using this
+     * call is to use a try/catch block which catches InvalidElementExceptions.
      *
      * @param o the object to be checked
      * @return true if removed