Doc #78677 [Csd->Ver]: Parameter Type Widening not properly documented
| From: | sjon@php.net | Date: | Thu, 17 Oct 2019 14:20:22 +0000 |
| Subject: | Doc #78677 [Csd->Ver]: Parameter Type Widening not properly documented | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-17022@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=78677&edit=1
ID: 78677
Updated by: sjon@php.net
Reported by: pavel at bunaev dot ru
Summary: Parameter Type Widening not properly documented
-Status: Closed
+Status: Verified
Type: Documentation Problem
Package: Class/Object related
Operating System: 18.04.1-Ubuntu
PHP Version: 7.2.23
Block user comment: N
Private report: N
New Comment:
reopening as a documentation bug
Previous Comments:
------------------------------------------------------------------------
[2019-10-17 10:53:51] pavel at bunaev dot ru
Indeed, this is not a bug.
Somehow I missed this point in the documentation :(
I apologize for wasting your time in vain
Thanks for the clarification.
------------------------------------------------------------------------
[2019-10-17 09:12:32] cmb@php.net
Well, there is a note in the Interfaces section[1], but this is
only correct for PHP 7.2 and up (and even too general for 7.2),
and it doesn't cater to inheritance in general. It seems to me
that this should be documented in the Inheritance section[2]; we
could link to that section from other parts of the manual where
appropriate.
[1] <https://www.php.net/manual/en/language.oop5.interfaces.php>
[2] <https://www.php.net/manual/en/language.oop5.inheritance.php>
------------------------------------------------------------------------
[2019-10-17 08:05:43] sjon@php.net
@cmb shouldn't this functionality also be documented on https://www.php.net/manual/en/functions.arguments.php#functions.arguments.type-declaration
?
------------------------------------------------------------------------
[2019-10-17 08:04:01] sjon@php.net
While this might be documented better, this is definitely not a bug, see
https://wiki.php.net/rfc/parameter-no-type-variance
------------------------------------------------------------------------
[2019-10-17 08:02:40] cmb@php.net
Thank you for taking the time to write to us, but this is not
a bug. Please double-check the documentation available at
http://www.php.net/manual/ and the instructions on how to
report
a bug at http://bugs.php.net/how-to-report.php
See <https://www.php.net/manual/en/migration72.new-features.php#migration72.new-features.param-type-widening>.
------------------------------------------------------------------------
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=78677
--
Edit this bug report at https://bugs.php.net/bug.php?id=78677&edit=1