Bug #44395 [Ana->Wfx]: FR: custom changelog parsing
| From: | bjori@php.net | Date: | Fri, 06 Apr 2012 18:01:53 +0000 |
| Subject: | Bug #44395 [Ana->Wfx]: FR: custom changelog parsing | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-8202@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=44395&edit=1
ID: 44395
Updated by: bjori@php.net
Reported by: philip@php.net
Summary: FR: custom changelog parsing
-Status: Analyzed
+Status: Wont fix
Type: Bug
Package: Doc Build problem
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
I don't think this is every going to happen
Previous Comments:
------------------------------------------------------------------------
[2009-09-25 18:30:16] philip@php.net
Interesting. Added a version="" attribute anywhere sounds potentially
useful on many levels, but may cause problems on others. Let's think
about it.
------------------------------------------------------------------------
[2008-05-04 00:34:01] bjori@php.net
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"...
------------------------------------------------------------------------
[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 https://bugs.php.net/bug.php?id=44395&edit=1