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 (profile)
Status: Closed Package: Doc Build problem
PHP Version: Irrelevant OS: Irrelevant
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: philip@php.net
New email:
PHP Version: OS:

 

 [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: Tue Apr 23 17:01:31 2024 UTC