On Wed, May 18, 2011 at 21:38, Rowland, Larry <[email protected]> wrote: > I frequently do manpages using DocBook for creating them. I find > that knowing how many sections I am nested in is very valuable and > that is what refsect1, refsect2, etc is very valuable for, since > the NROFF that all of them are rendered through in a term window > does not provide coding for headings below a fixed level. We also > have rules about depth of nesting of sections in nodes in help > systems; again, having explicit sect1, sect2 provides very clear > indication of how deeply nested the sections are. > > While I frequently use nested section elements in documents for > which depth of nesting is not an issue, having the flexibility to > know precisely how deeply my sections are nested is important in > some cases. Not everyone doing technical documentation is doing > the same thing. Simplify the schema as much as you want for your > own use, but don't handicap the people who need a richer expression > in the markup.
How deeply your sections are nested is something that your tools ought to be telling you, not something that the schema should have to lay out… Aankhen --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
