This message is being re-sent without attachment as it seems several
people did not receive it the first time.
For some time now, the IRC channel for PHP documentation has been
buzzing with talk of all the myriad problems and drawbacks of both 1)
the current doc buildsystem, and 2) livedocs. I got my dander up
about it one night and drew up a formal proposal document describing
in detail a completely new, from-scratch system to replace the
nightmarish hacks that exist right now. The latest version of the
proposal is available live at <http://phpdoc.gwynne.dyndns.org/
Buildsystem-proposal.pdf>, and I have attached the most recent
revision (as of tonight) to this message as well. Comments and votes
are definitely wanted (especially on the "what's the name of the
system" debate described in the proposal). The goal of the initial
proposal is to gather enough support for the idea to have our own CVS
module created to work within, as well as attendant mailing list and
anything else deemed necessary. Not mentioned in the proposal
document at the moment, but important, is the fact that this system
is intended for general use both inside and outside PHP.
-- Gwynne, Daughter of the Code
"This whole world is an asylum for the incurable."
