Fox wrong phpdoc return type name + redundant comments

Author: pH-7

QRCode.class.php

@@ -28,7 +28,8 @@ public function __construct()
      * The name of the person.
      *
      * @param string $sName
-     * @return object this
+     *
+     * @return self
      */
     public function name($sName)
     {
@@ -40,7 +41,8 @@ public function name($sName)
      * The full name of the person.
      *
      * @param string $sFullName
-     * @return object this
+     *
+     * @return self this
      */
     public function fullName($sFullName)
     {
@@ -49,22 +51,21 @@ public function fullName($sFullName)
     }
 
     /**
-     * Delivery address.
-     *
      * @param string $sAddress
-     * @return object this
+     *
+     * @return self
      */
     public function address($sAddress)
     {
         $this->_sData .= 'ADR:' . $sAddress . "\n";
+
         return $this;
     }
 
     /**
-     * Nickname.
-     *
      * @param string $sNickname
-     * @return object this
+     *
+     * @return self
      */
     public function nickName($sNickname)
     {
@@ -73,10 +74,9 @@ public function nickName($sNickname)
     }
 
     /**
-     * Email address.
-     *
      * @param string $sMail
-     * @return object this
+     *
+     * @return self
      */
     public function email($sMail)
     {
@@ -85,10 +85,9 @@ public function email($sMail)
     }
 
     /**
-     * Work Phone.
-     *
      * @param string $sVal
-     * @return object this
+     *
+     * @return self
      */
     public function workPhone($sVal)
     {
@@ -97,10 +96,9 @@ public function workPhone($sVal)
     }
 
     /**
-     * Home Phone.
-     *
      * @param string $sVal
-     * @return object this
+     *
+     * @return self
      */
     public function homePhone($sVal)
     {
@@ -109,10 +107,9 @@ public function homePhone($sVal)
     }
 
     /**
-     * URL address.
-     *
      * @param string $sUrl
-     * @return object this
+     *
+     * @return self
      */
     public function url($sUrl)
     {
@@ -122,11 +119,10 @@ public function url($sUrl)
     }
 
     /**
-     * SMS code.
-     *
      * @param string $sPhone
      * @param string $sText
-     * @return object this
+     *
+     * @return self
      */
     public function sms($sPhone, $sText)
     {
@@ -135,10 +131,9 @@ public function sms($sPhone, $sText)
     }
 
     /**
-     * Birthday.
-     *
      * @param string $sBirthday Date in the format YYYY-MM-DD or ISO 8601
-     * @return object this
+     *
+     * @return self
      */
     public function birthday($sBirthday)
     {
@@ -147,10 +142,9 @@ public function birthday($sBirthday)
     }
 
     /**
-     * Anniversary.
-     *
      * @param string $sBirthDate Date in the format YYYY-MM-DD or ISO 8601
-     * @return object this
+     *
+     * @return self
      */
     public function anniversary($sBirthDate)
     {
@@ -159,10 +153,9 @@ public function anniversary($sBirthDate)
     }
 
     /**
-     * Gender.
-     *
      * @param string $sSex F = Female. M = Male
-     * @return object this
+     *
+     * @return self
      */
     public function gender($sSex)
     {
@@ -173,8 +166,9 @@ public function gender($sSex)
     /**
      * A list of "tags" that can be used to describe the object represented by this vCard.
      *
-     * @param string $sCategory
-     * @return object this
+     * @param string $sCategories
+     *
+     * @return self
      */
     public function categories($sCategories)
     {
@@ -186,39 +180,45 @@ public function categories($sCategories)
      * The instant messenger (Instant Messaging and Presence Protocol).
      *
      * @param string $sVal
-     * @return object this
+     *
+     * @return self
      */
     public function impp($sVal)
     {
-       $this->_sData .= 'IMPP:' . $sVal . "\n";
-       return $this;
+        $this->_sData .= 'IMPP:' . $sVal . "\n";
+        return $this;
     }
 
     /**
      * Photo (avatar).
      *
      * @param string $sImgUrl URL of the image.
-     * @return object this
+     *
+     * @return self
+     *
      * @throws InvalidArgumentException If the image format is invalid.
      */
     public function photo($sImgUrl)
     {
         $bIsImgExt = strtolower(substr(strrchr($sImgUrl, '.'), 1)); // Get the file extension.
 
-        if ($bIsImgExt == 'jpeg' || $bIsImgExt == 'jpg' || $bIsImgExt == 'png' || $bIsImgExt == 'gif')
+        if ($bIsImgExt == 'jpeg' || $bIsImgExt == 'jpg' || $bIsImgExt == 'png' || $bIsImgExt == 'gif') {
             $sExt = strtoupper($bIsImgExt);
-        else
+        } else {
             throw new InvalidArgumentException('Invalid format Image!');
+        }
 
         $this->_sData .= 'PHOTO;VALUE=URL;TYPE=' . $sExt . ':' . $sImgUrl . "\n";
+
         return $this;
     }
 
     /**
      * The role, occupation, or business category of the vCard object within an organization.
      *
      * @param string $sRole e.g., Executive
-     * @return object this
+     *
+     * @return self
      */
     public function role($sRole)
     {
@@ -234,7 +234,8 @@ public function role($sRole)
      * attribute and the X.520 Organization Unit attribute.
      *
      * @param string $sOrg e.g., Google;GMail Team;Spam Detection Squad
-     * @return object this
+     *
+     * @return self
      */
     public function organization($sOrg)
     {
@@ -246,7 +247,8 @@ public function organization($sOrg)
      * The supplemental information or a comment that is associated with the vCard.
      *
      * @param string $sText
-     * @return object this
+     *
+     * @return self
      */
     public function note($sText)
     {
@@ -255,11 +257,10 @@ public function note($sText)
     }
 
     /**
-     * Bookmark.
-     *
      * @param string $sTitle
      * @param string $sUrl
-     * @return object this
+     *
+     * @return self
      */
     public function bookmark($sTitle, $sUrl)
     {
@@ -273,7 +274,8 @@ public function bookmark($sTitle, $sUrl)
      * @param string $sLat Latitude
      * @param string $sLon Longitude
      * @param integer $iHeight Height
-     * @return object this
+     *
+     * @return self
      */
     public function geo($sLat, $sLon, $iHeight)
     {
@@ -285,7 +287,8 @@ public function geo($sLat, $sLon, $iHeight)
      * The language that the person speaks.
      *
      * @param string $sLang e.g., en-US
-     * @return object this
+     *
+     * @return self
      */
     public function lang($sLang)
     {
@@ -294,12 +297,11 @@ public function lang($sLang)
     }
 
     /**
-     * Wifi.
-     *
      * @param string $sType
      * @param string $sSsid
      * @param string $sPwd
-     * @return object this
+     *
+     * @return self
      */
     public function wifi($sType, $sSsid, $sPwd)
     {
@@ -310,7 +312,7 @@ public function wifi($sType, $sSsid, $sPwd)
     /**
      * Generate the QR code.
      *
-     * @return object this
+     * @return self
      */
     public function finish()
     {