[documentation] [Documentation task] Document user_load must be called to get fully realized user object

[Chris Johnson]

Issue status update for 
http://drupal.org/node/57287
Post a follow up: 
http://drupal.org/project/comments/add/57287

 Project:      Documentation
 Version:      <none>
 Component:    Documentation in CVS
 Category:     tasks
 Priority:     normal
 Assigned to:  Chris Johnson
 Reported by:  Chris Johnson
 Updated by:   Chris Johnson
 Status:       active

The global $user object that exists on each page is *not* a complete
user object, contrary to what one might think.  The only time the user
object is complete is after user_load() is called, because user_load()
fires (calls) all of the hook_user() hooks, allowing modules to add
whatever data they wish to the user object.  Without user_load() being
called, none of the module-added data for the user object will exist.


This task is to add documentation about this inconsistent and
potentially misleading situation to the contrib/docs/core.php
documentation.




Chris Johnson