Doc #53420 [Ver->Csd]: mail.log is poorly documented

Edit report at http://bugs.php.net/bug.php?id=53420&edit=1 ID: 53420 Updated by: aharvey@php.net Reported by: tom at whyscream dot net Summary: mail.log is poorly documented -Status: Verified +Status: Closed Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Assigned To: aharvey Block user comment: N Private report: N New Comment: This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. Manual and INI files updated. Previous Comments: ------------------------------------------------------------------------ [2010-11-29 04:44:58] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=305813 Log: Update INI files per doc bug #53420 (mail.log is poorly documented). ------------------------------------------------------------------------ [2010-11-29 04:40:29] aharvey@php.net Automatic comment from SVN on behalf of aharvey Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=305812 Log: Manual fix for doc bug #53420 (mail.log is poorly documented). ------------------------------------------------------------------------ [2010-11-27 18:11:58] philip@php.net Agreed, and the php.ini-* files should also be updated before this bug is closed. ------------------------------------------------------------------------ [2010-11-27 16:35:19] tom at whyscream dot net Description: ------------ Based upon the documentation in php.ini and documentation [1], I set mail.log in php.ini to the boolean '1', and expected it to send logging output to wherever error_log points to. This caused unexpected errors like "Warning: mail(1): failed to open stream: Permission denied in <script>" It cost me [2], and others too [3], some time to realize that mail.log expects a path to the logfile it needs to write, and no boolean. Please, add some more detail to the documentation of the parameter mail.log [1] http://php.net/manual/en/mail.configuration.php [2] http://news.php.net/php.general/309710 [3] http://stackoverflow.com/questions/1906403/mail-failed-to-open-stream-permission-denied ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/bug.php?id=53420&edit=1