php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Request #51853 Allow php version info everywhere
Submitted: 2010-05-18 18:33 UTC Modified: 2011-07-05 15:05 UTC
From: philip@php.net Assigned: bjori
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID:
 [2010-05-18 18:33 UTC] philip@php.net
Description:
------------
This request allows us to add XML markup to any file, such as:

 <version>PHP 5 &gt;= 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



Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-05-18 18:45 UTC] 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 &gt;= 5.3.0</para> should cover it.
 [2010-07-02 19:34 UTC] 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?
 [2011-04-18 16:50 UTC] philip@php.net
Sounds good and reasonable... Commit! :)
 [2011-07-05 15:05 UTC] bjori@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: bjori
 [2011-07-05 15:05 UTC] bjori@php.net
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
 
PHP Copyright © 2001-2014 The PHP Group
All rights reserved.
Last updated: Fri Apr 25 07:02:14 2014 UTC