Index: globals.php
===================================================================
RCS file: /cvs/drupal/contributions/docs/developer/globals.php,v
retrieving revision 1.9
diff -u -r1.9 globals.php
--- globals.php	10 Nov 2009 16:07:41 -0000	1.9
+++ globals.php	8 Feb 2010 08:45:15 -0000
@@ -56,7 +56,7 @@
 
 /**
  * Array of persistent variables stored in 'variable' table.
- * 
+ *
  * @see variable_get()
  * @see variable_set()
  * @see variable_del()
@@ -75,7 +75,42 @@
 global $update_free_access;
 
 /**
- * Representation of the current user. Stores preferences and other user information.
+ * An object representing the current user. Stores preferences and other user
+ * information.
+ *
+ * Example values for a logged in user:
+ *  - uid => 1
+ *  - name => 'admin'
+ *  - pass => '$P$Ct8ywx7wJr8xb4VFcjFNXDXqANOBOQ1'
+ *  - mail => 'admin@example.com"
+ *  - theme => ''
+ *  - signature => ''
+ *  - created=> '1265546989'
+ *  - access => '1265615478'
+ *  - login => '1265547063'
+ *  - status => '1'
+ *  - timezone => NULL
+ *  - language => ''
+ *  - picture => '0'
+ *  - init => 'admin@example.com'
+ *  - data => ''
+ *  - sid => '443dc478itdaugeqi3qi3nr9e6'
+ *  - ssid => NULL
+ *  - hostname => '127.0.0.1'
+ *  - timestamp => '1265615519'
+ *  - cache => '0'
+ *  - session => 'batches|a:1:{i:1;b:1;}'
+ *  - roles =>
+ *    - [2] => 'authenticated user'
+ *
+ * Example values for an anonymous visitor:
+ *  - uid => 0
+ *  - hostname => '127.0.0.1'
+ *  - roles =>
+ *    - [1] => 'anonymous user'
+ * - session => ''
+ * - cache => 0
+ *
  */
 global $user;