symphonycms / symphony-2

symphony/lib/toolkit/class.general.php

Doc Comments +9 added lines, -4 removed lines

@@ -104,7 +104,7 @@ 
      * @param boolean $isFile (optional)
      *  if this is true, the method will attempt to read from a file, `$data`
      *  instead.
-     * @param mixed $xsltProcessor (optional)
+     * @param XsltProcess $xsltProcessor (optional)
      *  if set, the validation will be done using this XSLT processor rather
      *  than the built in XML parser. the default is null.
      * @param string $encoding (optional)
@@ -682,6 +682,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) {
@@ -900,7 +904,7 @@ 
      *  the path of the file to write.
      * @param mixed $data
      *  the data to write to the file.
-     * @param integer|null $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)
@@ -1100,7 +1104,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
@@ -1152,7 +1156,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)
@@ -1345,6 +1349,7 @@ 
      *  the full path name of the source file to move.
      * @param integer $perm (optional)
      *  the permissions to apply to the moved file. this defaults to 0777.
+     * @param string $dest_name
      * @return boolean
      *  true if the file was moved and its permissions set as required. false otherwise.
      */

symphony/lib/toolkit/class.smtp.php

Doc Comments +1 added lines, -3 removed lines

@@ -126,12 +126,10 @@
      *  The from string. Should have the following format: email@domain.tld
      * @param string $to
      *  The email address to send the email to.
-     * @param string $subject
-     *  The subject to send the email to.
      * @param string $message
      * @throws SMTPException
      * @throws Exception
-     * @return boolean
+     * @return boolean|null
      */
     public function sendMail($from, $to, $message)
     {

symphony/lib/toolkit/events/class.event.section.php

Doc Comments +2 added lines, -3 removed lines

@@ -65,7 +65,7 @@ 
      * @param XMLElement $result
      * @param array $fields
      * @param array $errors
-     * @param object $post_values
+     * @param XMLElement $post_values
      * @throws Exception
      * @return XMLElement
      */
@@ -192,7 +192,6 @@ 
      * Helper method to determine if a field is missing, or if the data
      * provided was invalid. Used in conjunction with `array_reduce`.
      *
-     * @param array $a,
      * @param array $b
      * @return string
      *  'missing' or 'invalid'
@@ -303,7 +302,7 @@ 
      *  If this Event is editing an existing entry, that Entry ID will
      *  be passed to this function.
      * @throws Exception
-     * @return XMLElement
+     * @return boolean
      *  The result of the Event
      */
     public function __doit(array $fields = array(), XMLElement &$result, $position = null, $entry_id = null)