fixes #16

* all PHP code is documented
 * admin/scripts/*php is added to apidoc and gettext generation in Makefile

admin/users.php

@@ -34,7 +34,7 @@ include_once('common.inc.php');
  * Gets the names of the given users's groups from the group file.
  *
  * @param string $username user name
- * @return array of group names
+ * @return array array of group names
  * @access private
  */
 function _getGroupNames($username) {
@@ -57,7 +57,7 @@ function _getGroupNames($username) {
  * Gets XML encoded data for a user.
  * 
  * @param int $uid user id
- * @return XML string
+ * @return string XML string
  */
 function getUserData($uid) {
   if  (!(is_numeric($uid) && array_key_exists($uid, $GLOBALS['namemap']))) {
@@ -77,7 +77,7 @@ function getUserData($uid) {
  * Gets XML encoded data for a deleted user.
  *
  * @param int $uid user id
- * @return XML string
+ * @return string XML string
  */
 function getDeletedUserData($uid) {
   if  (!is_numeric($uid)) {
@@ -92,7 +92,8 @@ function getDeletedUserData($uid) {
  * @param array &$userdata reference to an user data array
  * @param boolean $forinsert if this is true the check skips field
  * that will be created during insert
- * @return an array with validation error messages or an empty array
+ * @return array an array with validation error messages or an empty
+ * array
  */
 function validateUserData(&$userdata, $forinsert) {
   $errormsgs = array();