Req #51853 [Opn->Csd]: Allow php version info everywhere

From: 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 &gt;= 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 &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 ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=51853&edit=1

« previous php.doc.bugs (#6835) next »