Req #51853 [Opn]: Allow php version info everywhere
| From: | philip@php.net | Date: | Mon, 18 Apr 2011 14:50:51 +0000 |
| Subject: | Req #51853 [Opn]: Allow php version info everywhere | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-6251@lists.php.net to get a copy of this message | ||
Edit report at http://bugs.php.net/bug.php?id=51853&edit=1
ID: 51853
Updated by: philip@php.net
Reported by: philip@php.net
Summary: Allow php version info everywhere
Status: Open
Type: Feature/Change Request
Package: Doc Build problem
Operating System: Irrelevant
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
Sounds good and reasonable... Commit! :)
Previous Comments:
------------------------------------------------------------------------
[2010-07-02 19:34:59] bjori@php.net
Unsure how I feel about a magical element that needs to inject that
information
into the heading of the document.
How about something like:
<para><?phpdoc print-version-for="include_once"?></para>
Which would lookup in the aggregated versions.xml file and return the
version of
include_once?
The you'd start the chapter/reference/article with that line to get the
structure consistent with the refpages?
------------------------------------------------------------------------
[2010-05-18 18:45:45] rquadling@php.net
There is a <revision> and and a <revnumber> tag. But <revision> requires
a <date>
and either an <author> or an <authorinitials>.
But <para role="revinfo">PHP 5 >= 5.3.0</para> should cover it.
------------------------------------------------------------------------
[2010-05-18 18:33:22] philip@php.net
Description:
------------
This request allows us to add XML markup to any file, such as:
<version>PHP 5 >= 5.2.0</version>
Bad XML example. However, upon further thought any book/chapter/sect/...
would
allow adding version information in a similar fashion to how function
pages do now
(via versions.xml info).
Example places we might do this:
- class docs
- goto
- include/require
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/bug.php?id=51853&edit=1