Re: Sphinx integration

Dave Abrahams <[email protected]>
Newsgroups gmane.comp.lib.boost.documentation
Message-ID <[email protected]>
Whoa, re-reading the below, everywhere I wrote "docbook" it should have
been "docutils," a.k.a. ReStructuredText.  Man, I'm sure that was
confusing.

on Tue Sep 27 2011, Dave Abrahams <dave-AT-boostpro.com> wrote:

> The differences run deep.  If it was a totally clear cut win for ReST,
> I'd have pushed for its exclusive adoption years ago.
>
> - quickbook is an extensible programming language; ReST is explicitly
>   trying *not* to be programmable
>
> - quickbook generates boostbook, which can represent rich semantic
>   information.  ReST can't very cleanly express arbitrary semantic or
>   visual markup (bold-italic anyone?)
>
> - quickbook is maintained by Boosters when they have the time, docbook
>   is maintained externally
>
> - quickbook takes a long time to compile, docbook is Python
>
> - quickbook is not really used outside of Boost; docbook is used by
>   manymanymany
>
> - there's no usable Emacs editing mode for quickbook; there is for ReST.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.