RE: DOCBOOK-APPS: "Abbreviated" DocBook

[David Cramer <david_cramer@broadjump.com>]

I haven't played with the feature so I don't know for certain if it
would work for you, but the automatic documentation tool Doxygen has xml
as one of it's output types. You could write an xslt  to convert that
output to whatever you need. 

This is (or perhaps was) the link
<http://www.stack.nl/~dimitri/doxygen/>. It's cold right now. 
http://freshmeat.net/projects/doxygen/ lists http://www.doxygen.org/ as
the homepage, but that's dead too now. Perhaps they're moving or
something--it's a mature tool with a strong community supporting it. 

In other situations I've found it best to write a simple dtd (e.g. one
describing tables and columns in a database) and xsl that to docbook. If
you're careful to avoid naming any elements the same as docbook elements
(with a namespace), then you can include the entire docbook dtd in your
dtd. Its modular design makes it easy to pick and choose what parts you
want.

David

-----Original Message-----
From: Kevin Atkinson [mailto:kevin@atkinson.dhs.org]
Sent: Wednesday, January 09, 2002 10:47 PM
To: docbook-apps@lists.oasis-open.org
Subject: DOCBOOK-APPS: "Abbreviated" DocBook


document becomes rather difficult.  So, I was wondering if there exists
any tools which will allow me to enter in documents in a more terse and
human readable form with the minimal amount of tags and then have it
expand it into full DocBook form with all the special purpose tags in
place. For example I would like to be able to enter this: