Req #51853 [Opn->Csd]: Allow php version info everywhere
| From: | bjori@php.net | Date: | Tue, 05 Jul 2011 19:05:17 +0000 |
| Subject: | Req #51853 [Opn->Csd]: Allow php version info everywhere | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-6835@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=51853&edit=1
ID: 51853
Updated by: bjori@php.net
Reported by: philip@php.net
Summary: Allow php version info everywhere
-Status: Open
+Status: Closed
Type: Feature/Change Request
Package: Doc Build problem
Operating System: Irrelevant
PHP Version: Irrelevant
-Assigned To:
+Assigned To: bjori
Block user comment: N
Private report: N
New Comment:
This bug has been fixed in SVN. Since the websites are not directly
updated from the SVN server, the fix might need some time to spread
across the globe to all mirror sites, including PHP.net itself.
Thank you for the report, and for helping us make PHP.net better.
Blah. Forgot to mention the bug number in the commit.
fixed in svn; http://svn.php.net/viewvc?view=revision&revision=312946
Previous Comments:
------------------------------------------------------------------------
[2011-04-18 16:50:49] philip@php.net
Sounds good and reasonable... Commit! :)
------------------------------------------------------------------------
[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 https://bugs.php.net/bug.php?id=51853&edit=1