If this is fine, then the tagging should be decided on. Seems like we
need to modify docbook anyway we choose, since there is no option we can
choose to not modify docbook and introduce some section levels there.
Hartmut's proposal does not fit the multilevel sections proposed in the
RFC, this is why I suggested using <section> tags. This might however
have some meaning in livedocs, so since we need to modify docbook
anyway, we can identically choose to introduce a new tag, like
<refgroup> or something like this.

The idea of livedocs was that it also works for any other DocBook XML source, so that should not be changed (I use it for such things).

This is another point on the side of adding a new tag, since for other DocBook XML documents, that extra tag handler would not be a problem. However if we overload a tag, and provide it special meaning in our environment, then it would be problematic for general usage. There is no possibilty in stock DocBook we have found so far to provide a multilevel (or even a single level) toc above the reference section.

I have added the tag <refgroup> for this purpose, and provided its DTD fragment too. I have updated the livedocs toc builder to handle this tag too. Since I currently have no livedocs instance set up, I would be interested in how the RFC/manual.xml.in plays with livedocs now.


Goba

Reply via email to