thread-based email index, search, and tagging https://git.notmuchmail.org/git/notmuch/atom?h=master 2021-10-25T11:25:22Z 2021-10-25T11:25:22Z David Bremner david@tethera.net 2021-10-11T12:56:14Z urn:sha1:00fdf10937a3ef0292424fb67208b74c753b35fd Sphinx-doc already formats the terms appropriately for a given backend (bold in html and man). `makeinfo` complains noisily about formatting inside a @item if we add our own explicit formatting. This change may change the formatting in the info output. On the other hand, the existing use of quotes for bold is not that great anyway. In some places blank lines were removed to preserve the logical structure of a definition list. 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: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. 2021-05-22T12:56:52Z Jani Nikula jani@nikula.org 2021-05-21T20:44:09Z urn:sha1:3baa61e0e58402bc50c5df529fcf669bf4b2facb Using manpage role references generates helpful links in html documentation, while retaining the same boldface style in the man pages. The external man page site is configurable. The Debian manpage site seems like a good fit for Notmuch. 2018-06-25T00:59:37Z Daniel Kahn Gillmor dkg@fifthhorseman.net 2018-06-19T22:36:16Z urn:sha1:fd3c93650d976f630ba0a60341a1a695422e4969 Many of the manpages didn't treat literal text as literal text. I've tried to normalize some of the restructured text to make it a bit more regular. several of the synopsis lines are still untouched by this cleanup, but i'm not sure what the right way to represent those is in .rst, actually. In particular find that if i rebuild the manpages, sometimes i end up with some of the synopsis lines showing – (U+2013 EN DASH) where they should have -- (2 × U+002D HYPHEN-MINUS) in the generated nroff output, though i have not tracked down the source of this error yet. 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-21T22:52:55Z Daniel Kahn Gillmor dkg@fifthhorseman.net 2017-10-21T02:25:39Z urn:sha1:6575b7eb31a710c8215be698d5cf31be20d4356e We will want a user-facing place to record details about the use of notmuch properties shortly. This establishes a new manual page for that purpose. 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. 2017-10-19T01:36:09Z Daniel Kahn Gillmor dkg@fifthhorseman.net 2017-10-17T16:57:20Z urn:sha1:5fb0f5f113e7cb7422fb44bb7abcba2bcadfc0c8 2017-04-01T12:10:15Z David Bremner david@tethera.net 2017-03-31T10:55:17Z urn:sha1:d47e18411807b57cac9aaa29a7435a9f83720b81 No changes to the format of the body, but the header format was fixed, and version 2 headers probably shouldn't be relied on.