Doc #77021 [NEW]: Conflicting info re. PHP.INI section headings

From: php at gth dot id dot au Operating system: (Not applicable) PHP version: Irrelevant Package: PHP options/info functions Bug Type: Documentation Problem Bug description:Conflicting info re. PHP.INI section headings Description: ------------ --- From manual page: http://www.php.net/configuration.file --- Currently states, in 'Example #2' ----- ; any text on a line after an unquoted semicolon (;) is ignored [php] ; section markers (text within square brackets) are also ignored ---- This conflicts with the 'ini-sections' feature which *does* parse content contained in square brackets, (presumably only if the content starts with 'HOST=' or 'PATH='). Not sure if there are other section headings that also have special meaning. http://php.net/manual/en/ini.sections.php //// Also a separate, minor style issue: the following acronyms are mentioned on the configuration.file doco' page without explanation. It would be good if they had the same helpful mouse-over hints that are shown for 'CGI' and 'CLI' -- - SAPI (Server Application Programming Interface) - NSAPI (Netscape (web) Server Application Programming Interface) - THTTPD (tiny/turbo/throttling HTTP server) - OS (this could probably just be expanded outright) ///// Expected result: ---------------- Suggested wording to add: <h3>Section Markers</h3> Section markers (text within square brackets) are generally ignored, except when they match the configuration directives listed in <a href=ini.sections.php>ini.sections</a>. For example '[HOST=<host>]' and '[PATH=<path>]' were added in 5.3.0. -- Edit bug report at https://bugs.php.net/bug.php?id=77021&edit=1 -- Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=77021&r=trysnapshot54 Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=77021&r=trysnapshot55 Try a snapshot (trunk): https://bugs.php.net/fix.php?id=77021&r=trysnapshottrunk Fixed in SVN: https://bugs.php.net/fix.php?id=77021&r=fixed Fixed in release: https://bugs.php.net/fix.php?id=77021&r=alreadyfixed Need backtrace: https://bugs.php.net/fix.php?id=77021&r=needtrace Need Reproduce Script: https://bugs.php.net/fix.php?id=77021&r=needscript Try newer version: https://bugs.php.net/fix.php?id=77021&r=oldversion Not developer issue: https://bugs.php.net/fix.php?id=77021&r=support Expected behavior: https://bugs.php.net/fix.php?id=77021&r=notwrong Not enough info: https://bugs.php.net/fix.php?id=77021&r=notenoughinfo Submitted twice: https://bugs.php.net/fix.php?id=77021&r=submittedtwice register_globals: https://bugs.php.net/fix.php?id=77021&r=globals PHP 4 support discontinued: https://bugs.php.net/fix.php?id=77021&r=php4 Daylight Savings: https://bugs.php.net/fix.php?id=77021&r=dst IIS Stability: https://bugs.php.net/fix.php?id=77021&r=isapi Install GNU Sed: https://bugs.php.net/fix.php?id=77021&r=gnused Floating point limitations: https://bugs.php.net/fix.php?id=77021&r=float No Zend Extensions: https://bugs.php.net/fix.php?id=77021&r=nozend MySQL Configuration Error: https://bugs.php.net/fix.php?id=77021&r=mysqlcfg