Merge pull request #705 from kuba/manpages

Add basic manpages for all binaries (fixes #700).

docs/conf.py

@@ -54,6 +54,7 @@ extensions = [
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
     'repoze.sphinx.autointerface',
+    'sphinxcontrib.programoutput',
 ]
 
 autodoc_member_order = 'bysource'
@@ -283,7 +284,12 @@ latex_documents = [
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('index', 'letsencrypt', u'Let\'s Encrypt Documentation',
-     [u'Let\'s Encrypt Project'], 1)
+     [project], 7),
+    ('man/letsencrypt', 'letsencrypt', u'letsencrypt script documentation',
+     [project], 1),
+    ('man/letsencrypt-renewer', 'letsencrypt-renewer',
+     u'letsencrypt-renewer script documentation', [project], 1),
+    ('man/jws', 'jws', u'jws script documentation', [project], 1),
 ]
 
 # If true, show URL addresses after external links.

docs/man/jws.rst

@@ -0,0 +1 @@
+.. program-output:: jws --help all

docs/man/letsencrypt-renewer.rst

@@ -0,0 +1 @@
+.. program-output:: letsencrypt-renewer --help

docs/man/letsencrypt.rst

@@ -0,0 +1 @@
+.. program-output:: letsencrypt --help all

setup.py

@@ -60,6 +60,7 @@ docs_extras = [
     'repoze.sphinx.autointerface',
     'Sphinx>=1.0',  # autodoc_member_order = 'bysource', autodoc_default_flags
     'sphinx_rtd_theme',
+    'sphinxcontrib-programoutput',
 ]
 
 testing_extras = [