[RFC Patch] start of sphinx based docs

Tomi Ollila tomi.ollila at iki.fi
Sun Jan 19 05:48:45 PST 2014


On Sat, Jan 18 2014, David Bremner <david at tethera.net> wrote:

> ---
>
> here is quick and dirty start a sphinx based docs.
> This has the advantage that everything is in rst, no mixed formats.
>
> things you might try, after installing sphinx (only tested with 1.2)
>
> % make -C doc man
>
> % make -C doc info
>
> % man -l doc/_build/man/notmuch-search.1
>
> % info -f doc/_build/texinfo/notmuch-emacs.info

This looks like a good plan, only Makefile & conf.py is a bit noisy
(like Jani's original Doxyfile)

Also;
centos 6$ sudo yum install python-sphinx
...
Downloading Packages:
(1/5): python-babel-0.9.4-5.1.el6.noarch.rpm             | 1.4 MB     00:07    
(2/5): python-jinja2-2.2.1-1.el6.x86_64.rpm              | 464 kB     00:02    
(3/5): python-pygments-1.1.1-1.el6.noarch.rpm            | 561 kB     00:02    
(4/5): python-setuptools-0.6.10-3.el6.noarch.rpm         | 335 kB     00:01    
(5/5): python-sphinx-0.6.6-2.el6.noarch.rpm              | 486 kB     00:02  
---------------------------------------------------------------------------
Total                                           200 kB/s | 3.2 MB     00:16

(python-docutils were already installed)
I wonder how hard it is to install these on some systems...

>
>  doc/Makefile                 | 177 ++++++++++++++++++++++++++++
>  doc/conf.py                  | 272 +++++++++++++++++++++++++++++++++++++++++++
>  doc/index.rst                |  24 ++++
>  doc/notmuch-emacs.rst        | 188 ++++++++++++++++++++++++++++++
>  doc/notmuch-search-terms.rst | 255 ++++++++++++++++++++++++++++++++++++++++
>  doc/notmuch-search.rst       | 203 ++++++++++++++++++++++++++++++++
>  doc/notmuch.rst              | 173 +++++++++++++++++++++++++++
>  7 files changed, 1292 insertions(+)
>  create mode 100644 doc/Makefile
>  create mode 100644 doc/conf.py
>  create mode 100644 doc/index.rst
>  create mode 100644 doc/notmuch-emacs.rst
>  create mode 100644 doc/notmuch-search-terms.rst
>  create mode 100644 doc/notmuch-search.rst
>  create mode 100644 doc/notmuch.rst
>


More information about the notmuch mailing list