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

Edit report at https://bugs.php.net/bug.php?id=77021&edit=1 ID: 77021 User updated by: gth at example dot com Reported by: gth at example dot com Summary: Conflicting info re. PHP.INI section headings Status: Open Type: Documentation Problem Package: PHP options/info functions Operating System: (Not applicable) PHP Version: Irrelevant Block user comment: N Private report: N New Comment: Amended submitter detail Previous Comments: ------------------------------------------------------------------------ [2018-10-16 08:58:29] gth at example dot com 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 this bug report at https://bugs.php.net/bug.php?id=77021&edit=1