mambax7 / XoopsCore25

htdocs/xoops_lib/modules/protector/library/HTMLPurifier/AttrDef/HTML/Pixels.php

Doc Comments +1 added lines, -1 removed lines

@@ -24,7 +24,7 @@
      * @param string $string
      * @param HTMLPurifier_Config $config
      * @param HTMLPurifier_Context $context
-     * @return bool|string
+     * @return string|false
      */
     public function validate($string, $config, $context)
     {

htdocs/class/cache/xoopscache.php

Doc Comments +7 added lines, -7 removed lines

@@ -79,7 +79,7 @@ 
      * Tries to find and include a file for a cache engine and returns object instance
      *
      * @param  $name Name of the engine
-     * @return mixed $engine object or null
+     * @return boolean $engine object or null
      * @access private
      */
     private function loadEngine($name)
@@ -206,7 +206,7 @@ 
      *
      * @param  string $key       Identifier for the data
      * @param  mixed  $value     Data to be cached - anything except a resource
-     * @param  mixed  $duration  Optional - string configuration name OR how long to cache the data, either in seconds or a
+     * @param  string  $duration  Optional - string configuration name OR how long to cache the data, either in seconds or a
      *                           string that can be parsed by the strtotime() function OR array('config' => 'default', 'duration' => '3600')
      * @return boolean True if the data was successfully cached, false on failure
      * @access public
@@ -384,7 +384,7 @@ 
      * generates a safe key
      *
      * @param  string $key the key passed over
-     * @return mixed  string $key or false
+     * @return false|string  string $key or false
      * @access private
      */
     public function key($key)
@@ -449,7 +449,7 @@ 
      * @param  string $key      Identifier for the data
      * @param  mixed  $value    Data to be cached
      * @param  mixed  $duration How long to cache the data, in seconds
-     * @return boolean True if the data was successfully cached, false on failure
+     * @return boolean|null True if the data was successfully cached, false on failure
      * @access public
      */
     public function write($key, $value, $duration = null)
@@ -473,7 +473,7 @@ 
      * Delete a key from the cache
      *
      * @param  string $key Identifier for the data
-     * @return boolean True if the value was successfully deleted, false if it didn't exist or couldn't be removed
+     * @return boolean|null True if the value was successfully deleted, false if it didn't exist or couldn't be removed
      * @access public
      */
     public function delete($key)
@@ -484,7 +484,7 @@ 
      * Delete all keys from the cache
      *
      * @param  boolean $check if true will check expiration, otherwise delete all
-     * @return boolean True if the cache was successfully cleared, false otherwise
+     * @return boolean|null True if the cache was successfully cleared, false otherwise
      * @access public
      */
     public function clear($check)
@@ -494,7 +494,7 @@ 
     /**
      * Cache Engine settings
      *
-     * @return array settings
+     * @return integer settings
      * @access public
      */
     public function settings()

htdocs/class/libraries/vendor/symfony/polyfill-mbstring/bootstrap.php

Doc Comments +34 added lines

@@ -20,28 +20,62 @@
     function mb_decode_mimeheader($s) { return p\Mbstring::mb_decode_mimeheader($s); }
     function mb_encode_mimeheader($s, $charset = null, $transferEnc = null, $lf = null, $indent = null) { return p\Mbstring::mb_encode_mimeheader($s, $charset, $transferEnc, $lf, $indent); }
     function mb_convert_case($s, $mode, $enc = null) { return p\Mbstring::mb_convert_case($s, $mode, $enc); }
+
+    /**
+     * @param string|boolean $enc
+     */
     function mb_internal_encoding($enc = null) { return p\Mbstring::mb_internal_encoding($enc); }
     function mb_language($lang = null) { return p\Mbstring::mb_language($lang); }
     function mb_list_encodings() { return p\Mbstring::mb_list_encodings(); }
     function mb_encoding_aliases($encoding) { return p\Mbstring::mb_encoding_aliases($encoding); }
+
+    /**
+     * @param string $var
+     * @param string $encoding
+     */
     function mb_check_encoding($var = null, $encoding = null) { return p\Mbstring::mb_check_encoding($var, $encoding); }
     function mb_detect_encoding($str, $encodingList = null, $strict = false) { return p\Mbstring::mb_detect_encoding($str, $encodingList, $strict); }
     function mb_detect_order($encodingList = null) { return p\Mbstring::mb_detect_order($encodingList); }
     function mb_parse_str($s, &$result = array()) { parse_str($s, $result); }
     function mb_strlen($s, $enc = null) { return p\Mbstring::mb_strlen($s, $enc); }
+
+    /**
+     * @param string $s
+     * @param string $needle
+     * @param string $enc
+     */
     function mb_strpos($s, $needle, $offset = 0, $enc = null) { return p\Mbstring::mb_strpos($s, $needle, $offset, $enc); }
+
+    /**
+     * @param string $s
+     * @param string $enc
+     */
     function mb_strtolower($s, $enc = null) { return p\Mbstring::mb_strtolower($s, $enc); }
     function mb_strtoupper($s, $enc = null) { return p\Mbstring::mb_strtoupper($s, $enc); }
     function mb_substitute_character($char = null) { return p\Mbstring::mb_substitute_character($char); }
     function mb_substr($s, $start, $length = 2147483647, $enc = null) { return p\Mbstring::mb_substr($s, $start, $length, $enc); }
+
+    /**
+     * @param string $enc
+     */
     function mb_stripos($s, $needle, $offset = 0, $enc = null) { return p\Mbstring::mb_stripos($s, $needle, $offset, $enc); }
     function mb_stristr($s, $needle, $part = false, $enc = null) { return p\Mbstring::mb_stristr($s, $needle, $part, $enc); }
     function mb_strrchr($s, $needle, $part = false, $enc = null) { return p\Mbstring::mb_strrchr($s, $needle, $part, $enc); }
     function mb_strrichr($s, $needle, $part = false, $enc = null) { return p\Mbstring::mb_strrichr($s, $needle, $part, $enc); }
     function mb_strripos($s, $needle, $offset = 0, $enc = null) { return p\Mbstring::mb_strripos($s, $needle, $offset, $enc); }
+
+    /**
+     * @param string $s
+     * @param string $needle
+     * @param string $enc
+     */
     function mb_strrpos($s, $needle, $offset = 0, $enc = null) { return p\Mbstring::mb_strrpos($s, $needle, $offset, $enc); }
     function mb_strstr($s, $needle, $part = false, $enc = null) { return p\Mbstring::mb_strstr($s, $needle, $part, $enc); }
     function mb_get_info($type = 'all') { return p\Mbstring::mb_get_info($type); }
+
+    /**
+     * @param string $enc
+     */
     function mb_http_output($enc = null) { return p\Mbstring::mb_http_output($enc); }
     function mb_strwidth($s, $enc = null) { return p\Mbstring::mb_strwidth($s, $enc); }
     function mb_substr_count($haystack, $needle, $enc = null) { return p\Mbstring::mb_substr_count($haystack, $needle, $enc); }

htdocs/class/libraries/vendor/symfony/polyfill-mbstring/Mbstring.php

Doc Comments +9 added lines

@@ -270,6 +270,9 @@ 
         return self::mb_detect_encoding($var, array($encoding)) || false !== @iconv($encoding, $encoding, $var);
     }
 
