Re: [boost] New Getting Started Guide [why use RST?]

From: David Abrahams (dave_at_[hidden])
Date: 2006-12-11 16:32:53

"Robert Ramey" <ramey_at_[hidden]> writes:

> David Abrahams wrote:
>> "Sohail Somani" <s.somani_at_[hidden]> writes:
>
>> Nope, sorry.  I suggest using RestructuredText for consistency with
>> the first document, but that's optional.
>
> I'm know this is a little off topic but I'm really curious as to why you 
> chose RsT rather than quickbook for making this document. 

Lots of reasons: easier installation, I happen to know it really well
since we wrote C++TMP in it, more sensible parsing rules, I have
complete and working emacs syntax coloring (makes a huge difference),
shorter toolchain, a great path to PDFs (please don't say "FOP").

> I've been looking at what's involved in converting the serialization
> documentation but I'm always wary of new stuff.  I'm curious what
> the advantages/disadvantages are and what the experience has been in
> creating pdf files from docbook.

See the boost-docs list; there were posts about that today.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com