chamilo / chamilo-lms

main/inc/lib/pear/OLE/PPS/Root.php

Doc Comments +3 added lines, -3 removed lines

@@ -65,7 +65,7 @@ 
     *
     * @access public
     * @param string $dir The dir to be used as temp dir
-    * @return true if given dir is valid, false otherwise
+    * @return boolean if given dir is valid, false otherwise
     */
     function setTempDir($dir)
     {
@@ -142,7 +142,7 @@ 
     *
     * @access private
     * @param array $raList Reference to an array of PPS's
-    * @return array The array of numbers
+    * @return double[] The array of numbers
     */
     function _calcSize(&$raList)
     {
@@ -180,7 +180,7 @@ 
     * @access private
     * @param integer $i2 The argument
     * @see save()
-    * @return integer
+    * @return double
     */
     function _adjust2($i2)
     {

main/inc/lib/pear/Pager/Common.php

Doc Comments +8 added lines, -8 removed lines

@@ -592,7 +592,7 @@ 
      *
      * @param integer $index Offset to get pageID for
      *
-     * @return integer PageID for given offset
+     * @return PEAR_Error PageID for given offset
      * @access public
      */
     function getPageIdByOffset($index)
@@ -612,7 +612,7 @@ 
      *
      * @param integer $pageID PageID to get offsets for
      *
-     * @return array  First and last offsets
+     * @return integer[]  First and last offsets
      * @access public
      */
     function getOffsetByPageId($pageID = null)
@@ -639,7 +639,7 @@ 
      *
      * @param integer $pageID PageID to get offsets for
      *
-     * @return array First and last offsets
+     * @return PEAR_Error First and last offsets
      * @access public
      */
     function getPageRangeByPageId($pageID = null)
@@ -668,7 +668,7 @@ 
      * @param string  $next_html HTML to put inside the next link
      *                           [deprecated: use the factory instead]
      *
-     * @return array back/next/first/last and page links
+     * @return PEAR_Error back/next/first/last and page links
      * @access public
      */
     function getLinks($pageID=null, $next_html='')
@@ -698,7 +698,7 @@ 
      * Returns next page ID. If current page is last page
      * this function returns FALSE
      *
-     * @return mixed Next page ID or false
+     * @return integer Next page ID or false
      * @access public
      */
     function getNextPageID()
@@ -713,7 +713,7 @@ 
      * Returns previous page ID. If current page is first page
      * this function returns FALSE
      *
-     * @return mixed Previous page ID or false
+     * @return integer Previous page ID or false
      * @access public
      */
     function getPreviousPageID()
@@ -994,7 +994,7 @@ 
      *
      * @param string $string the pattern to check
      *
-     * @return boolean
+     * @return integer
      * @access private
      */
     function _isRegexp($string) {
@@ -1136,7 +1136,7 @@ 
      *
      * @param string $url URL to use in the link [deprecated: use the factory instead]
      *
-     * @return string Links
+     * @return PEAR_Error Links
      * @access private
      */
     function _getPageLinks($url='')

main/inc/lib/pear/Pager/HtmlWidgets.php

Doc Comments +2 added lines, -1 removed lines

@@ -55,7 +55,8 @@
     /**

      * Constructor

      *

-     * @param object &$pager Pager instance

+     * @param object &$pager Pager instance
+     * @param Pager_Common $pager

      */

     function Pager_HtmlWidgets(&$pager)
     {

main/inc/lib/pear/Pager/Jumping.php

Doc Comments +1 added lines, -1 removed lines

@@ -112,7 +112,7 @@
      *
      * @param integer $pageid PageID to get offsets for
      *
-     * @return array  First and last offsets
+     * @return integer[]  First and last offsets
      * @access public
      */
     function getPageRangeByPageId($pageid = null)

main/inc/lib/pear/Text/Diff/Engine/native.php

Doc Comments +5 added lines

@@ -147,6 +147,7 @@ 
      * the two files do not match, and likewise that the last lines do not
      * match.  The caller must trim matching lines from the beginning and end
      * of the portions it is going to specify.
+     * @param double $nchunks
      */
     function _diag ($xoff, $xlim, $yoff, $ylim, $nchunks)
     {
@@ -267,6 +268,10 @@ 
      *
      * Note that XLIM, YLIM are exclusive bounds.  All line numbers are
      * origin-0 and discarded lines are not counted.
+     * @param integer $xoff
+     * @param integer $xlim
+     * @param integer $yoff
+     * @param integer $ylim
      */
     function _compareseq ($xoff, $xlim, $yoff, $ylim)
     {

main/inc/lib/pear/Text/Diff/Renderer.php

Doc Comments +9 added lines

@@ -143,6 +143,12 @@ 
         return $output . $this->_endDiff();
     }
 
+    /**
+     * @param integer $xbeg
+     * @param integer $xlen
+     * @param integer $ybeg
+     * @param integer $ylen
+     */
     function _block($xbeg, $xlen, $ybeg, $ylen, &$edits)
     {
         $output = $this->_startBlock($this->_blockHeader($xbeg, $xlen, $ybeg, $ylen));
@@ -199,6 +205,9 @@ 
         return $xbeg . ($xlen ? ($ylen ? 'c' : 'd') : 'a') . $ybeg;
     }
 
+    /**
+     * @param string $header
+     */
     function _startBlock($header)
     {
         return $header . "\n";

main/inc/lib/pear/Text/Diff/Renderer/inline.php

Doc Comments +6 added lines

@@ -74,6 +74,9 @@ 
         return $header;
     }
 
+    /**
+     * @param string[] $lines
+     */
     function _lines($lines, $prefix = ' ', $encode = true)
     {
         if ($encode) {
@@ -141,6 +144,9 @@ 
         return str_replace($nl, "\n", $renderer->render($diff)) . "\n";
     }
 
+    /**
+     * @param string $string
+     */
     function _splitOnWords($string, $newlineEscape = "\n")
     {
         // Ignore \0; otherwise the while loop will never finish.

main/inc/lib/pear/Text/Password.php

Doc Comments +10 added lines

@@ -180,6 +180,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _xor($login, $key)
@@ -208,6 +209,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _rotx($login, $key)
@@ -241,6 +243,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _rotxpp($login, $key)
@@ -274,6 +277,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _rotxmm($login, $key)
@@ -306,6 +310,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _asciiRotx($login, $key)
@@ -340,6 +345,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _asciiRotxpp($login, $key)
@@ -374,6 +380,7 @@ 
      * @access private
      * @param  string  Login
      * @param  integer Key
+     * @param integer $key
      * @return string
      */
     function _asciiRotxmm($login, $key)
@@ -430,6 +437,7 @@ 
      *
      * @access private
      * @param  integer Length of the password
+     * @param integer $length
      * @return string  Returns the password
      */
     function _createPronounceable($length)
@@ -475,6 +483,8 @@ 
      * @param  string  Character which could be use in the
      *                 unpronounceable password ex : 'ABCDEFG'
      *                 or numeric, alphabetical or alphanumeric.
+     * @param integer $length
+     * @param string $chars
      * @return string  Returns the password
      */
     function _createUnpronounceable($length, $chars)

main/inc/lib/phpmailer/class.phpmailer.php

Doc Comments +15 added lines, -3 removed lines

@@ -891,6 +891,7 @@ 
   /**
    * Creates recipient headers.
    * @access public
+   * @param string $type
    * @return string
    */
   public function AddrAppend($type, $addr) {
@@ -1258,6 +1259,9 @@ 
   /**
    * Returns the start of a message boundary.
    * @access private
+   * @param string $charSet
+   * @param string $contentType
+   * @param string $encoding
    */
   private function GetBoundary($boundary, $charSet, $contentType, $encoding) {
     $result = '';
@@ -1311,6 +1315,7 @@ 
   /**
    *  Returns a formatted header line.
    * @access public
+   * @param string $name
    * @return string
    */
   public function HeaderLine($name, $value) {
@@ -1320,6 +1325,7 @@ 
   /**
    * Returns a formatted mail line.
    * @access public
+   * @param string $value
    * @return string
    */
   public function TextLine($value) {
@@ -1521,6 +1527,7 @@ 
   /**
    * Encode a header string to best (shortest) of Q, B, quoted or none.
    * @access public
+   * @param string $str
    * @return string
    */
   public function EncodeHeader($str, $position = 'text') {
@@ -1647,7 +1654,6 @@ 
   * Encode string to quoted-printable.
   * Only uses standard PHP, slow, but will always work
   * @access public
-  * @param string $string the text to encode
   * @param integer $line_max Number of chars allowed on a line before wrapping
   * @return string
   */
@@ -1917,6 +1923,7 @@ 
   /**
    * Adds the error message to the error container.
    * @access protected
+   * @param string $msg
    * @return void
    */
   protected function SetError($msg) {
@@ -1966,6 +1973,7 @@ 
   /**
    * Returns a message in the appropriate language.
    * @access private
+   * @param string $key
    * @return string
    */
   private function Lang($key) {
@@ -1992,6 +2000,7 @@ 
   /**
    * Changes every end of line from CR or LF to CRLF.
    * @access private
+   * @param string $str
    * @return string
    */
   private function FixEOL($str) {
@@ -2203,8 +2212,6 @@ 
    * Set the private key file and password to sign the message.
    *
    * @access public
-   * @param string $key_filename Parameter File Name
-   * @param string $key_pass Password for private key
    */
   public function DKIM_QP($txt) {
     $tmp="";
@@ -2318,6 +2325,11 @@ 
     return "X-PHPMAILER-DKIM: phpmailer.worxware.com\r\n".$dkimhdrs.$signed."\r\n";
   }
 
+  /**
+   * @param integer $isSent
+   * @param string $subject
+   * @param string $body
+   */
   protected function doCallback($isSent,$to,$cc,$bcc,$subject,$body) {
     if (!empty($this->action_function) && function_exists($this->action_function)) {
       $params = array($isSent,$to,$cc,$bcc,$subject,$body);