Re: The end of Livedocs

On 8/18/07, Stanislav Malyshev <stas@zend.com> wrote: > > I use Livedocs because it let me build just one file which is great > > for manual authors. Is this possible also with PhD? > > Second that, but I wonder also if it'd be possible to create some > procedure to render a chapter without rebuilding whole .manual.xml each > time anew... You "can fix" mktoc.php and build.php to use "manual.xml" rather than ".manual.xml" (as long as you aren't on *BSD/MacOSX) but it takes 500mb more ram and at least three times slower than doing "make .manual.xml" first. This is limitation/bug/feature in libxml2 so there is really nothing we can do about it. Gwynne, however, is working hard on PhD-builder[1] which will replace the whole "autoconf && ./configure && make" fun. After the builder has be implemented we should, in theory, be able to implement live generation fairly easily. [1] I was pinged, off-list, for taking more credit than I deserve for PhD. PhD is (will be) two things: - A Docbook render (build.php, include/* formats/* themes/*) - A Docbook builder (not implemented yet) The stuff in setup/ (written by Gwynne) is.. "PhD-setup"/"PhD-configurator"?