#44395 [Opn->Ana]: FR: custom changelog parsing

From: Date: Sun, 04 May 2008 00:34:03 +0000
Subject: #44395 [Opn->Ana]: FR: custom changelog parsing
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-795@lists.php.net to get a copy of this message
ID: 44395 Updated by: bjori@php.net Reported By: philip@php.net -Status: Open +Status: Analyzed Bug Type: Doc Build problem PHP Version: Irrelevant New Comment: I don't think PhD can sanely discard changelog rows based on magic entry value. It would make more sense if we used some attributes which we could then compare against. Something like <entry version="5.2.0">Introduced foobar</entry> could easily be dropped by PhD, or magically create the "version" field in the changelog table. This can also be solved with JS by collapsing all entries based on the "configured setting"... Previous Comments: ------------------------------------------------------------------------ [2008-03-11 00:48:54] ezyang@php.net A related, but more complex feature request, would be to have PhD discard parts of documentation that are not pertinent to a version; thus docs can contain info for things in CVS HEAD, while we build against the latest stable version of PHP. This would probably need some extra markup. ------------------------------------------------------------------------ [2008-03-10 17:23:05] philip@php.net Description: ------------ This feature request allows us to configure which ChangeLog entries are displayed (built) by PhD. For example, we may say "Do not show changelog entries earlier than 4.1.0" This only takes into account changelog roles inside function documentation for now, but should allow future types of changelog markup too. ------------------------------------------------------------------------ -- Edit this bug report at http://bugs.php.net/?id=44395&edit=1

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