Index: modules/user.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/user.module,v
retrieving revision 1.501
diff -u -r1.501 user.module
--- modules/user.module 11 Aug 2005 13:52:44 -0000  1.501
+++ modules/user.module 17 Aug 2005 17:25:02 -0000
@@ -1542,7 +1542,20 @@
   return $output;
 }

-function user_roles($membersonly = 0, $permission = 0) {
+/**
+ * Retrieve the roles, and optionally the role permissions, for this site.
+ *
+ * @param $membersonly
+ *   (optional) Boolean TRUE to return all roles but the Anonymous user role.
+ *   FALSE returns all roles.
+ * @param $permission
+ *   (optional) The permission to filter roles through, i.e., 'access content'
+ *   returns only roles containing the 'access content' permission.
+ *
+ * @return
+ *   Array of role names keyed by role id.
+ */
+function user_roles($membersonly = FALSE, $permission = NULL) {
   $roles = array();

   if ($permission) {