Home > Archive > PHP Documentation > November 2007 > phpdoc REF_STRUCT_DEV partial configure patch
You are viewing an archived Text-only version of the thread.
To view this thread in it's original format and/or if you want to reply to
this thread please [click here]
| Author |
phpdoc REF_STRUCT_DEV partial configure patch
|
|
| Edward Z. Yang 2007-11-10, 7:01 pm |
| This patch adds a --partial option to configure.php in REF_STRUCT_DEV,
allowing for quicker builds over on the PhD side.
The massive amounts of entities that .manual.xml.in defines still bloat
up the file, and I'm not exactly certain whether or not how partials for
refentry would be done.
--
Edward Z. Yang GnuPG: 0x869C48DA
HTML Purifier <http://htmlpurifier.org> Anti-XSS Filter
[[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]
| |
| Edward Z. Yang 2007-11-10, 10:02 pm |
| Edward Z. Yang wrote:
> This patch adds a --partial option to configure.php in REF_STRUCT_DEV,
> allowing for quicker builds over on the PhD side.
>
> The massive amounts of entities that .manual.xml.in defines still bloat
> up the file, and I'm not exactly certain whether or not how partials for
> refentry would be done.
This patch sucks. Don't commit it.
It does nothing for a documentation writer who wants to make changes,
run PhD and see his changes. configure.php still takes up way too much
time, because we basically load up all of manual.xml and then cut away
the parts we don't want. Instead, we should be loading just that
segment, or it possible for us to pass an XML source file straight to
PhD for rendering.
--
Edward Z. Yang GnuPG: 0x869C48DA
HTML Purifier <http://htmlpurifier.org> Anti-XSS Filter
[[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]
| |
| Edward Z. Yang 2007-11-10, 10:02 pm |
| Edward Z. Yang wrote:
> It does nothing for a documentation writer who wants to make changes,
> run PhD and see his changes. configure.php still takes up way too much
> time, because we basically load up all of manual.xml and then cut away
> the parts we don't want. Instead, we should be loading just that
> segment, or it possible for us to pass an XML source file straight to
> PhD for rendering.
Nonetheless, it *does* reduce the time PhD needs. I have committed a
modified version of the patch.
--
Edward Z. Yang GnuPG: 0x869C48DA
HTML Purifier <http://htmlpurifier.org> Anti-XSS Filter
[[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]
|
|
|
|
|