r9715 - apps/reference/trunk/coreEnvironment

Author: zumbrunn
Date: 2009-05-06 21:54:38 +0200 (Wed, 06 May 2009)
New Revision: 9715

Modified:
   apps/reference/trunk/coreEnvironment/HopObject.js
Log:
attempting to improve the wording of the docs for the hobj.get method

Details at http://dev.helma.org/trac/helma/changeset/9715

Modified: apps/reference/trunk/coreEnvironment/HopObject.js
===================================================================
--- apps/reference/trunk/coreEnvironment/HopObject.js	2009-05-06 15:25:14 UTC (rev 9714)
+++ apps/reference/trunk/coreEnvironment/HopObject.js	2009-05-06 19:54:38 UTC (rev 9715)
@@ -211,18 +211,18 @@
  * mountpoint, object, or collection, this function returns 
  * the corresponding HopObject.
  * <br /><br />
- * Otherwise, if the argument is a string, this function's 
+ * If the string argument produces no such match, the
  * behavior depends on whether this HopObject's _children have 
  * an accessname defined in the prototype's type.properties. 
  * <br /><br />
- * If an accessname is defined, this function returns the 
- * subnode with the corresponding name.
- * <br /><br />
- * If an accessname is not defined, a string argument will 
+ * If an accessname is defined, this function first attempts 
+ * to return the subnode with the corresponding name. 
+ * Otherwise, or if that attempt fails, a string argument will 
  * result in a null return unless the string argument is 
  * numeric, in which case this function will return the child 
- * with an _id matching the numeric value of the argument. This 
- * behavior is better achieved with HopObject method getById().
+ * with an _id matching the numeric value of the argument. 
+ * However, retrieving a HopObject based on its _id value is 
+ * better achieved using the getById() HopObject method.
  * <br /><br />
  * Example:
  * <pre>root.get(0);