symphonycms / symphony-2

symphony/lib/toolkit/class.extensionmanager.php

Doc Comments +1 added lines, -1 removed lines

@@ -321,7 +321,7 @@
      *  The name of the Extension Class minus the extension prefix.
      * @param string $file_version
      *  The version of the extension from the **file**, not the Database.
-     * @return string|boolean
+     * @return false|string
      *  If the given extension (by $name) requires updating, the installed
      *  version is returned, otherwise, if the extension doesn't require
      *  updating, false.

symphony/lib/toolkit/class.general.php

Doc Comments +9 added lines, -5 removed lines

@@ -528,7 +528,7 @@ 
      *
      * @param string $path
      *  the path containing the directories to create.
-     * @param string|integer $mode (optional)
+     * @param integer $mode (optional)
      *  the permissions (in octal) of the directories to create. Defaults to 0755
      * @param boolean $silent (optional)
      *  true if an exception should be raised if an error occurs, false
@@ -709,6 +709,10 @@ 
     public static function getPostData()
     {
         if (!function_exists('merge_file_post_data')) {
+
+            /**
+             * @param string $type
+             */
             function merge_file_post_data($type, array $file, &$post)
             {
                 foreach ($file as $key => $value) {
@@ -928,7 +932,7 @@ 
      *  the path of the file to write.
      * @param mixed $data
      *  the data to write to the file.
-     * @param integer|string $perm (optional)
+     * @param integer $perm (optional)
      *  the permissions as an octal number to set set on the resulting file.
      *  this defaults to 0644 (if omitted or set to null)
      * @param string $mode (optional)
@@ -1198,7 +1202,7 @@ 
      * @param mixed $strip_root (optional)
      *  If null, the full path to the file will be returned, otherwise the value
      *  of `strip_root` will be removed from the file path.
-     * @param array $exclude (optional)
+     * @param string[] $exclude (optional)
      *  ignore directories listed in this array. this defaults to an empty array.
      * @param boolean $ignore_hidden (optional)
      *  ignore hidden directory (i.e.directories that begin with a period). this defaults
@@ -1250,7 +1254,7 @@ 
      * @param string $dir (optional)
      *  the path of the directory to construct the multi-dimensional array
      *  for. this defaults to '.'.
-     * @param array|string $filters (optional)
+     * @param string $filters (optional)
      *  either a regular expression to filter the files by or an array of
      *  files to include.
      * @param boolean $recurse (optional)
@@ -1427,7 +1431,7 @@ 
      *  the file name within the file path to which the source file is to be moved.
      * @param string $tmp_name
      *  the full path name of the source file to move.
-     * @param integer|string $perm (optional)
+     * @param integer $perm (optional)
      *  the permissions to apply to the moved file. this defaults to 0644 @since
      *  Symphony 2.7.0. It was 0777 in 2.6.x and less.
      * @return boolean

symphony/lib/toolkit/class.field.php

Doc Comments +5 added lines, -5 removed lines

@@ -1230,7 +1230,7 @@ 
      * If the date type is set, only the calendar will be shown in the suggestion dropdown.
      *
      * @since Symphony 2.6.0
-     * @return array
+     * @return string[]
      */
     public function fetchSuggestionTypes()
     {
@@ -1323,7 +1323,7 @@ 
      *
      * @param string $string
      *  The string to test.
-     * @return boolean
+     * @return boolean|null
      *  true if the string is prefixed with `regexp:` or `not-regexp:`, false otherwise.
      */
     protected static function isFilterRegex($string)
@@ -1343,7 +1343,7 @@ 
      * @link https://dev.mysql.com/doc/refman/en/regexp.html
      * @param string $filter
      *  The full filter, eg. `regexp: ^[a-d]`
-     * @param array $columns
+     * @param string[] $columns
      *  The array of columns that need the given `$filter` applied to. The conditions
      *  will be added using `OR` when using `regexp:` but they will be added using `AND`
      *  when using `not-regexp:`
@@ -1404,7 +1404,7 @@ 
      * @since Symphony 2.7.0
      * @param string $string
      *  The string to test.
-     * @return boolean
+     * @return boolean|null
      *  true if the string is prefixed with `sql:`, false otherwise.
      */
     protected static function isFilterSQL($string)
@@ -1422,7 +1422,7 @@ 
      * @link https://dev.mysql.com/doc/refman/en/regexp.html
      * @param string $filter
      *  The full filter, eg. `sql: NULL`
-     * @param array $columns
+     * @param string[] $columns
      *  The array of columns that need the given `$filter` applied to. The conditions
      *  will be added using `OR`.
      * @param string $joins