[LLVMdev] Using ReST for documentation

[Mikhail Glushenkov]

> 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