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

From: David Bergman (davidb_at_[hidden])
Date: 2002-11-03 14:00:09

Dave writes (there are too many Davids here ;-):

> As someone with little experience in this area, I have to say I have
no clue what you're driving at. Could you > clarify?

I try to clarify again with a graph (partly stolen from Doug, thanks):

 +---------+                                                  
 | Doxygen |--------+
+---------+
 +---------+        |                                         +----->|
(X)HTML |
                    v                                         |
+---------+
 +----------+    +---------+               +-------------+    |
+-----+    +--------+
 | ReStText |--> | C++ XML |-->(merger)--> | DocBook XML |----+----->|
TeX |--->| PS/PDF |
 +----------+    +---------+     A         +-------------+    |
+-----+    +--------+
                    ^            |                            |
+----+         |
 +----------+       |            |                            +----->|
FO |---------+
 | Synopsis |-------+            |
+----+
 +----------+                    |
                                 |
 +-----------+         +---------+
 | Developer |-------> | C++ XML |
 +-----------+         +---------+

IMEHO, the process needs to support automatic and manual C++ XML
generation with merging into one C++ XML document.

/David