summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPatrick Totzke <patricktotzke@gmail.com>2012-01-13 10:32:21 +0000
committerPatrick Totzke <patricktotzke@gmail.com>2012-01-13 10:32:21 +0000
commit1314551eb78dc9a96ee9b6148016faf05ec723ad (patch)
treebe98c9a8777e58b36b16c2abddc2f62184ba1f59 /docs
parent45b5c6fe1a5bd48761fd3c25ecfa5c46baae0dcb (diff)
manpage generation via sphinx
this tunes the "make man" command in docs/user to produce two manual pages, one for section 1 and one for the configuration file (section 5)
Diffstat (limited to 'docs')
-rw-r--r--docs/user/source/conf.py6
-rw-r--r--docs/user/source/manpage.rst19
2 files changed, 23 insertions, 2 deletions
diff --git a/docs/user/source/conf.py b/docs/user/source/conf.py
index b9babda3..134c5aca 100644
--- a/docs/user/source/conf.py
+++ b/docs/user/source/conf.py
@@ -211,8 +211,10 @@ latex_documents = [
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
- ('index', 'alot', u'alot Documentation',
- [u'Patrick Totzke'], 1)
+ ('manpage', 'alot', u'mail user agent for the notmuch mail system',
+ [u'Patrick Totzke'], 1),
+ ('configuration', 'alot.rc', u'CONF',
+ [u'Patrick Totzke'], 5)
]
diff --git a/docs/user/source/manpage.rst b/docs/user/source/manpage.rst
new file mode 100644
index 00000000..009cfbf3
--- /dev/null
+++ b/docs/user/source/manpage.rst
@@ -0,0 +1,19 @@
+.. alot documentation master file, created by
+ sphinx-quickstart on Tue Jan 10 16:45:54 2012.
+ You can adapt this file completely to your liking, but it should at least
+ contain the root `toctree` directive.
+
+Manpage
+=======
+
+Synopsis
+--------
+
+.. include:: usage/synopsis.rst
+
+Description
+-----------
+
+.. include:: description.rst
+
+#.. include:: usage.rst