Doc #68689 [Asn->Opn]: log_errors description is misleading

From: Date: Tue, 24 Oct 2017 06:28:19 +0000
Subject: Doc #68689 [Asn->Opn]: log_errors description is misleading
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-15139@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=68689&edit=1

 ID:                 68689
 Updated by:         kalle@php.net
 Reported by:        chealer at gmail dot com
 Summary:            log_errors description is misleading
-Status:             Assigned
+Status:             Open
 Type:               Documentation Problem
 Package:            *Configuration Issues
 PHP Version:        Irrelevant
-Assigned To:        pasindu
+Assigned To:        
 Block user comment: N
 Private report:     N



Previous Comments:
------------------------------------------------------------------------
[2014-12-30 03:41:09] chealer at gmail dot com

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 this bug report at https://bugs.php.net/bug.php?id=68689&edit=1


Thread (2 messages)

« previous php.doc.bugs (#15139) next »