BurningFlipside / CommonCode

Email/class.Email.php

Doc Comments +3 added lines, -3 removed lines

@@ -72,7 +72,7 @@ 
     /**
      * Who is this email going to
      *
-     * @return array The recipients of the email
+     * @return string The recipients of the email
      */
     public function getToAddresses()
     {
@@ -82,7 +82,7 @@ 
     /**
      * Who is this email going to (CC)
      *
-     * @return array The recipients of the email
+     * @return string The recipients of the email
      */
     public function getCCAddresses()
     {
@@ -92,7 +92,7 @@ 
     /**
      * Who is this email going to (BCC)
      *
-     * @return array The recipients of the email
+     * @return string The recipients of the email
      */
     public function getBCCAddresses()
     {

Auth/class.PendingUser.php

Doc Comments +1 added lines, -1 removed lines

@@ -90,7 +90,7 @@
      * We need the ability to obtain the user's unhashed plain text password to allow for it to be sent 
      * to the correct backend which will hash it
      *
-     * @return boolean|string The current password
+     * @return boolean The current password
      */
     public function getPassword()
     {

Auth/class.SQLAuthenticator.php

Doc Comments +7 added lines, -1 removed lines

@@ -140,7 +140,7 @@ 
     /**
      * Get the data table for Pending Users
      *
-     * @return boolean|\Data\DataTable The Pending User Data Table
+     * @return boolean The Pending User Data Table
      */
     private function getPendingUserDataTable()
     {
@@ -213,6 +213,9 @@ 
         return new SQLUser($users[0], $this);
     }
 
+    /**
+     * @param string $dataTableName
+     */
     private function getDataByFilter($dataTableName, $filter, $select, $top, $skip, $orderby)
     {
         $dataTable = $this->getDataTable($dataTableName);
@@ -278,6 +281,9 @@ 
         return $dataTable->count();
     }
 
+    /**
+     * @param \Data\Filter $filter
+     */
     private function searchPendingUsers($filter, $select, $top, $skip, $orderby)
     {
         $userDataTable = $this->getPendingUserDataTable();

Data/class.SQLDataSet.php

Doc Comments +12 added lines

@@ -113,6 +113,9 @@ 
         throw new \Exception('No such table '.$name);
     }
 
+    /**
+     * @param string $tablename
+     */
     function read($tablename, $where = false, $select = '*', $count = false, $skip = false, $sort = false)
     {
         if($select === false)
@@ -158,6 +161,9 @@ 
         return $ret;
     }
 
+    /**
+     * @param string $tablename
+     */
     function update($tablename, $where, $data)
     {
         $set = array();
@@ -180,6 +186,9 @@ 
         return true;
     }
 
+    /**
+     * @param string $tablename
+     */
     function create($tablename, $data)
     {
         $set = array();
@@ -203,6 +212,9 @@ 
         return true;
     }
 
+    /**
+     * @param string $tablename
+     */
     function delete($tablename, $where)
     {
         $sql = "DELETE FROM $tablename WHERE $where";

LDAP/class.LDAPServer.php

Doc Comments +1 added lines, -1 removed lines

@@ -210,7 +210,7 @@
     /**
      * Get the LDAP filter represented by the passed object
      *
-     * @param boolean|string|\Data\Filter $filter The fiter to use
+     * @param boolean $filter The fiter to use
      *
      * @return string The filter in LDAP format
      */

Auth/class.LDAPAuthenticator.php

Doc Comments +1 added lines, -1 removed lines

@@ -325,7 +325,7 @@
 
     
     /**
-     * @param boolean|\Data\Filter $filter The filter to user when reading users
+     * @param \Data\Filter $filter The filter to user when reading users
      * @param boolean|array   $select The fields to return
      * @param boolean|integer $top The number of records to return
      * @param boolean|integer $skip The number of records to skip

Auth/class.LDAPCachableObject.php

Doc Comments +1 added lines, -1 removed lines

@@ -43,7 +43,7 @@
      *
      * @param string $fieldName The name of the field to retrieve
      *
-     * @return mixed string the value of the field
+     * @return string string the value of the field
      */
     protected function getFieldSingleValue($fieldName)
     {

class.AuthProvider.php

Doc Comments +4 added lines, -4 removed lines

@@ -253,10 +253,10 @@
      * Get an array of Auth\PendingUser from a filtered set
      *
      * @param Data\Filter|boolean $filter The filter conditions or false to retreive all
-     * @param array|boolean $select The user fields to obtain or false to obtain all
-     * @param integer|boolean $top The number of users to obtain or false to obtain all
-     * @param integer|boolean $skip The number of users to skip or false to skip none
-     * @param array|boolean $orderby The field to sort by and the method to sort or false to not sort
+     * @param boolean $select The user fields to obtain or false to obtain all
+     * @param boolean $top The number of users to obtain or false to obtain all
+     * @param boolean $skip The number of users to skip or false to skip none
+     * @param boolean $orderby The field to sort by and the method to sort or false to not sort
      * @param string|boolean $methodName The AuthMethod if information is desired only from a particular Auth\Authenticator
      *
      * @return array|boolean An array of Auth\PendingUser objects or false if no pending users were found

Auth/class.User.php

Doc Comments +19 added lines, -19 removed lines

@@ -50,7 +50,7 @@ 
     /**
      * The email address for the user
      *
-     * @return boolean|string The user's email address
+     * @return boolean The user's email address
      */
     public function getEmail()
     {
@@ -60,7 +60,7 @@ 
     /**
      * The user ID for the user
      *
-     * @return boolean|string The user's ID or username
+     * @return boolean The user's ID or username
      */
     public function getUid()
     {
@@ -70,7 +70,7 @@ 
     /**
      * The photo for the user
      *
-     * @return boolean|string The user's photo as a binary string
+     * @return boolean The user's photo as a binary string
      */ 
     public function getPhoto()
     {
@@ -80,7 +80,7 @@ 
     /**
      * The phone number for the user
      *
-     * @return boolean|string The user's phone number
+     * @return boolean The user's phone number
      */
     public function getPhoneNumber()
     {
@@ -90,7 +90,7 @@ 
     /**
      * The organziation for the user
      *
-     * @return boolean|string The user's organization
+     * @return boolean The user's organization
      */
     public function getOrganization()
     {
@@ -100,7 +100,7 @@ 
     /**
      * The list of titles for the user
      *
-     * @return boolean|array The user's title(s) in short format
+     * @return boolean The user's title(s) in short format
      */
     public function getTitles()
     {
@@ -110,7 +110,7 @@ 
     /**
      * The list of titles for the user
      *
-     * @return boolean|array The user's title(s) in user friendly strings
+     * @return boolean The user's title(s) in user friendly strings
      *
      * @SuppressWarnings("StaticAccess")
      */
@@ -148,7 +148,7 @@ 
     /**
      * The state the user's mailing address is in
      *
-     * @return boolean|string The user's state from their mailing address
+     * @return boolean The user's state from their mailing address
      */
     public function getState()
     {
@@ -158,7 +158,7 @@ 
     /**
      * The city the user's mailing address is in
      *
-     * @return boolean|string The user's city from their mailing address
+     * @return boolean The user's city from their mailing address
      */
     public function getCity()
     {
@@ -168,7 +168,7 @@ 
     /**
      * The last name for the user
      *
-     * @return boolean|string The user's last name
+     * @return boolean The user's last name
      */
     public function getLastName()
     {
@@ -178,7 +178,7 @@ 
     /**
      * The nick name for the user
      *
-     * @return boolean|string The user's nick name
+     * @return boolean The user's nick name
      */
     public function getNickName()
     {
@@ -188,7 +188,7 @@ 
     /**
      * The street address for the user
      *
-     * @return boolean|string The user's street address
+     * @return boolean The user's street address
      */
     public function getAddress()
     {
@@ -198,7 +198,7 @@ 
     /**
      * The postal (zip) code for the user's mailing address
      *
-     * @return boolean|string The user's postal code
+     * @return boolean The user's postal code
      */
     public function getPostalCode()
     {
@@ -208,7 +208,7 @@ 
     /**
      * The country the user's mailing address is in
      *
-     * @return boolean|string The user's country from their mailing address
+     * @return boolean The user's country from their mailing address
      */
     public function getCountry()
     {
@@ -220,7 +220,7 @@ 
      *
      * This is the same as Areas in Flipside speak. 
      *
-     * @return boolean|array The user's orgnaiational units
+     * @return boolean The user's orgnaiational units
      */
     public function getOrganizationUnits()
     {
@@ -230,7 +230,7 @@ 
     /**
      * The supplemental login types that the user can use to login
      *
-     * @return boolean|array The user's login providers
+     * @return boolean The user's login providers
      */
     public function getLoginProviders()
     {
@@ -240,7 +240,7 @@ 
     /**
      * The groups the user is a part of
      *
-     * @return boolean|array The user's Auth\Group structures
+     * @return boolean The user's Auth\Group structures
      */
     public function getGroups()
     {
@@ -716,7 +716,7 @@ 
      *
      * @param stdClass $data The user's new data
      *
-     * @return boolean true if the user's data was changed, false otherwise
+     * @return boolean|null true if the user's data was changed, false otherwise
      */
     public function editUser($data)
     {
@@ -743,7 +743,7 @@ 
     /**
      * Obtain the user's password reset hash
      *
-     * @return string|false A hash if available, false otherwise
+     * @return boolean A hash if available, false otherwise
      */
     public function getPasswordResetHash()
     {