X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=doc%2Fconf.py;h=fc9738ff092a72542d1465b0420cf5e6e65f9885;hp=f8da1a422f9a557b258779a8fa1f4cc30b1a141b;hb=bd0b5abd5d6c6fe0c1a028192680f3a505a18ef2;hpb=0097e7f5d688bf7f1ec5a0939ded904926aff699 diff --git a/doc/conf.py b/doc/conf.py index f8da1a42..fc9738ff 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -12,7 +12,7 @@ master_doc = 'index' # General information about the project. project = u'notmuch' -copyright = u'2009-2016, Carl Worth and many others' +copyright = u'2009-2019, Carl Worth and many others' location = os.path.dirname(__file__) @@ -29,6 +29,12 @@ release = version # directories to ignore when looking for source files. exclude_patterns = ['_build'] +# If we don't have emacs (or the user configured --without-emacs), +# don't build the notmuch-emacs docs, as they need emacs to generate +# the docstring include files +if os.environ.get('WITH_EMACS') != '1': + exclude_patterns.append('notmuch-emacs.rst') + # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' @@ -47,6 +53,10 @@ html_static_path = [] # Output file base name for HTML help builder. htmlhelp_basename = 'notmuchdoc' +# Disable SmartyPants, as it mangles command lines. +# Despite the name, this actually affects manual pages as well. +html_use_smartypants = False + # -- Options for manual page output --------------------------------------- # One entry per manual page. List of tuples @@ -95,6 +105,14 @@ man_pages = [ u'incorporate new mail into the notmuch database', [notmuch_authors], 1), + ('man7/notmuch-properties', 'notmuch-properties', + u'notmuch message property conventions and documentation', + [notmuch_authors], 7), + + ('man1/notmuch-reindex', 'notmuch-reindex', + u're-index matching messages', + [notmuch_authors], 1), + ('man1/notmuch-reply', 'notmuch-reply', u'constructs a reply template for a set of messages', [notmuch_authors], 1), @@ -132,7 +150,7 @@ man_pages = [ texinfo_no_detailmenu = True texinfo_documents = [ - ('notmuch-emacs', 'notmuch-emacs', u'notmuch Documentation', + ('notmuch-emacs', 'notmuch-emacs', u'notmuch-emacs documentation', notmuch_authors, 'notmuch-emacs', 'emacs based front-end for notmuch', 'Miscellaneous'), ] @@ -142,7 +160,7 @@ texinfo_documents += [ ( x[0], # source start file x[1], # target name - u'notmuch Documentation', # title + x[1] + u' documentation', # title x[3][0], # author x[1], # dir menu entry x[2], # description