Doc #74049 [Opn->Csd]: Unclear statement about vital difference between versions
Edit report at https://bugs.php.net/bug.php?id=74049&edit=1
ID: 74049
Updated by: peehaa@php.net
Reported by: teo8976 at gmail dot com
Summary: Unclear statement about vital difference between
versions
-Status: Open
+Status: Closed
Type: Documentation Problem
Package: Scripting Engine problem
PHP Version: Irrelevant
-Assigned To:
+Assigned To: peehaa
Block user comment: N
Private report: N
New Comment:
The fix for this bug has been committed.
Snapshots of the sources are packaged every three hours; this change
will be in the next snapshot. You can grab the snapshot at
http://snaps.php.net/.
For Windows:
http://windows.php.net/snapshots/
Thank you for the report, and for helping us make PHP better.
Previous Comments:
------------------------------------------------------------------------
[2017-03-01 10:59:47] teo8976 at gmail dot com
> IMO OP just confused himself here.
I got confused because the phrasing is confusing.
> Sounds like OP is thinking about https://www.ietf.org/rfc/rfc2119.txt which our
> manual does not follow.
No, I'm just thinking about plain English.
> No it usually does not. It means "may not".
Yeah, but "may not" as in "it is a possibility that it doesn't". Here,
instead, the intended meaning is "it is not a possibility that it does", i.e.
"cannot"/"must not". It is a correct but not common use of "may not".
In this particular context the "it is not allowed to", so the most natural way of saying
it is "cannot". Why use an unnecessarily elaborate phrasing when there is a simpler,
unambiguous, cristal clear one?
> but I wonder if it's just OP or also other people
Judging by comment [2017-02-06 14:24 UTC] cmb@php.net (how shitty is it that comments aren't
even numbered??), it looks like it's not just me.
------------------------------------------------------------------------
[2017-03-01 09:08:40] peehaa@php.net
IMO OP just confused himself here.
May not in this context is just fine.
Sounds like OP is thinking about https://www.ietf.org/rfc/rfc2119.txt which our
manual does not follow.
> That's confusing, as "may not" usually means "may or may not"
No it usually does not. It means "may not".
I don't feel strongly either way to change or keep the wording if it really is confusing to
people, but I wonder if it's just OP or also other people *and* whether it means it's also
confusing in other places in the manual.
------------------------------------------------------------------------
[2017-02-06 14:24:59] cmb@php.net
> You don't know what "may not" means?
Wouldn't "must not" be clearer, anyway?
------------------------------------------------------------------------
[2017-02-05 20:32:21] teo8976 at gmail dot com
By the way, it says "from PHP 7.1", but $this is not allowed in 5.x either
------------------------------------------------------------------------
[2017-02-05 20:29:25] teo8976 at gmail dot com
Oh, I see, "may not" as in "are not allowed to".
That's confusing, as "may not" usually means "may or may not", as in
"you don't know whether they do or they don't".
It should read "cannot include", then.
------------------------------------------------------------------------
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=74049
--
Edit this bug report at https://bugs.php.net/bug.php?id=74049&edit=1
Thread (8 messages)