Re: [boost] [Boost-docs] Maintaining boost.org

Subject: Re: [boost] [Boost-docs] Maintaining boost.org
From: David Abrahams (dave_at_[hidden])
Date: 2010-05-25 12:28:30

At Tue, 25 May 2010 10:01:12 -0400,
Stefan Seefeld wrote:
> 
> On 05/25/2010 09:54 AM, Joel Falcou wrote:
> > Dean Michael Berris wrote:
> >> Yup, but if Python was preferred I'd think Sphinx would be a better
> >> solution for documentation.
> >
> > I'm all up for using Sphinx as a doc generator for boost.
> > I think Troy Strashzeim has a spiffy boost-like template written in 
> > Sphinx.
> 
> With CLang now supporting Boost, I have plans to hook Synopsis up with 
> it (http://synopsis.fresco.org), to improve its API documentation 
> capabilities. 

Awesome; that'd be great.

> Synopsis supports ReST - formatted inline docs, and thus 
> would blend nicely with Sphinx.

Yup.

> (And I agree, Sphinx is a great tool. I have been using it in a
> number of places to generate entire websites.)

Yup.

http://ryppl.org is a sphinx site, FWIW.

-- 
Dave Abrahams           Meet me at BoostCon: http://www.boostcon.com
BoostPro Computing
http://www.boostpro.com