Index: node.php
===================================================================
RCS file: /cvs/drupal-contrib/contributions/docs/developer/hooks/node.php,v
retrieving revision 1.32
diff -u -p -r1.32 node.php
--- node.php	24 Nov 2006 21:32:59 -0000	1.32
+++ node.php	17 Dec 2006 17:03:40 -0000
@@ -354,25 +354,27 @@ function hook_update($node) {
  * Verify a node editing form.
  *
  * This is a hook used by node modules. It is called to allow the module
- * to verify that the node is in a format valid to post to the site. It
- * can also be used to make changes to the node before submission, such
- * as node-type-specific formatting. Errors should be set with
- * form_set_error().
+ * to verify that the node is in a format valid to post to the site. 
+ * Errors should be set with form_set_error().
  *
- * @param &$node
+ * @param $node
  *   The node to be validated.
  *
  * To validate nodes of all types (not just nodes of the type(s) defined by
  * this module), use hook_nodeapi() instead.
  *
+ * Since Drupal 4.7, changes made to a node within hook_validate()
+ * will be ignored.  The preferred method change a node's content is to 
+ * use hook_submit() or hook_nodeapi($op='submit') instead.  If it is really
+ * necessary to change the node at the validate stage, you can use function
+ * form_set_value().
+ *
  * For a detailed usage example, see node_example.module.
  */
-function hook_validate(&$node) {
-  if ($node) {
-    if ($node->end && $node->start) {
-      if ($node->start > $node->end) {
-        form_set_error('time', t('An event may not end before it starts.'));
-      }
+function hook_validate($node) {
+  if (isset($node->end) && isset($node->start)) {
+    if ($node->start > $node->end) {
+      form_set_error('time', t('An event may not end before it starts.'));
     }
   }
 }