[brlcad-devel] Atttributes Man Page (attributes.xml)

[Tom B. <tom...@gm...>]

I'm trying to automate much of the attributes documentation and would
like to at least generate the tables for the man page to be identical
to the html page I'm working on for the BRL-CAD site.

I first tried the usual xi:include but that doesn't validate with
refsection and I haven't seen any help on a web search.  I'm going to
ask about the problem on the the DocBook lists, but in he meantime I'm
assuming there's not much hope (man page DocBook xml is sparsely
documented, and I have Bob Stayon's book which is pretty much the word
for such things).

So, what is the best way to cobble the attributes file together via
CMake?  I can see the simplest as separating the current
attributes.xml file into manual and auto-generated pieces:

   attrributes-part-1.xml
   ...
   attrributes-part-N.xml

and let Cliff's magic CMake concatenate the files into attributes.xml
before doing DocBook transformation.

My gen program would auto-generate interspersed parts x, y, etc. from
attribute source data.

Thoughts?

Best regards,

-Tom