Doc #79659 [Asn->Opn]: A remark in documentation is missing

Edit report at https://bugs.php.net/bug.php?id=79659&edit=1 ID: 79659 Updated by: cmb@php.net Reported by: jakobr at gmx dot net Summary: A remark in documentation is missing -Status: Assigned +Status: Open Type: Documentation Problem Package: Documentation problem PHP Version: Irrelevant -Assigned To: cmb +Assigned To: Block user comment: N Private report: N 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] cmb@php.net 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