symphonycms / symphony-2

symphony/lib/toolkit/class.fieldmanager.php

Doc Comments +3 added lines, -3 removed lines

@@ -57,7 +57,7 @@ 
      *
      * @param string $type
      *  The field handle, that is, `field.{$handle}.php`
-     * @return string|boolean
+     * @return string|false
      */
     public static function __getClassPath($type)
     {
@@ -111,7 +111,7 @@ 
      * @throws DatabaseException
      * @param array $fields
      *  Associative array of field names => values for the Field object
-     * @return integer|boolean
+     * @return false|string
      *  Returns a Field ID of the created Field on success, false otherwise.
      */
     public static function add(array $fields)
@@ -138,7 +138,7 @@ 
      * @param array $settings
      *  An associative array of settings, where the key is the column name
      *  and the value is the value.
-     * @return boolean
+     * @return PDOStatement
      *  True on success, false on failure
      */
     public static function saveSettings($field_id, $settings)

symphony/lib/toolkit/class.mysql.php

Doc Comments +5 added lines, -13 removed lines

@@ -352,7 +352,7 @@ 
      * Returns the last insert ID from the previous query. This is
      * the value from an auto_increment field.
      *
-     * @return integer
+     * @return string
      *  The last interested row's ID
      */
     public function getInsertID()
@@ -379,7 +379,7 @@ 
      *  conflicts. By default this is set to false, which will not update the data and
      *  would return an SQL error
      * @throws DatabaseException
-     * @return boolean
+     * @return PDOStatement
      */
     public function insert(array $fields, $table, $updateOnDuplicate=false)
     {
@@ -443,7 +443,7 @@ 
      *  A WHERE statement for this UPDATE statement, defaults to null
      *  which will update all rows in the $table
      * @throws DatabaseException
-     * @return boolean
+     * @return PDOStatement
      */
     public function update($fields, $table, $where = null, $params = array())
     {
@@ -469,7 +469,7 @@ 
      *  A WHERE statement for this DELETE statement, defaults to null,
      *  which will delete all rows in the $table
      * @throws DatabaseException
-     * @return boolean
+     * @return PDOStatement
      */
     public function delete($table, $where = null, array $params = array())
     {
@@ -585,11 +585,6 @@ 
      * @param string $query
      *  The full SQL query to execute. Defaults to null, which will
      *  use the `$this->_lastResult`
-     * @param array $params
-     *  An array containing parameters to be used in the query. The query has to be
-     *  sprintf-formatted. All values will be sanitized before being used in the query.
-     *  For sake of backwards-compatibility, the query will only be sprintf-processed
-     *  if $params is not empty.
      * @return string
      *  Returns the value of the given column, if it doesn't exist, null will be
      *  returned
@@ -649,9 +644,6 @@ 
      *
      * @uses QueryExecutionError
      * @throws DatabaseException
-     * @param string $type
-     *  Accepts one parameter, 'connect', which will return the correct
-     *  error codes when the connection sequence fails
      */
     private function __error()
     {
@@ -699,7 +691,7 @@ 
      * @throws Exception
      * @param string $sql
      *  A string containing SQL queries delimited by `;`
-     * @return boolean
+     * @return boolean|null
      *  If one of the queries fails, false will be returned and no further queries
      *  will be executed, otherwise true will be returned.
      */

symphony/lib/toolkit/class.pagemanager.php

Doc Comments +6 added lines, -6 removed lines

@@ -22,7 +22,7 @@ 
      * @param array $fields
      *  Associative array of field names => values for the Page
      * @throws DatabaseException
-     * @return integer|boolean
+     * @return false|string
      *  Returns the Page ID of the created Page on success, false otherwise.
      */
     public static function add(array $fields)
@@ -43,7 +43,7 @@ 
      *
      * @param string $handle
      *  The handle of the page
-     * @return integer
+     * @return string
      *  The Page title
      */
     public static function fetchTitleFromHandle($handle)
@@ -62,7 +62,7 @@ 
      *
      * @param string $handle
      *  The handle of the page
-     * @return integer
+     * @return string
      *  The Page ID
      */
     public static function fetchIDFromHandle($handle)
@@ -116,7 +116,7 @@ 
      *
      * @param string $name
      *  Name of the template
-     * @return mixed
+     * @return string|false
      *  String, which is the path to the template if the template is found,
      *  false otherwise
      */
@@ -512,10 +512,10 @@ 
      *
      * @param integer|array $page_id
      *  The ID of the Page, or an array of ID's
-     * @param array $select (optional)
+     * @param string[] $select (optional)
      *  Accepts an array of columns to return from `tbl_pages`. If omitted,
      *  all columns from the table will be returned.
-     * @return array|null
+     * @return integer|null
      *  An associative array of Page information with the key being the column
      *  name from `tbl_pages` and the value being the data. If multiple Pages
      *  are found, an array of Pages will be returned. If no Pages are found

symphony/lib/toolkit/class.sectionmanager.php

Doc Comments +3 added lines, -3 removed lines

@@ -30,7 +30,7 @@ 
      *    An associative of settings for a section with the key being
      *    a column name from `tbl_sections`
      * @throws DatabaseException
-     * @return integer
+     * @return false|string
      *    The newly created Section's ID
      */
     public static function add(array $settings)
@@ -184,7 +184,7 @@ 
      *
      * @param string $handle
      *  The handle of the section
-     * @return integer
+     * @return string
      *  The Section ID
      */
     public static function fetchIDFromHandle($handle)
@@ -277,7 +277,7 @@ 
      * @param integer $field_id
      *    the field ID of the linked section's linked field.
      * @throws DatabaseException
-     * @return boolean
+     * @return PDOStatement
      */
     public static function removeSectionAssociation($field_id)
     {