Bug #68689 [NEW]: log_errors description is misleading
| From: | chealer at gmail dot com | Date: | Tue, 30 Dec 2014 03:41:10 +0000 |
| Subject: | Bug #68689 [NEW]: log_errors description is misleading | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-11785@lists.php.net to get a copy of this message | ||
From: chealer at gmail dot com
Operating system:
PHP version: Irrelevant
Package: Documentation problem
Bug Type: Bug
Bug description:log_errors description is misleading
Description:
------------
The description of log_errors is:
log_errors boolean
Tells whether script error messages should be logged to the server's
error log or error_log. This option is thus server-specific.
Note:
You're strongly advised to use error logging in place of error
displaying on production web sites.
As discussed in #66567, error_log is the directive allowing to choose
how to log. log_errors is just a boolean determining whether PHP should
log errors or not.
The first sentence is not exactly wrong, but unclear. The following
sentence ("This option is thus server-specific.") belongs to error_log's
description, not here.
I suggest replacing the whole English paragraph with just:
Tells whether script error messages should be logged.
The only problem with that is it doesn't refer to error_log, about which
the reader will naturally want to learn next.
--
Edit bug report at https://bugs.php.net/bug.php?id=68689&edit=1
--
Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=68689&r=trysnapshot54
Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=68689&r=trysnapshot55
Try a snapshot (trunk): https://bugs.php.net/fix.php?id=68689&r=trysnapshottrunk
Fixed in SVN: https://bugs.php.net/fix.php?id=68689&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=68689&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=68689&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=68689&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=68689&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=68689&r=support
Expected behavior: https://bugs.php.net/fix.php?id=68689&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=68689&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=68689&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=68689&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=68689&r=php4
Daylight Savings: https://bugs.php.net/fix.php?id=68689&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=68689&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=68689&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=68689&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=68689&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=68689&r=mysqlcfg