llvm dev - Dec 2008 - [LLVMdev] Using ReST for documentation

> Can you compare ReST to docbook? We've talked about using docbook for  
> a long time. What are the pros and cons of each?
I have no experience with DocBook, but it seems that since it is XML-based it
should also suffer from verbosity issues. For example, the Boost project, which
originally used plain DocBook, decided to build a new ReST-like documentation
format[1] on top of it.

[1] http://www.boost.org/doc/libs/1_37_0/doc/html/quickbook.html

I have to give a vote for Boosts QuickBook as well.  Nicely made
system with a few code related features (considering it is used for
documenting C++ libraries).

On Wednesday 10 December 2008 00:33, OvermindDL1 wrote:
> I have to give a vote for Boosts QuickBook as well.  Nicely made
> system with a few code related features (considering it is used for
> documenting C++ libraries).
Quickbook is very cool.  The last time I tried it it was extremely hard to use 
outside the Boost environment.  This was over a year ago and at the time
there was discussion about amking it an indepoendent tool.  I don't know
what state it's in.

The really cool thing about Quickbook is the doxygen integration.  Quickbook
converts to BoostBook, which is an extension of DocBook that includes tags
for making API manuals and such.

                                               -Dave