Option to include man pages in documentation
authorMichael Hanselmann <hansmi@google.com>
Wed, 9 Jan 2013 11:10:57 +0000 (12:10 +0100)
committerMichael Hanselmann <hansmi@google.com>
Tue, 15 Jan 2013 14:24:53 +0000 (15:24 +0100)
commit41806ef480590e05b337694719cf083faee1a0f8
treeeb53c90744dde2fc4383de491613adc34c3cf8c5
parent6d675203f6dd9180fd667253bf1f681e6b08911c
Option to include man pages in documentation

Before this patch, HTML versions of man pages (man/*.rst) were already
built. However, since they are separate from the normal documentation,
their content is not indexed for Sphinx' search functionality.
Additionally it would simply be nice to have everything in one place.

To this end a new configure-time option is added to enable the inclusion
of man pages into the documentation. A dedicated option is necessary to
still be able to provide a static documentation build in the tarball
(not including man pages) as man pages contain build-specific paths and
values. The documentation with man pages is written to the directory
“doc/man-html”.

A future patch will extend Sphinx to link occurences of “:manpage:`…`”
to these man pages.

Signed-off-by: Michael Hanselmann <hansmi@google.com>
Reviewed-by: Guido Trotter <ultrotter@google.com>
.gitignore
Makefile.am
NEWS
autotools/run-in-tempdir
autotools/sphinx-wrapper [new file with mode: 0755]
configure.ac
doc/conf.py
doc/index.rst
doc/manpages-disabled.rst [new file with mode: 0644]