--- docscvs\node.php	Sun Oct 09 13:29:33 2005
+++ docspatched\node.php	Sun Oct 09 16:07:48 2005
@@ -145,7 +145,8 @@ function hook_insert($node) {
  * Load node-type-specific information.
  *
  * This is a hook used by node modules. It is called to allow the module
- * a chance to load extra information that it stores about a node.
+ * a chance to load extra information that it stores about a node, or 
+ * possibly replace already loaded information - which can be dangerous
  *
  * @param $node
  *   The node being loaded. At call time, node.module has already loaded
@@ -154,7 +155,9 @@  *   the basic information about the nod
  * @return
  *   An object containing properties of the node being loaded. This will
  *   be merged with the passed-in $node to result in an object containing
- *   both sets of properties.
+ *   a set of properties resulting from adding the extra properties to
+ *   the passed-in ones, and overwriting the passed-in ones with the
+ *   extra properties if they have the same name as passed-in properties.
  *
  * For a detailed usage example, see node_example.module.
  */