thread-based email index, search, and tagging https://git.notmuchmail.org/git/notmuch/atom?h=release 2021-05-22T19:43:24Z 2021-05-22T19:43:24Z Jani Nikula jani@nikula.org 2021-05-21T20:44:12Z urn:sha1:f2e2f2aa96cb0d40c6fb85cde2ab82380c367485 Use the program and option directives to document the subcommand options. This unifies a lot of option documentation throughout. This also makes it possible to reference options with :option:`--foo` (within .. program::) or :option:`subcommand --foo` (globally). This is left for later work. See https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#directive-program Note: There is a lot of indentation change, but intentionally there is no reflow. Using 'git diff -w' or 'git show -w' to ignore white space changes makes this a very easy change to review. 2021-05-22T19:41:20Z Jani Nikula jani@nikula.org 2021-05-21T20:44:11Z urn:sha1:574b2436eeabf60c930ba227931ee87b0b151a65 Make man1/notmuch.rst the single point of truth for describing notmuch environment variables. Use the envvar directive for that, and reference them with the envvar role. Drive-by cleanup configuration file and hook directory search order documentation. 2021-05-22T19:38:56Z Jani Nikula jani@nikula.org 2021-05-21T20:44:10Z urn:sha1:ff4e81ac57dee5a62f35093c2966f931a7b7580c Add internal hyperlink targets for man pages and cross-reference them using the any role reference. There are a number of alternatives to accomplish this, but this seems like the combination that retains the man page section number and the same boldface style in the man pages. As a bonus, we get sanity checking on the links; for example notmuch-search-terms.rst had a reference to notmuch-properties(1) i.e. the wrong section. The obvious semantic follow-up change would be to only have meaningful "see also" references instead of having them all everywhere. 2017-12-31T13:06:11Z Jani Nikula jani@nikula.org 2017-12-30T17:16:11Z urn:sha1:e5e252de5560fee386bd46f8f279c800b953c667 Make all parameter descriptions etc. use reStructuredText definition lists with uniform style and indentation. Remove redundant indentation from around the lists. Remove blank lines between term lines and definition blocks. Use four spaces for indentation. This is almost completely whitespace and paragraph reflow changes. 2017-10-19T01:36:39Z Daniel Kahn Gillmor dkg@fifthhorseman.net 2017-10-17T16:57:21Z urn:sha1:6499fce3911df2646db67c0f1ff65672324904f0 This will make future diffs cleaner, make it easier to keep them alphabetical, and make it easier to scan and search the documentation sources. 2014-03-09T13:41:08Z David Bremner david@tethera.net 2014-01-28T16:12:37Z urn:sha1:d736260385a689b5c77d8121f48e29440e3adfa4 This is the output from sphinx-quickstart, massaged a bit, along with our existing man pages converted to rst. A skeleton notmuch-emacs manual is also included. It is not suitable for end user use yet.