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

From: Date: Mon, 18 Apr 2011 14:50:51 +0000
Subject: Req #51853 [Opn]: Allow php version info everywhere
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-6251@lists.php.net to get a copy of this message
Edit report at http://bugs.php.net/bug.php?id=51853&edit=1 ID: 51853 Updated by: philip@php.net Reported by: philip@php.net Summary: Allow php version info everywhere Status: Open Type: Feature/Change Request Package: Doc Build problem Operating System: Irrelevant PHP Version: Irrelevant Block user comment: N Private report: N New Comment: Sounds good and reasonable... Commit! :) Previous Comments: ------------------------------------------------------------------------ [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 http://bugs.php.net/bug.php?id=51853&edit=1

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