+    /**
+     * @return string
+     */
     public static function mb_detect_encoding($str, $encodingList = null, $strict = false)
     {
         if (null === $encodingList) {
@@ -574,6 +577,9 @@ 
         return $code;
     }
 
+    /**
+     * @param boolean $part
+     */
     private static function getSubpart($pos, $part, $haystack, $encoding)
     {
         if (false === $pos) {
@@ -621,6 +627,9 @@ 
         return self::mb_convert_case($s[0], MB_CASE_UPPER, 'UTF-8');
     }
 
+    /**
+     * @param string $file
+     */
     private static function getData($file)
     {
         if (file_exists($file = __DIR__.'/Resources/unidata/'.$file.'.php')) {

htdocs/class/module.textsanitizer.php

Doc Comments +31 added lines, -31 removed lines

@@ -222,7 +222,7 @@ 
     /**
      * Access the only instance of this class
      *
-     * @return object
+     * @return MyTextSanitizer
      * @static
      * @staticvar object
      */
@@ -395,7 +395,7 @@ 
      * Replace XoopsCodes with their equivalent HTML formatting
      *
      * @param  string   $text
-     * @param  bool|int $allowimage Allow images in the text?
+     * @param  integer $allowimage Allow images in the text?
      *                              On FALSE, uses links to images.
      * @return string
      */
@@ -481,7 +481,7 @@ 
      * A quick solution for filtering XSS scripts
      *
      * @TODO : To be improved
-     * @param $text
+     * @param string $text
      * @return mixed
      */
     public function filterXss($text)
@@ -577,11 +577,11 @@ 
      * Filters textarea form data in DB for display
      *
      * @param  string   $text
-     * @param  bool|int $html   allow html?
-     * @param  bool|int $smiley allow smileys?
-     * @param  bool|int $xcode  allow xoopscode?
-     * @param  bool|int $image  allow inline images?
-     * @param  bool|int $br     convert linebreaks?
+     * @param  integer $html   allow html?
+     * @param  integer $smiley allow smileys?
+     * @param  integer $xcode  allow xoopscode?
+     * @param  integer $image  allow inline images?
+     * @param  integer $br     convert linebreaks?
      * @return string
      */
     public function &displayTarea($text, $html = 0, $smiley = 1, $xcode = 1, $image = 1, $br = 1)
@@ -625,11 +625,11 @@ 
      * Filters textarea form data submitted for preview
      *
      * @param  string   $text
-     * @param  bool|int $html   allow html?
-     * @param  bool|int $smiley allow smileys?
-     * @param  bool|int $xcode  allow xoopscode?
-     * @param  bool|int $image  allow inline images?
-     * @param  bool|int $br     convert linebreaks?
+     * @param  integer $html   allow html?
+     * @param  integer $smiley allow smileys?
+     * @param  integer $xcode  allow xoopscode?
+     * @param  integer $image  allow inline images?
+     * @param  integer $br     convert linebreaks?
      * @return string
      */
     public function &previewTarea($text, $html = 0, $smiley = 1, $xcode = 1, $image = 1, $br = 1)
@@ -661,7 +661,7 @@ 
      * MyTextSanitizer::codePreConv()
      *
      * @param  mixed $text
-     * @param  mixed $xcode
+     * @param  integer $xcode
      * @return mixed
      */
     public function codePreConv($text, $xcode = 1)
@@ -697,8 +697,8 @@ 
      * MyTextSanitizer::codeConv()
      *
      * @param  mixed $text
-     * @param  mixed $xcode
-     * @return mixed
+     * @param  integer $xcode
+     * @return string
      */
     public function codeConv($text, $xcode = 1)
     {
@@ -714,7 +714,7 @@ 
     /**
      * MyTextSanitizer::executeExtensions()
      *
-     * @return bool
+     * @return boolean|null
      */
     public function executeExtensions()
     {
@@ -799,8 +799,8 @@ 
      * MyTextSanitizer::codeSanitizer()
      *
      * @param  mixed $str
-     * @param  mixed $image
-     * @return mixed|string
+     * @param  integer $image
+     * @return string
      */
     public function codeSanitizer($str, $image = 1)
     {
@@ -817,8 +817,8 @@ 
      * @param  mixed   $text
      * @param  integer $allowhtml
      * @param  integer $smiley
-     * @param  mixed   $bbcode
-     * @return mixed|string
+     * @param  integer   $bbcode
+     * @return string
      */
     public function sanitizeForDisplay($text, $allowhtml = 0, $smiley = 1, $bbcode = 1)
     {
@@ -848,8 +848,8 @@ 
      * @param  mixed   $text
      * @param  integer $allowhtml
      * @param  integer $smiley
-     * @param  mixed   $bbcode
-     * @return mixed|string
+     * @param  integer   $bbcode
+     * @return string
      */
     public function sanitizeForPreview($text, $allowhtml = 0, $smiley = 1, $bbcode = 1)
     {
@@ -892,8 +892,8 @@ 
      * MyTextSanitizer::makeTboxData4Show()
      *
      * @param  mixed $text
-     * @param  mixed $smiley
-     * @return mixed|string
+     * @param  integer $smiley
+     * @return string
      */
     public function makeTboxData4Show($text, $smiley = 0)
     {
@@ -920,8 +920,8 @@ 
      * MyTextSanitizer::makeTboxData4Preview()
      *
      * @param  mixed $text
-     * @param  mixed $smiley
-     * @return mixed|string
+     * @param  integer $smiley
+     * @return string
      */
     public function makeTboxData4Preview($text, $smiley = 0)
     {
@@ -965,8 +965,8 @@ 
      * @param  mixed   $text
      * @param  integer $html
      * @param  integer $smiley
-     * @param  mixed   $xcode
-     * @return mixed|string
+     * @param  integer   $xcode
+     * @return string
      */
     public function &makeTareaData4Show(&$text, $html = 1, $smiley = 1, $xcode = 1)
     {
@@ -995,8 +995,8 @@ 
      * @param  mixed   $text
      * @param  integer $html
      * @param  integer $smiley
-     * @param  mixed   $xcode
-     * @return mixed|string
+     * @param  integer   $xcode
+     * @return string
      */
     public function &makeTareaData4Preview(&$text, $html = 1, $smiley = 1, $xcode = 1)
     {

htdocs/class/xoopsform/grouppermform.php

Doc Comments +1 added lines, -1 removed lines

@@ -212,7 +212,7 @@
     /**
      * Constructor
      * @param      $caption
-     * @param      $name
+     * @param      string $name
      * @param      $groupId
      * @param null $values
      */

htdocs/class/xoopsmailer.php

Doc Comments +12 added lines, -12 removed lines

@@ -149,7 +149,7 @@ 
 
     // public
     /**
-     * @param null $value
+     * @param string $value
      */
     public function setTemplateDir($value = null)
     {
@@ -163,7 +163,7 @@ 
 
     // private
     /**
-     * @return bool|string
+     * @return string|false
      */
     public function getTemplatePath()
     {
@@ -187,7 +187,7 @@ 
 
     // public
     /**
-     * @param $value
+     * @param string $value
      */
     public function setTemplate($value)
     {
@@ -215,7 +215,7 @@ 
     // RMV-NOTIFY
     // public
     /**
-     * @param $user
+     * @param XoopsUser $user
      */
     public function setFromUser($user)
     {
@@ -235,7 +235,7 @@ 
 
     // public
     /**
-     * @param $value
+     * @param string $value
      */
     public function setSubject($value)
     {
@@ -244,7 +244,7 @@ 
 
     // public
     /**
-     * @param $value
+     * @param string $value
      */
     public function setBody($value)
     {
@@ -374,8 +374,8 @@ 
     // private
     /**
      * @param $uid
-     * @param $subject
-     * @param $body
+     * @param string $subject
+     * @param string $body
      *
      * @return bool
      */
@@ -402,9 +402,9 @@ 
      * Uses the new XoopsMultiMailer
      *
      * @param $email
-     * @param $subject
-     * @param $body
-     * @param $headers
+     * @param string $subject
+     * @param string $body
+     * @param string $headers
      *
      * @return bool
      */
@@ -572,7 +572,7 @@ 
     // abstract
     // to be overridden by lang specific mail class, if needed
     /**
-     * @param $text
+     * @param string $text
      *
      * @return mixed
      */

htdocs/install/class/dbmanager.php

Doc Comments +4 added lines, -4 removed lines

@@ -200,7 +200,7 @@ 
     }
 
     /**
-     * @param $sql
+     * @param string $sql
      *
      * @return mixed
      */
@@ -212,7 +212,7 @@ 
     }
 
     /**
-     * @param $table
+     * @param string $table
      *
      * @return mixed
      */
@@ -236,8 +236,8 @@ 
     }
 
     /**
-     * @param $table
-     * @param $query
+     * @param string $table
+     * @param string $query
      *
      * @return bool
      */

htdocs/kernel/configitem.php

Doc Comments +1 added lines, -1 removed lines

@@ -227,7 +227,7 @@
     /**
      * Assign one or more {@link XoopsConfigItemOption}s
      *
-     * @param mixed $option either a {@link XoopsConfigItemOption} object or an array of them
+     * @param XoopsConfigOption $option either a {@link XoopsConfigItemOption} object or an array of them
      */
     public function setConfOptions($option)
     {