Doc #61034 [NEW]: Return values incorrectly specified.

From: Operating system: Linux PHP version: 5.3.10 Package: Documentation problem Bug Type: Documentation Problem Bug description:Return values incorrectly specified. Description: ------------ --- From manual page: http://www.php.net/function.feof#refsect1-function.feof-returnvalues --- Documentation should specify that it also returns false on an invalid filehandle, even though that is an "Error". (It does mention this below, in a warning section, but that's different). This insane behavior is not considered to be a bug, per: https://bugs.php.net/bug.php?id=34652 Therefore, it should at least be documented properly, so that people checking out the return values aren't reading a complete lie. Documentation should also specify that it returns NULL in older PHP versions, if no arg was specified. (Reproduced in 5.2.13, not in 5.3.3). -- Edit bug report at https://bugs.php.net/bug.php?id=61034&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=61034&r=trysnapshot54 Try a snapshot (PHP 5.3): https://bugs.php.net/fix.php?id=61034&r=trysnapshot53 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=61034&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=61034&r=fixed Fixed in SVN and need be documented: https://bugs.php.net/fix.php?id=61034&r=needdocs Fixed in release: https://bugs.php.net/fix.php?id=61034&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=61034&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=61034&r=needscript Try newer version: https://bugs.php.net/fix.php?id=61034&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=61034&r=support Expected behavior: https://bugs.php.net/fix.php?id=61034&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=61034&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=61034&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=61034&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=61034&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=61034&r=dst IIS Stability: https://bugs.php.net/fix.php?id=61034&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=61034&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=61034&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=61034&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=61034&r=mysqlcfg