Doc #53420 [NEW]: mail.log is poorly documented

From: Operating system: PHP version: Irrelevant Package: Documentation problem Bug Type: Documentation Problem Bug description:mail.log is poorly documented 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 bug report at http://bugs.php.net/bug.php?id=53420&edit=1 -- Try a snapshot (PHP 5.2): http://bugs.php.net/fix.php?id=53420&r=trysnapshot52 Try a snapshot (PHP 5.3): http://bugs.php.net/fix.php?id=53420&r=trysnapshot53 Try a snapshot (trunk): http://bugs.php.net/fix.php?id=53420&r=trysnapshottrunk Fixed in SVN: http://bugs.php.net/fix.php?id=53420&r=fixed Fixed in SVN and need be documented: http://bugs.php.net/fix.php?id=53420&r=needdocs Fixed in release: http://bugs.php.net/fix.php?id=53420&r=alreadyfixed Need backtrace: http://bugs.php.net/fix.php?id=53420&r=needtrace Need Reproduce Script: http://bugs.php.net/fix.php?id=53420&r=needscript Try newer version: http://bugs.php.net/fix.php?id=53420&r=oldversion Not developer issue: http://bugs.php.net/fix.php?id=53420&r=support Expected behavior: http://bugs.php.net/fix.php?id=53420&r=notwrong Not enough info: http://bugs.php.net/fix.php?id=53420&r=notenoughinfo Submitted twice: http://bugs.php.net/fix.php?id=53420&r=submittedtwice register_globals: http://bugs.php.net/fix.php?id=53420&r=globals PHP 4 support discontinued: http://bugs.php.net/fix.php?id=53420&r=php4 Daylight Savings: http://bugs.php.net/fix.php?id=53420&r=dst IIS Stability: http://bugs.php.net/fix.php?id=53420&r=isapi Install GNU Sed: http://bugs.php.net/fix.php?id=53420&r=gnused Floating point limitations: http://bugs.php.net/fix.php?id=53420&r=float No Zend Extensions: http://bugs.php.net/fix.php?id=53420&r=nozend MySQL Configuration Error: http://bugs.php.net/fix.php?id=53420&r=mysqlcfg