If this is done, it should also be applied to many other sections in the PHP manual as that behavior is used all throughout the manual. In just the installation docs alone, it's like this for every chapter (Unix, Windows, and OS X) so if done all of them should be edited too. And, eventually applied to other parts of the manual. A big decision. It would have to be case-by-case
otherwise a lot of introductions would need written. For example
the control structures section has if() docs in the intro, is this
good? Bad? I don't know.
That said, I like the idea as it's often bugged me too. For example
the Windows installation docs should not include the "installer" section within the Introduction. That's just plain wrong!
Regarding the patch itself, how about making the title read Introduction instead of Intro.
Our stylesheets are configured(?) to emit the first sections on the same page as the TOC. This is why the gentoo stuff ended up on the same page as the TOC, and the others alike. I think I remember there should be a DSSSL/XSLT parameter to set this behaviour, but was unable to find out what parameter it is. Here is the param documentation:
http://docbook.sf.net/release/dsssl/current/doc/html/index.html
Goba
