[DOC-BUGS] Doc #79659 [Com]: A remark in documentation is missing
[email protected] ("christy2951hernandez at outlook dot com") Wed, 08 May 2024 11:32:36 +0000
| Newsgroups | php.doc.bugs |
|---|---|
| Message-ID | <[email protected]> |
Edit report at https://bugs.php.net/bug.php?id=79659&edit=1 ID: 79659 Comment by: christy2951hernandez at outlook dot com Reported by: jakobr at gmx dot net Summary: A remark in documentation is missing Status: Open Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant Block user comment: N Private report: N New Comment: That was so amazing. (https://github.com)(https://www.ny-stateofhealth.com) Previous Comments: ------------------------------------------------------------------------ [2020-06-01 12:52:07] jakobr at gmx dot net In my opinion the language AutoHotkey has one of the best help files out there and there every "mutating" function has such a comment, every. ------------------------------------------------------------------------ [2020-06-01 12:03:28] [email protected] While it appears to be reasonable to document that for ini_set(), because it interferes with INI settings, I don't think it makes sense to document that for libxml_use_internal_errors() or any of the other state mutating functions (of which PHP has quite a lot). ------------------------------------------------------------------------ [2020-06-01 11:20:42] jakobr at gmx dot net Description: ------------ --- From manual page: https://php.net/function.libxml-use-internal-errors --- Like on https://www.php.net/manual/de/function.ini-set.php a remark like the following is missing: "The configuration option will keep this new value during the script's execution, and will be restored at the script's ending." Test script: --------------- libxml_use_internal_errors(true); echo libxml_use_internal_errors(); ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=79659&edit=1