php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

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 (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
View Add Comment Developer Edit
 [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-2024 The PHP Group
All rights reserved. 		Last updated: Thu Apr 18 13:01:27 2024 UTC