#44395 [Opn->Ana]: FR: custom changelog parsing
| From: | bjori@php.net | 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