Re: [boost] Re: Reference documentation: one approach

From: Douglas Gregor (gregod_at_[hidden])
Date: 2002-11-02 10:17:15

On Saturday 02 November 2002 01:10 am, David Bergman wrote:
> I do believe that this CPPXML of yours should be a proper extension of
> DocBook, in the sense of super-language, so all DocBook documents are
> valid CPPXML documents. This to enable developers writing the high-level
> specifications, which cannot/should not be extractable from the source
> code in DocBook, and use the CPPXML extensions to express C++-specific
> constructions and still use the same transformer XSL (the arch between
> your "C++ XML" and "DocBook XML" nodes) as the generated documentation.
>
> So, we should extend DocBook, *but* with your preprocessing XSLs, so we
> can still enjoy the DocBook stylesheets and tools from the next node.

The only thing we lose here is the ability to use DSSSL-based DocBook 
renderers, but I'm not sure that matters much. We'll make it a full DocBook 
extension, then.

        Doug