| Age | Commit message (Collapse) | Author |
|
Add keys to index. Allow indexing of both keys and commands. Use
standard typesetting for multiple keybindings.
|
|
Mainly this allows dropping the ad-hoc directive emacsvar
|
|
This allows us to eliminate the ad-hoc emacscmd directive / role, and
improve indexing.
doc/emacs: convert remaining uses of emacscmd to define-key
This allows us to remove the no-longer used object type.
|
|
A more verbose category is needed for the index, but not the
description in the manual.
|
|
This makes the generate info files somewhat less verbose, so that they
say e.g. "Key Binding" instead of "Emacs Key Binding"
|
|
In the notmuch doc index it is important to be clear which parts are
Emacs related.
|
|
This corresponds to flycheck commit
1702d2db3d8ba9bcb9b2bf810e791e907fcc3adc, which is apparently the last
time this file was modified (2018).
Embedding seems defensible since the file is evidently not changing
that much, and we need to change some labels to make it fit with the
not-just-emacs nature of notmuch docs.
|
|
This is mainly motivated by the new emacs-UI features to select
duplicates, but hopefully it will help demystify things for users of
the CLI as well.
|
|
When adding the description of the propagation of NOTMUCH_CONFIG, I
missed that there was already a section on external commands, with a
different title.
|
|
The main change is actually updating cross references.
|
|
This example is based on one originally by Jon Hurst.
|
|
When the ability to use functions was added, this example was confined
to a commit message, which is not user discoverable.
|
|
We want the reply used to match that shown e.g. in the emacs
interface. As a first step provide that functionality on the command
line.
Schema does not need updating as the duplicate key was already
present (with a constant value of 1).
|
|
Add command line argument --duplicate, analogous with that already
supported for notmuch-search.
Use of a seperate function for _get_filename is mainly a form of
documentation at this point.
md5sum is of course a weak hash, but it is good enough for
this (non-adversarial) test suite use.
|
|
Answering a user question, I had to dig for this variable, but I think
it is a reasonably common customization wish, particularly for users
with custom count-functions.
|
|
This makes it easier to navigate the merged index of all of the
notmuch documentation.
|
|
This currently seems unhelpful, and not generating it removes if from
the navigation bar, which prevents mis-clicking.
|
|
There is only one module listed, so the index is not useful.
|
|
This makes the HTML TOC read more naturally. Add a label to make cross
referencing easier.
|
|
This mainly affects the html output (although users generating epub or
pdf would also notice a change). The goal is twofold: make the TOC a
bit friendler and easier to navigate by introducing some hierarchy,
and allow links for nmbug and notmuch-setup.
|
|
Commit 306b7028d added the nmconfig role / directive. Unfortunately
the default of using the directive name in texinfo output is pretty
ugly, so attempt to make it more human readable by passing `objname`
to add_object_type invocation.
|
|
Most of the information is already in the docstrings, but hopefully
by grouping it is more discoverable.
|
|
Analogous to notmuch-show-depth-limit, it requires a bit more
calculation, but that cost seems dominated by the rendering cost.
|
|
This parameter was originally introduced to hide large attachements
that happened to be text/plain. From a performance point of view,
there is no reason not to also hide large message bodies.
|
|
This leverages the machinery already there to insert buttons for
attachments.
A potential use-case is browsing the top layers of the tree to decide
which of the lower subtrees to read.
|
|
This is primarily intended to support testing upward compatibility
with legacy repos.
|
|
The original nmbug format (now called version 0) creates 1
subdirectory of 'tags/' per message. This causes problems for more
than (roughly) 100k messages.
Version 1 introduces 2 layers of hashed directories. This scheme was
chose to balance the number of subdirectories with the number of extra
directories (and git objects) created via hashing.
This should be upward compatible in the sense that old repositories
will continue to work with the updated notmuch-git.
|
|
Previously only man page aliases were being added as symlinks. The
addition to man_pages in conf.py automatically propagates to the list
of generated info pages.
Installation of the new pages is handled by existing recipes.
|
|
Give examples for date fields, as these are commonly useful for user
queries.
|
|
Commits or checkouts that modify a large fraction of the messages in
the database should be relatively rare (and in some automated process,
probably non-existent). For initial setup, where such operations are
expected, the user can pass --force.
|
|
This is probably more convenient than always passing a command line
argument.
Use notmuch-config for consistency with other notmuch CLI tools.
Now that there is something relevant in the config files, test the
--config option.
|
|
The previous defaults were not suitable for personal (i.e. not
bugtracking for notmuch development) use.
Provide two ways for the user to select nmbug compatible defaults;
command line argument and checking the name of the script.
|
|
This is mainly derived from the various help outputs from the script,
with some massaging of markup and addition of links.
|
|
notmuch-mua functions for replies now use the built-in customizable
variable message-dont-reply-to-names with the same semantics as
message-mode.
|
|
Create a section of the notmuch(1) manpage to have some place to put
this documentation.
|
|
A user asked about the thousands separator on IRC, and I had to check
the source.
|
|
This variable is important for people who want to change the default
behaviour when displaying multipart/alternative messages. Previously
it was undocumented. Add a defcustom to help users and copy some
documentation from the wiki. The usual machinery of re-using
docstrings is a bit tricky to use here because it mangles the example
lisp code, and the link to the info node should not be in e.g. the
html page.
Add a simple test to make sure the switch from defvar to defcustom did
not break something obvious.
|
|
This makes sure each configuration item is cross referenceable without
extra markup, and also adds index entries.
|
|
Recently there was a question on the mailing list about the existence
of this function, so let us try to make it more discoverable.
|
|
Most, but not all of the the explanatory texts already end in
'.'. This makes the remainder match.
|
|
Update the explanatory text to match the query.
|
|
This prevents sphinx-doc from creating spurious mailto: links. Thanks
to Jakub Wilk for telling me about the fix.
|
|
This is analogous to the "infix" prefix provided by the s-expression
based query parser.
|
|
Since Xapian does not preserve quotes when passing the subquery to a
field processor, we have to make a guess as to what the user
intended. Here the added assumption is that a string surrounded by
parens is not intended to be a phrase.
|
|
This messes up whitespace, which will require a global change to fix.
|
|
Keybindings are deferred to a future commit.
|
|
If nothing else it means the mode is discoverable by browsing the
documentation, and also provides a target for links when enumerating
modes.
|
|
The tradeoff is no bold/italic in the man pages to get actual
hyperlinks in the html output.
|
|
This is partially redudant given some existing cross references, but
it is useful to have all of the config keys listed in one place, to
help keep track of them if nothing else.
|
|
Increase discoverability.
|