Re: "waldschrotts guide to nifty references" - manualpage draft, version 0.9b

> I don't think tutorials really should be there. Manual takes 5-10 minutes > to compile even now, and adding tutorials here will make it > unmaintainable. Why just not to make another book and call it PHP > Tutorials or whatever? Why it must be one book that does all? I just > imagined that all my Perl books suddently became one, and believe me, this > is a frightening thought... We better don't do that. This makes absolutely no sense. What is a book? We have a bunch of XML files and some rules to build human-readable docs from them. It is trivial to build a subset. If you only wish to generate the function reference, then you only generate the function reference. Splitting this stuff up into multiple build trees is what would make it unmaintainable. We would have to propogate changes from one DSSSL framework to another. And if somebody is dead set against putting non-reference docs near the reference docs, then it is a minor tweak in the makefile. We have a powerful DSSSL framework for maintaining and generating documentation. I see no reason to place artificial limits on it. -Rasmus