Doc #71684 [NEW]: Some pages of manual are missing version numbers
| From: | lsiden at gmail dot com | Date: | Sun, 28 Feb 2016 17:44:30 +0000 |
| Subject: | Doc #71684 [NEW]: Some pages of manual are missing version numbers | ||
| Groups: | php.doc.bugs | ||
| Request: | Send a blank email to doc-bugs+get-13222@lists.php.net to get a copy of this message | ||
From: lsiden at gmail dot com
Operating system: all
PHP version: Irrelevant
Package: *General Issues
Bug Type: Documentation Problem
Bug description:Some pages of manual are missing version numbers
Description:
------------
---
From manual page: http://www.php.net/index
---
This is not a bug, but a suggestion: I would like to see every page of
the manual contain a subtitle that states what version of PHP it applies
to such as "(PHP4, PHP5, PHP7)". This exists on many pages, such as
those that document functions (e.g.
https://secure.php.net/manual/en/function.assert.php),
but not pages
that apply to basic language features such as
https://secure.php.net/manual/en/language.expressions.php.
It may be the practice of the authors that doc pages that cover basic
language features like expressions apply to all versions and therefore
do not need to state those versions, but I have found it confusing not
to find this information on every doc page.
If the authors intend that a feature of the language and therefore its
doc page should remain valid for all past and future versions and it
might be cumbersome to have to change "(PHP4, PHP5, PHP7)" to "(PHP4,
PHP5, PHP7, PHP8)" for example, then it might be sufficient to write
"(all versions)".
If this is not the right forum to report this issue, please point me to
the right one and I'll re-post it there.
--
Edit bug report at https://bugs.php.net/bug.php?id=71684&edit=1
--
Try a snapshot (PHP 5.4): https://bugs.php.net/fix.php?id=71684&r=trysnapshot54
Try a snapshot (PHP 5.5): https://bugs.php.net/fix.php?id=71684&r=trysnapshot55
Try a snapshot (trunk): https://bugs.php.net/fix.php?id=71684&r=trysnapshottrunk
Fixed in SVN: https://bugs.php.net/fix.php?id=71684&r=fixed
Fixed in release: https://bugs.php.net/fix.php?id=71684&r=alreadyfixed
Need backtrace: https://bugs.php.net/fix.php?id=71684&r=needtrace
Need Reproduce Script: https://bugs.php.net/fix.php?id=71684&r=needscript
Try newer version: https://bugs.php.net/fix.php?id=71684&r=oldversion
Not developer issue: https://bugs.php.net/fix.php?id=71684&r=support
Expected behavior: https://bugs.php.net/fix.php?id=71684&r=notwrong
Not enough info: https://bugs.php.net/fix.php?id=71684&r=notenoughinfo
Submitted twice: https://bugs.php.net/fix.php?id=71684&r=submittedtwice
register_globals: https://bugs.php.net/fix.php?id=71684&r=globals
PHP 4 support discontinued: https://bugs.php.net/fix.php?id=71684&r=php4
Daylight Savings: https://bugs.php.net/fix.php?id=71684&r=dst
IIS Stability: https://bugs.php.net/fix.php?id=71684&r=isapi
Install GNU Sed: https://bugs.php.net/fix.php?id=71684&r=gnused
Floating point limitations: https://bugs.php.net/fix.php?id=71684&r=float
No Zend Extensions: https://bugs.php.net/fix.php?id=71684&r=nozend
MySQL Configuration Error: https://bugs.php.net/fix.php?id=71684&r=mysqlcfg