The Submit handlers use $form_state rather than returning urls section of the Drupal 5.x to 6.x FormAPI changes page has a superfluous line in the sample Drupal 6, $form_state['nid'] = $node->nid;, which (judging by core code usage) isn't needed, and thus only causes confusion for porters.
Comments
Comment #1
heather commentedChanged the component to reflect the new component categorization. See http://drupal.org/node/301443
Comment #2
alan d. commentedThe superfluous example is not a great one, but this does show how you would be able to pass extra information in chained submit handlers, or as the paragraph above states
Maybe a more relevant example about this would be useful, or a comment about why this is set.
Personally, the only time I have wanted to use this is to allow a submit handler to redirect based on the results of the earlier submit handlers. I'm not sure why core uses nid and not the entire node object, see node_form_submit, but that's another topic.
Comment #3
MGParisi commentedAdded PHP change (minor additional comment)
Comment #5
mvk595 commented