Doc #77236 [Com]: Many reflection functions are undocumented

[email protected] ("insidebuzz3 at gmail dot com") Fri, 21 Apr 2023 10:35:47 +0000
Newsgroups php.doc.bugs
Message-ID <[email protected]>
Edit report at https://bugs.php.net/bug.php?id=77236&edit=1

 ID:                 77236
 Comment by:         insidebuzz3 at gmail dot com
 Reported by:        rulatir at wp dot pl
 Summary:            Many reflection functions are undocumented
 Status:             Verified
 Type:               Documentation Problem
 Package:            Reflection related
 Operating System:   N/A
 PHP Version:        Irrelevant
 Block user comment: N
 Private report:     N

 New Comment:

Insidebuzz are  education, entertainment, fashion & style, finance, real state, social media etc. More info:(https://insidebuzz.net)github.com


Previous Comments:
------------------------------------------------------------------------
[2021-11-11 11:24:14] [email protected]

To my knowledge, the online editor is no longer accessible without
php.net account, but PRs[1] are welcome!

[1] <https://github.com/php/doc-en/pulls>

------------------------------------------------------------------------
[2019-01-01 21:18:33] [email protected]

I'm not the most versed person with the Reflection API.
However, if you have any knowledge you can always document the functions/classes
using the online PHP documentation editor at https://edit.php.net and submit a (or multiple) patches.

------------------------------------------------------------------------
[2018-12-04 06:34:44] rulatir at wp dot pl

Description:
------------
For WAY too many YEARS now, the documentation of many methods of many reflection classes contains this notice:

"Warning This function is currently not documented; only its argument list is available."

This is completely unacceptable. Bug #41574 is 11 years old, it has seen no activity other than a reply from someone @php.net to the effect of "we are working on it" (which turned out to be a LIE), and has been closed as "not a bug". I am creating this report on the technicality that #41574 refers specifically to the \Reflector class while the issue also pertains to many other reflection classes.



------------------------------------------------------------------------



--
Edit this bug report at https://bugs.php.net/bug.php?id=77236&edit=1