hholzgra Wed Apr 14 20:39:13 2004 EDT
Modified files: /phpdoc/RFC reference_grouping Log:
adding my thoughts on the topic (hartmut)
+<refentry> may not only occur wrapped up in <reference> but also in
+e.g. <chapter> and <section>. So a structure like this is completely
+legal with the current DTD:
+
+...
+<part><title>Function Reference</title>
+ <chapter><title>Standard Functions</title>
+ ...
+ </chapter>
+ <chapter><title>Database Functions</title>
+ <section><title>DB xyz Functions</title>
+ <para>introduction</para>
+ <refentry id="function.xyz-1">
+ ...
+ </refentry>
+ <refentry id="function.xyz-2">
+ ...
+ </refentry>
+ ...
+ </section>
+ </chapter>
+ ...
+</part>
Hatmut, you solved the problem of having deeper sections here, by using <chapter> for the top most sections, and using <section> for the ones below. <section> is used as a container on the extension reference pages, and it does not break pages itself, so the rendering of the above structure with the default style sheet would probably be quite ugly (not tried yet). Otherwise it does not seem to be a bad approach. :)
Goba