Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-09-27 15:02:43

on Mon Sep 26 2011, Mateusz Loskot <> wrote:

> Hi,
> I'm wondering if there is anything available, discussed or planned
> regarding integration of the Sphinx [1] documentation generator.
> Sphinx evolved as mainly used by the Python world, but AFAIS it has been
> quickly spreading to other camps, C and C++ included.
> In fact, Sphinx has not only become popular as documentation generator
> but also as tool to maintain project websites where majority of the
> content is fairly static and no need for real CMS.
> Plain text files with source of content and cronjob do the job well.
> I have found two references in boost-docs archives, [2] and [3],
> but without in-depth discussion about pros and cons of
> integrating Sphinx into the Boost documentation toolset/workflow.
> Has anyone considered it?
> Would it be valid to discuss Sphinx for Boost?
> [1]
> [2]
> [3]

Sure, it's valid. We already use ReST for several documents. However,
I don't think we should get deeply into a discussion about expanding the
standard tools without addressing the problem of simplifying the overall
process and integrating the already-very-popular formats we have
(e.g. QuickBook, doxygen, ...)

Dave Abrahams
BoostPro Computing

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC