Doc #81065 [Com]: Changes to Reflection modifiers not documented
Edit report at https://bugs.php.net/bug.php?id=81065&edit=1
ID: 81065
Comment by: yuki dot nishida at sys21 dot co dot jp
Reported by: yuki dot nishida at sys21 dot co dot jp
Summary: Changes to Reflection modifiers not documented
Status: Closed
Type: Documentation Problem
Package: Reflection related
Operating System: none
PHP Version: 7.3.28
Block user comment: N
Private report: N
New Comment:
Thank you! (*âÏâ *)
I have confirmed that I have been corrected (added).
Glad to see that it was handled with great speed.
I admire you guys and hope to respond as quickly as you do.
Once again, thank you very much.
Previous Comments:
------------------------------------------------------------------------
[2021-05-23 15:54:11] git@php.net
Automatic comment on behalf of mumumu
Revision: https://github.com/php/doc-ja/commit/b328f5e58c2545943cc0ff015de7793a1a35eb0f
Log: Fix #81065: Changes to Reflection modifiers not documented
------------------------------------------------------------------------
[2021-05-23 12:46:43] git@php.net
Automatic comment on behalf of cmb69
Revision: https://github.com/php/doc-en/commit/6f41560bf19de74e2dfbc78f4175d35f5b378abe
Log: Fix #81065: Changes to Reflection modifiers not documented
------------------------------------------------------------------------
[2021-05-21 11:34:52] cmb@php.net
Ah, right, we either need to update the values (and add changelog
entries), or maybe not show the values at all. We also need to
update related examples accordingly, e.g.
<https://www.php.net/manual/en/reflectionmethod.getmodifiers.php#refsect1-reflectionmethod.getmodifiers-examples>.
------------------------------------------------------------------------
[2021-05-21 11:17:39] imsop@php.net
I agree that the manual should be clearer here. There are probably other similar constants which are
exposed from internal values and subject to change between versions.
* We should have a standard note such as "The values of constants may change between versions
or environments. It is recommended to always use the constants directly and not rely on the values
directly."
* Should we show the values for these at all, since users shouldn't be relying on them?
------------------------------------------------------------------------
[2021-05-21 11:12:09] yuki dot nishida at sys21 dot co dot jp
I'm sorry!
I forgot about this one...(*'omega'*)
It's not on the changelog, which I think is the most confusing thing about it.
I'd like to see the change of the actual value of algebraic constants in the changelog.
I'm sorry. I'm sorry. I think this is the essence of what I want to request.
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
https://bugs.php.net/bug.php?id=81065
--
Edit this bug report at https://bugs.php.net/bug.php?id=81065&edit=1
Thread (6 messages)