[Scons-users] Sphinx builder

[Saša Janiška]

On Sub, 2016-01-09 at 14:19 +0100, Dirk Bächle wrote:

> the tools index at
> 
>    https://bitbucket.org/scons/scons/wiki/ToolsIndex
> 
> lists two different Sphinx tools, 

Last updates 2001 & 2012.


> and there is also a repo at
> 
>    https://bitbucket.org/russel/scons_sphinx

Last update is also from 2011.

> All these are in a state of "external tool" (meaning that they aren't
> developed and maintained together with the core sources), 
> and integrating them as "standard" extension would require one of the
> repo maintainers to contact the core devs. In addition to 
> expressing his wish for his Sphinx tool to be delivered with the
> default distributions of SCons, he would have to add proper 
> documentation and tests with it.

Btw, I've also read discussion about changing doc toolchain for SCons
itself and seeing you're determined to use DocBook, may I suggest to
consider AsciiDoc(tor) which allows you to convert to DocBook and it is
certainly much easier for authors to write in.

Otoh, it's interesting to note that CMake switched to rst/Sphinx for all
their docs and even provide cmake-domain for Sphinx.


Sincerely,
Gour

-- 
A person who is not disturbed by the incessant flow of 
desires — that enter like rivers into the ocean, which is 
ever being filled but is always still — can alone achieve 
peace, and not the man who strives to satisfy such desires.