ZF-1907: Fix incorrect Zend_Db_Table_Abstract::fetchRow() docblock

Description

The current docblock for Zend_Db_Table_Abstract::fetchRow() contains:


* Fetches one row in an object of type Zend_Db_Table_Row_Abstract,
* or returns Boolean false if no row matches the specified criteria.

However, fetchRow() was previously changed to return NULL, not false, if no row matches the criteria. The @return parameter correctly states this.

Comments

Assigned to Bill

I realize it's a minor thing, but the issue has not been fully resolved as of the 1.5 release:


    /**
     * Fetches one row in an object of type Zend_Db_Table_Row_Abstract,
     * or returns Boolean false if no row matches the specified criteria.
     *
     * @param string|array|Zend_Db_Table_Select $where  OPTIONAL An SQL WHERE clause or Zend_Db_Table_Select object.
     * @param string|array                      $order  OPTIONAL An SQL ORDER clause.
     * @return Zend_Db_Table_Row_Abstract The row results per the
     *     Zend_Db_Adapter fetch mode, or null if no row found.
     */

Updated to reflect the problem's continued existence in the 1.5.0 release

Reopened per users request for evaluation, this seems not to have been fixed currently

I realize this is a minor issue but wouldn't it be nice if this would be fixed. This is still a problem in v1.8.0

Fix: bq. /** * Fetches one row in an object of type Zend_Db_Table_Row_Abstract, * or returns null if no row matches the specified criteria. * * @param string|array|Zend_Db_Table_Select $where OPTIONAL An SQL WHERE clause or Zend_Db_Table_Select object. * @param string|array $order OPTIONAL An SQL ORDER clause. * @return Zend_Db_Table_Row_Abstract The row results per the * Zend_Db_Adapter fetch mode, or null if no row found. */

Resolved by SVN 12864