]> git.cworth.org Git - notmuch/log
4 weeks agolib/notmuch: update example master
Kevin Boulain [Mon, 27 Feb 2023 12:06:29 +0000 (13:06 +0100)]
lib/notmuch: update example

Likely missed in 86cbd215e, when notmuch_query_search_messages_st was
renamed to notmuch_query_search_messages.

4 weeks agoemacs/tree: use two argument form of setq-local
David Bremner [Tue, 21 Feb 2023 11:49:15 +0000 (07:49 -0400)]
emacs/tree: use two argument form of setq-local

Apparently the macro setq-local only takes two arguments in Emacs 26.1

5 weeks agolib: add better diagnostics for over long filenames.
David Bremner [Tue, 27 Dec 2022 17:08:47 +0000 (13:08 -0400)]
lib: add better diagnostics for over long filenames.

Previously we just crashed with an internal error. With this change,
the caller can handle it better. Update notmuch-new so that it doesn't
crash with "unknown error code" because of this change.

5 weeks agotest: add known broken test for diagnostics from over long filenames.
David Bremner [Tue, 27 Dec 2022 17:08:46 +0000 (13:08 -0400)]
test: add known broken test for diagnostics from over long filenames.

Previously we tested over long directory names, add similar testing
for over long filenames.

5 weeks agoemacs: notmuch-tree-outline-mode
jao [Tue, 13 Dec 2022 02:15:42 +0000 (02:15 +0000)]
emacs: notmuch-tree-outline-mode

With this mode, one can fold trees in the notmuch-tree buffer as if
they were outlines, using all the commands provided by
outline-minor-mode.  We also define a couple of movement commands
that, optional, will ensure that only the thread around point is

The implementation is based on registering a :level property in the
messages p-list, that is then used by outline-minor-mode to to
recognise headers.

Amended by db: Copy docstring to manual and edit for presentation. Add
two tests. Fix typo "wether".

2 months agoconfigure: use pkg-config for gpgme
Daniel Kahn Gillmor [Wed, 2 Nov 2022 16:15:12 +0000 (12:15 -0400)]
configure: use pkg-config for gpgme

GnuPG upstream has supported pkg-config since gpgme version 1.13 and
gpg-error 1.33, and now prefers the use of pkg-config by default,
instead of relying on gpg-error-config and gpgme-config.

As of libgpg-error 1.46, upstream deliberately does not ship
gpg-error-config by default.  As of gpgme 1.18.0, upstream does not
ship gpgme-config if gpg-error-config is also not present.

Both of these versions of upstream libraries are in debian unstable
now.  To the extent that notmuch is dependent on GnuPG, it should
follow GnuPG upstream's lead.

Signed-off-by: Daniel Kahn Gillmor <dkg@fifthhorseman.net>
2 months agotest: mark some tests as broken when run as root.
David Bremner [Wed, 4 Jan 2023 12:41:42 +0000 (08:41 -0400)]
test: mark some tests as broken when run as root.

File permission errors e.g., are hard to trigger as root.

2 months agolib/message: move xapian call inside try/catch block in _n_m_delete
David Bremner [Sun, 4 Dec 2022 02:28:57 +0000 (22:28 -0400)]
lib/message: move xapian call inside try/catch block in _n_m_delete

The call to delete_document can throw exceptions (and can happen in
practice [1]), so catch the exception and extract the error
message. As a side effect, also move the call to _n_m_has_term inside
the try/catch. This should not change anything as that function
already traps any Xapian exceptions.

[1]: id:wwuk039sk2p.fsf@chaotikum.eu

2 months agotest: add known broken test for exception handling in _n_m_delete
David Bremner [Sun, 4 Dec 2022 02:28:56 +0000 (22:28 -0400)]
test: add known broken test for exception handling in _n_m_delete

In [1], Thomas Schneider reported an uncaught Xapian exception when
running out of disk space. We generate the same exception via database

[1]: id:wwuk039sk2p.fsf@chaotikum.eu

2 months agolib/database: propagate status code from _notmuch_message_delete
David Bremner [Sun, 4 Dec 2022 02:28:55 +0000 (22:28 -0400)]
lib/database: propagate status code from _notmuch_message_delete

_notmuch_message_delete can return (at least)
NOTMUCH_STATUS_XAPIAN_EXCEPTION, which we should not ignore.

2 months agoCLI/git: use --exclude=false when calling notmuch-search
David Bremner [Sun, 16 Oct 2022 12:49:00 +0000 (09:49 -0300)]
CLI/git: use --exclude=false when calling notmuch-search

We use notmuch search in two places in notmuch-git.py: to find which
tags have a given prefix, and to see if message with given id exists
locally. In both cases we do not want the presence of exclude tags
(e.g. deleted) to change the results.

3 months agodoc: mark `--output=summary` as default
Michael J Gruber [Wed, 30 Nov 2022 13:58:34 +0000 (14:58 +0100)]
doc: mark `--output=summary` as default

`notmuch search` behaves differently depending on the output option: It
either outputs information pertaining to all threads with matching
messages (summary, threads) or to all matching messages (messages,
files, tags). The man page refres solely to the former in the main

Help the user by clearly marking `summary` as the default output option.

Signed-off-by: Michael J Gruber <git@grubix.eu>
4 months agoemacs/show: use n-s-i-headerline to update tags
David Bremner [Fri, 11 Nov 2022 21:48:31 +0000 (16:48 -0500)]
emacs/show: use n-s-i-headerline to update tags

Although this has more steps than the previous regular expression
search and replace, it should be more robust against changes in the
headerline format, such as the inclusion of duplicate numbers (which
broke the previous version).

4 months agoemacs/show: add optional orig-tags argument to n-s-i-headerline
David Bremner [Fri, 11 Nov 2022 21:48:30 +0000 (16:48 -0500)]
emacs/show: add optional orig-tags argument to n-s-i-headerline

This will support use of this function in notmuch-show-update-tags.

4 months agoemacs/show: use plist to pass message info to n-s-insert-headerline
David Bremner [Fri, 11 Nov 2022 21:48:29 +0000 (16:48 -0500)]
emacs/show: use plist to pass message info to n-s-insert-headerline

This should allow calling notmuch-show-insert-headerline from other
places without duplicating the set of plist accesses.

4 months agoemacs: move From header addition to after header intern
Russell Sim [Tue, 20 Sep 2022 20:18:03 +0000 (22:18 +0200)]
emacs: move From header addition to after header intern

OTHER-HEADERS are expected to be passed as strings, to match the
implementation of `compose-mail'.  But the "From" header is currently
expected to be passed as a symbol.  Instead the "From" header can be
safely added after converting all the headers to symbols.

4 months agocli: add options --offset and --limit to notmuch show
Robin Jarry [Tue, 18 Oct 2022 19:41:58 +0000 (21:41 +0200)]
cli: add options --offset and --limit to notmuch show

notmuch search does not output header values. However, when browsing
through a large email corpus, it can be time saving to be able to
paginate without running notmuch show for each message/thread.

Add --offset and --limit options to notmuch show. This is inspired from
commit 796b629c3b82 ("cli: add options --offset and --limit to notmuch

Update man page, shell completion and add a test case to ensure it works
as expected.

Cc: Tim Culverhouse <tim@timculverhouse.com>
Cc: Tomi Ollila <tomi.ollila@iki.fi>
Signed-off-by: Robin Jarry <robin@jarry.cc>
4 months agoemacs: fix dangling overlays in notmuch-search
Matt Armstrong [Thu, 13 Oct 2022 03:20:38 +0000 (20:20 -0700)]
emacs: fix dangling overlays in notmuch-search

notmuch-search-insert-authors now sets the evaporate property on the
ellipsis overlays.  Emacs will delete them when the buffer contents
are zeroed out, which happens with `notmuch-refresh-buffer`.  This
prevents them from being collapsed to zero-width overlays in position
1.  See Emacs bug#58479.  An upcoming change in Emacs will make these
dangling overlays visible to the user.

5 months agonmweb: Fix spacing around punctuation in headers nmweb
Jakub Wilk [Tue, 11 Oct 2022 08:19:44 +0000 (10:19 +0200)]
nmweb: Fix spacing around punctuation in headers

6 months agoemacs: add notmuch-search-edit-search and notmuch-tree-edit-search
Tomi Ollila [Sun, 18 Sep 2022 13:05:50 +0000 (16:05 +0300)]
emacs: add notmuch-search-edit-search and notmuch-tree-edit-search

...and bind these to "E" in their respective keymaps.

Expected to be called interactively, then using read-from-minibuffer
with current search string as initial contents for editing.
(Noninteractive use makes little sense, but is supported.)

With this one can expand (as an opposite to limit) their
query and have e.g. (some of their) saved searches as search

While at it, removed `(defvar notmuch-search-query-string)` from
notmuch-tree.el; it is unused (`notmuch-tree-basic-query` is used

Thanks to Jose Antonio Ortega Ruiz for his example for notmuch-tree
code, and better interactive use.

6 months agonmweb: escape subject in search view
David Bremner [Mon, 5 Sep 2022 11:03:39 +0000 (08:03 -0300)]
nmweb: escape subject in search view

Fix a bug reported by Jakub Wilk [1].

[1]: id:20220822064717.qftn4tr7cs4r2ian@jwilk.net

6 months agotest: replace aging OpenPGP key used in the test suite
Justus Winter [Thu, 22 Sep 2022 08:46:06 +0000 (10:46 +0200)]
test: replace aging OpenPGP key used in the test suite

This replaces the old OpenPGPv4 key that is used in the test suite
with a more modern OpenPGPv4 key.  All cryptographic artifacts in the
test suite are updated accordingly.

Having old cryptographic artifacts in the test suite presents a
problem once the old algorithms are rejected by contemporary

For reference, this is the old key.

  sec   rsa1024 2011-02-05 [SC]
  uid           [ unknown] Notmuch Test Suite <test_suite@notmuchmail.org> (INSECURE!)
  ssb   rsa1024 2011-02-05 [E]

And this is the new key.  Note that is has the same shape, but uses
Ed25519 and Cv25519 instead of 1024-bit RSA.

  sec   ed25519 2022-09-07 [SC]
  uid           [ultimate] Notmuch Test Suite (INSECURE!) <test_suite@notmuchmail.org>
  ssb   cv25519 2022-09-07 [E]

6 months agotest: compute expected keyid from fingerprint
Justus Winter [Fri, 9 Sep 2022 16:12:50 +0000 (18:12 +0200)]
test: compute expected keyid from fingerprint

6 months agotest: add known broken test for indexing text/* attachments
David Bremner [Sat, 20 Aug 2022 18:50:06 +0000 (11:50 -0700)]
test: add known broken test for indexing text/* attachments

The general problem of indexing attachments requires some help to turn
things into text, but (most?) text/* should be doable internally,
possibly with optimizations as for the text/html case.

6 months agotest: rename indexing corpus
David Bremner [Sat, 20 Aug 2022 18:50:05 +0000 (11:50 -0700)]
test: rename indexing corpus

The corpus is not really suitable for general indexing test since the
sole message is ignored (and will most likely continue to be ignored)
by notmuch-new.

6 months agolib: add field processor for lastmod: prefix
David Bremner [Sun, 14 Aug 2022 15:02:59 +0000 (12:02 -0300)]
lib: add field processor for lastmod: prefix

By sharing the existing logic used by the sexp query parser, this
allows negative lastmod revisions to be interpreted as relative to the
most recent revision.

6 months agolib: factor out lastmod range handling from sexp parser.
David Bremner [Sun, 14 Aug 2022 15:02:58 +0000 (12:02 -0300)]
lib: factor out lastmod range handling from sexp parser.

This will permit the re-use of the same logic in the infix query
parser. The location of the shared code in the infix side is for
consistency with the other shared parsing logic. It will make more
sense when a Xapian field processor is added for the lastmod prefix.

6 months agolib/sexp: provide relative lastmod queries
David Bremner [Sun, 14 Aug 2022 15:02:57 +0000 (12:02 -0300)]
lib/sexp: provide relative lastmod queries

Test the relatively trivial logic changes for the sexp query parser
first before refactoring that logic to share with the infix query

6 months agolib/open: create database path in some cases
David Bremner [Fri, 29 Jul 2022 11:31:37 +0000 (08:31 -0300)]
lib/open: create database path in some cases

There is some duplication of code here, but not all of the locations
valid to find a database make sense to create. Furthermore we nead two
passes, so the control flow in _choose_database_path would get a bit

6 months agolib/open: return non-SUCCESS on missing database path
David Bremner [Fri, 29 Jul 2022 11:23:11 +0000 (08:23 -0300)]
lib/open: return non-SUCCESS on missing database path

This simplifies the logic of creating the directory path when it doesn't

6 months agolib/open: refactor call to mkdir into function
David Bremner [Thu, 28 Jul 2022 10:41:02 +0000 (06:41 -0400)]
lib/open: refactor call to mkdir into function

This makes the error handling available for re-use. Using
g_mkdir_with_parents also handles the case of a pre-existing
directory. This introduces new functionality, namely creating the
parent directories, which will be useful for creating directories like

6 months agotest/path-config: set database.mail_root but not database.path
David Bremner [Tue, 26 Jul 2022 01:04:21 +0000 (21:04 -0400)]
test/path-config: set database.mail_root but not database.path

The failing "create database" test replicates a bug reported by Sean
Whitton [1]. The other two failures also look related to the database
being (re)created in the wrong place.

[1]: id:87y1wqkw13.fsf@athena.silentflame.com.

6 months agotest: add test for creating database in various configurations.
David Bremner [Tue, 26 Jul 2022 00:37:41 +0000 (20:37 -0400)]
test: add test for creating database in various configurations.

The existing database creation (via add_email_corpus) was always done
in the traditional configuration. The use of xapian-metadata is just
to portably ensure that there is a database created where we expect
there to be.

6 months agoemacs/show: use read-shell-command instead of read-string
Antoine Beaupré [Tue, 30 Aug 2022 14:17:45 +0000 (10:17 -0400)]
emacs/show: use read-shell-command instead of read-string

This enables auto-completion of commands, something which plain
read-string does not do. It's otherwise a drop-in
replacement. According to `C-h f`, read-shell-command was introduced
in Emacs 23.1 or earlier.

6 months agoemacs: new notmuch-tree-process-exit-functions
jao [Sun, 21 Aug 2022 03:06:18 +0000 (04:06 +0100)]
emacs: new notmuch-tree-process-exit-functions

Hook run when the tree insertion process finishes its job.

This patch supersedes <id:20220816214023.1523322-1-jao@gnu.org>, but
changing the new variable name.

Right now, it can be used for silly things like removing or changing
the the "End of search." hardcoded message in the tree buffer.  But
also for more sophisticated things like folding all threads in add-ons
like my outline mode for tree buffers (to be submitted).

Signed-off-by: jao <jao@gnu.org>
7 months agodebian: update changelog for new build-depends release archive/debian/0.37-1 debian/0.37-1
David Bremner [Wed, 24 Aug 2022 16:12:57 +0000 (09:12 -0700)]
debian: update changelog for new build-depends

7 months agodebian: build-depend on emacs-el
David Bremner [Wed, 24 Aug 2022 16:10:02 +0000 (09:10 -0700)]
debian: build-depend on emacs-el

This is hopefully temporary, to work around some bugs related to emacs
28 in Debian.

7 months agoNEWS: set release date for 0.37 0.37
David Bremner [Sun, 21 Aug 2022 20:17:37 +0000 (13:17 -0700)]
NEWS: set release date for 0.37

7 months agodebian: changelog for 0.37-1
David Bremner [Sun, 21 Aug 2022 20:09:25 +0000 (13:09 -0700)]
debian: changelog for 0.37-1

7 months agoversion: update to 0.37
David Bremner [Sun, 21 Aug 2022 20:05:34 +0000 (13:05 -0700)]
version: update to 0.37

7 months agoNEWS: minimal entries for two emacs changes.
David Bremner [Sun, 21 Aug 2022 20:02:08 +0000 (13:02 -0700)]
NEWS: minimal entries for two emacs changes.

7 months agotest: increase cffi timeout
Michael J Gruber [Sun, 14 Aug 2022 15:22:17 +0000 (17:22 +0200)]
test: increase cffi timeout

By default, the test suite uses 2min for other tests and 5s for cffi
tests. Sporadically, this leads to test failures caused by the timeout
on slower or loaded test infrastructure (as seen on ppc64le in Fedora's
infrastructure during branch time).

Increase the cffi timeout to the same 2m=120s.

Signed-off-by: Michael J Gruber <git@grubix.eu>
7 months agochangelog for 0.37~rc0-3 archive/debian/0.37_rc0-3 debian/0.37_rc0-3
David Bremner [Sun, 14 Aug 2022 14:49:54 +0000 (11:49 -0300)]
changelog for 0.37~rc0-3

7 months agodebian: changelog for 0.37~rc0-2 archive/debian/0.37_rc0-2 debian/0.37_rc0-2
David Bremner [Sun, 14 Aug 2022 13:56:15 +0000 (10:56 -0300)]
debian: changelog for 0.37~rc0-2

7 months agodebian: upload release candidate to experimental, not unstable archive/debian/0.37_rc0-1 debian/0.37_rc0-1
David Bremner [Sun, 14 Aug 2022 10:28:40 +0000 (07:28 -0300)]
debian: upload release candidate to experimental, not unstable

Oops, tagged "upstream" version is incorrect, but it's a minor issue.

7 months agodebian: changelog stanza for 0.37~rc0-1 0.37_rc0
David Bremner [Sun, 14 Aug 2022 09:55:40 +0000 (06:55 -0300)]
debian: changelog stanza for 0.37~rc0-1

7 months agoversion: update to 0.37~rc0
David Bremner [Sun, 14 Aug 2022 09:53:41 +0000 (06:53 -0300)]
version: update to 0.37~rc0

7 months agodoc/emacs: use define-key instead of hard-coding markup
David Bremner [Sun, 31 Jul 2022 11:33:23 +0000 (08:33 -0300)]
doc/emacs: use define-key instead of hard-coding markup

Add keys to index. Allow indexing of both keys and commands. Use
standard typesetting for multiple keybindings.

7 months agodoc/emacs: replace use of emacsvar with el:defcustom
David Bremner [Sun, 31 Jul 2022 11:33:22 +0000 (08:33 -0300)]
doc/emacs: replace use of emacsvar with el:defcustom

Mainly this allows dropping the ad-hoc directive emacsvar

7 months agodoc/emacs: replace emacscmd with el:define-key
David Bremner [Sun, 31 Jul 2022 11:33:21 +0000 (08:33 -0300)]
doc/emacs: replace emacscmd with el:define-key

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.

7 months agodoc/emacs: split index category from label
David Bremner [Sun, 31 Jul 2022 11:33:20 +0000 (08:33 -0300)]
doc/emacs: split index category from label

A more verbose category is needed for the index, but not the
description in the manual.

7 months agodoc/emacs: drop domain label
David Bremner [Sun, 31 Jul 2022 11:33:19 +0000 (08:33 -0300)]
doc/emacs: drop domain label

This makes the generate info files somewhat less verbose, so that they
say e.g. "Key Binding" instead of "Emacs Key Binding"

7 months agodoc/elisp: replace label for Emacs commands and key bindings.
David Bremner [Sun, 31 Jul 2022 11:33:18 +0000 (08:33 -0300)]
doc/elisp: replace label for Emacs commands and key bindings.

In the notmuch doc index it is important to be clear which parts are
Emacs related.

7 months agodoc: copy elisp.py from flycheck, make available
David Bremner [Sun, 31 Jul 2022 11:33:17 +0000 (08:33 -0300)]
doc: copy elisp.py from flycheck, make available

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.

7 months agodoc: add some documentation about duplicate files.
David Bremner [Sat, 30 Jul 2022 23:45:51 +0000 (20:45 -0300)]
doc: add some documentation about duplicate files.

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.

7 months agoemacs: add docstring for notmuch-show-choose-duplicate
David Bremner [Sun, 31 Jul 2022 12:46:51 +0000 (09:46 -0300)]
emacs: add docstring for notmuch-show-choose-duplicate

It should have one in any case, but in particular it is needed for the

7 months agoemacs/show: restrict inlined mimetypes on refresh.
David Bremner [Mon, 1 Aug 2022 11:39:18 +0000 (08:39 -0300)]
emacs/show: restrict inlined mimetypes on refresh.

This fixes the bug reported by Al [1]. Essentially apply the same fix
as [2] in a different place.

[1]: id:877d41nmr1.fsf@gmail.com
[2]: 90a7c1af368a527700dcde9b0dcbd760afc7bd92

7 months agotest/emacs: add known broken test for inlining on refresh.
David Bremner [Mon, 1 Aug 2022 11:39:17 +0000 (08:39 -0300)]
test/emacs: add known broken test for inlining on refresh.

This duplicates the bug reported by Al [1]

[1]: id:877d41nmr1.fsf@gmail.com

7 months agoemacs: add duplicate support to notmuch-show-view-raw-message
David Bremner [Thu, 4 Aug 2022 11:48:08 +0000 (08:48 -0300)]
emacs: add duplicate support to notmuch-show-view-raw-message

This fixes one of the bugs reported by Gregor in [1]

[1]: id:87edxw8jp4.fsf@no.workgroup

7 months agoemacs/show: provide a more friendly function to get duplicate num
David Bremner [Thu, 4 Aug 2022 11:48:07 +0000 (08:48 -0300)]
emacs/show: provide a more friendly function to get duplicate num

There is not much code here, but at least we can fix the indexing as 1

7 months agotest/emacs: add known broken test for viewing raw duplicate
David Bremner [Thu, 4 Aug 2022 11:48:06 +0000 (08:48 -0300)]
test/emacs: add known broken test for viewing raw duplicate

This duplicates one of the bugs reported by Gregor in [1].

[1]: id:87edxw8jp4.fsf@no.workgroup

7 months agoemacs: update notmuch-show-get-filename to handle duplicates
David Bremner [Thu, 4 Aug 2022 11:08:33 +0000 (08:08 -0300)]
emacs: update notmuch-show-get-filename to handle duplicates

This fixes one of the bugs reported by Gregor in [1].

[1]: id:87edxw8jp4.fsf@no.workgroup

7 months agotest/emacs: add known broken test for stashing duplicate filename
David Bremner [Thu, 4 Aug 2022 11:08:32 +0000 (08:08 -0300)]
test/emacs: add known broken test for stashing duplicate filename

This duplicates (no pun intended) one of the bugs reported by Gregor
in id:87edxw8jp4.fsf@no.workgroup

7 months agoNEWS: initial set of NEWS for 0.37.
David Bremner [Mon, 1 Aug 2022 13:14:15 +0000 (10:14 -0300)]
NEWS: initial set of NEWS for 0.37.

There are one or two more changes to apply (and potentially document)
before release, but this covers most of my commits.

7 months agodoc/notmuch: merge two sections on external commands.
David Bremner [Sat, 30 Jul 2022 23:45:49 +0000 (20:45 -0300)]
doc/notmuch: merge two sections on external commands.

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.

7 months agotests: remove dead code from T055-path-config.sh
David Bremner [Fri, 29 Jul 2022 12:19:56 +0000 (09:19 -0300)]
tests: remove dead code from T055-path-config.sh

This case statement does nothing.

7 months agonotmuch.c: add missing trailing newlines in two error messages
Tomi Ollila [Sun, 31 Jul 2022 17:32:11 +0000 (20:32 +0300)]
notmuch.c: add missing trailing newlines in two error messages

Removed duplicate error check (and the message) in 3rd case where
the same error message (w/o trailing newline) was present.

In case of test/T040-setup.sh, command substitution deletes
trailing newlines, so related test there cannot be changed
(and therefore could not notice this user experience flaw).

7 months agodoc/emacs: add docstring for notmuch-unthreaded-result-format.
David Bremner [Sat, 16 Jul 2022 21:22:28 +0000 (17:22 -0400)]
doc/emacs: add docstring for notmuch-unthreaded-result-format.

The main change is actually updating cross references.

7 months agoemacs: update defcustom for notmuch-unthreaded-result-format
David Bremner [Sat, 16 Jul 2022 21:22:27 +0000 (17:22 -0400)]
emacs: update defcustom for notmuch-unthreaded-result-format

This is essentially a copy of that for notmuch-tree-result-format,
aside from the default value.

7 months agodoc/emacs: add docstring and example for n-tree-result-format
David Bremner [Sat, 16 Jul 2022 21:22:26 +0000 (17:22 -0400)]
doc/emacs: add docstring and example for n-tree-result-format

This example is based on one originally by Jon Hurst.

7 months agoemacs: update defcustom for notmuch-search-result-format.
David Bremner [Sat, 16 Jul 2022 21:22:25 +0000 (17:22 -0400)]
emacs: update defcustom for notmuch-search-result-format.

It seems redundant to have the previous example, since the default
value is always show by describe variable.

Enforce more restrictions on the keys in the alist, since arbitrary
strings don't work as field names.

Document that functions can be used in lieu of field names.

7 months agodoc/emacs: add docstring and example for n-search-result-format
David Bremner [Sat, 16 Jul 2022 21:22:24 +0000 (17:22 -0400)]
doc/emacs: add docstring and example for n-search-result-format

When the ability to use functions was added, this example was confined
to a commit message, which is not user discoverable.

7 months agoemacs: update defcustom for notmuch-search-result-format.
David Bremner [Sat, 16 Jul 2022 21:22:23 +0000 (17:22 -0400)]
emacs: update defcustom for notmuch-search-result-format.

It seems redundant to have the previous example, since the default
value is always show by describe variable.

Enforce more restrictions on the keys in the alist, since arbitrary
strings don't work as field names.

Document that functions can be used in lieu of field names.

7 months agoemacs/reply: reply to correct duplicate
David Bremner [Fri, 1 Jul 2022 21:45:48 +0000 (18:45 -0300)]
emacs/reply: reply to correct duplicate

Essentially we just need to arrange to pass the right --duplicate
argument to notmuch reply.

As a side-effect, correct the previously unused value of EXPECTED in

7 months agoCLI/reply: support --duplicate argument
David Bremner [Fri, 1 Jul 2022 21:45:47 +0000 (18:45 -0300)]
CLI/reply: support --duplicate argument

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

Schema does not need updating as the duplicate key was already
present (with a constant value of 1).

7 months agoemacs/show: display count of duplicates in headerline
David Bremner [Fri, 1 Jul 2022 21:45:46 +0000 (18:45 -0300)]
emacs/show: display count of duplicates in headerline

There is no real cost here, except screen real estate. Some people
might prefer hiding the duplicate count, but we leave that for a
future commit.

7 months agoemacs/show: provide notmuch-show-choose-duplicate
David Bremner [Fri, 1 Jul 2022 21:45:45 +0000 (18:45 -0300)]
emacs/show: provide notmuch-show-choose-duplicate

This new command allows the user to interactively choose a different
duplicate (file) to display for a given message in
notmuch-show-mode. Since both tree and unthreaded view use
notmuch-show-mode, this provides the same facility there.

7 months agoCLI/show: support --duplicate for structured output
David Bremner [Fri, 1 Jul 2022 21:45:44 +0000 (18:45 -0300)]
CLI/show: support --duplicate for structured output

This introduces a new mandatory key for message structures, namely
"duplicate". Per convention in devel/schemata this does _not_ increase
the format version. This means that clients are responsible for
checking that it exists, and not crashing if it does not.

The main functional change is teaching mime_node_open to understand a
'duplicate' argument.

Support for --duplicate in notmuch-reply would make sense, but we
defer it to a later commit.

7 months agoCLI/show: initial support for --duplicate for (raw output only)
David Bremner [Fri, 1 Jul 2022 21:45:43 +0000 (18:45 -0300)]
CLI/show: initial support for --duplicate for (raw output only)

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.

8 months agoCLI/git: opportunistically use bindings to check for known messages
David Bremner [Fri, 15 Jul 2022 14:23:21 +0000 (10:23 -0400)]
CLI/git: opportunistically use bindings to check for known messages

If the bindings are installed, use them to avoid one exec of notmuch
search per message.

8 months agoCLI/git: current cache contents of index
David Bremner [Sat, 2 Jul 2022 23:45:11 +0000 (20:45 -0300)]
CLI/git: current cache contents of index

Rather than shelling out once per message to get the list of files
corresponding to tags, it is much faster (although potentially a bit
memory intensive) to read them all at once.

8 months agoperf-test: add tests notmuch-git
David Bremner [Sat, 2 Jul 2022 19:11:58 +0000 (16:11 -0300)]
perf-test: add tests notmuch-git

The main focus of these initial tests is the (currently unacceptably
slow) checkout performance.

8 months agodoc/emacs: add notmuch-show-empty-saved-searches to manual
David Bremner [Fri, 1 Jul 2022 16:14:29 +0000 (13:14 -0300)]
doc/emacs: add notmuch-show-empty-saved-searches to manual

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.

8 months agodoc/emacs: define and use emacsvar and emacscmd markup
David Bremner [Fri, 1 Jul 2022 10:40:39 +0000 (07:40 -0300)]
doc/emacs: define and use emacsvar and emacscmd markup

This makes it easier to navigate the merged index of all of the
notmuch documentation.

8 months agodoc: do not generate python module index
David Bremner [Fri, 1 Jul 2022 10:52:35 +0000 (07:52 -0300)]
doc: do not generate python module index

This currently seems unhelpful, and not generating it removes if from
the navigation bar, which prevents mis-clicking.

8 months agodoc: drop module index from ToC
David Bremner [Fri, 1 Jul 2022 09:52:04 +0000 (06:52 -0300)]
doc: drop module index from ToC

There is only one module listed, so the index is not useful.

8 months agodoc: retitle notmuch-emacs manual
David Bremner [Thu, 30 Jun 2022 12:27:10 +0000 (09:27 -0300)]
doc: retitle notmuch-emacs manual

This makes the HTML TOC read more naturally. Add a label to make cross
referencing easier.

8 months agodoc: reorganize sphinx toctree
David Bremner [Thu, 30 Jun 2022 12:00:43 +0000 (09:00 -0300)]
doc: reorganize sphinx toctree

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.

8 months agodoc: improve config item labels in info output
David Bremner [Fri, 1 Jul 2022 11:23:24 +0000 (08:23 -0300)]
doc: improve config item labels in info output

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.

8 months agodoc/emacs: add discussion about notmuch-show performance.
David Bremner [Tue, 28 Jun 2022 01:02:05 +0000 (22:02 -0300)]
doc/emacs: add discussion about notmuch-show performance.

Most of the information is already in the docstrings, but hopefully
by grouping it is more discoverable.

8 months agoemacs/show: introduce notmuch-show-height-limit
David Bremner [Tue, 28 Jun 2022 01:02:04 +0000 (22:02 -0300)]
emacs/show: introduce notmuch-show-height-limit

Analogous to notmuch-show-depth-limit, it requires a bit more
calculation, but that cost seems dominated by the rendering cost.

8 months agoemacs/show: obey notmuch-show-max-text-part-size for part 0
David Bremner [Tue, 28 Jun 2022 01:02:03 +0000 (22:02 -0300)]
emacs/show: obey notmuch-show-max-text-part-size for part 0

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.

8 months agoemacs/show: optionally insert bodies of "deep messages" lazily
David Bremner [Tue, 28 Jun 2022 01:02:02 +0000 (22:02 -0300)]
emacs/show: optionally insert bodies of "deep messages" lazily

This leverages the machinery already there to insert buttons for

A potential use-case is browsing the top layers of the tree to decide
which of the lower subtrees to read.

8 months agoperf-test/emacs: test showing longish threads
David Bremner [Tue, 28 Jun 2022 01:02:01 +0000 (22:02 -0300)]
perf-test/emacs: test showing longish threads

This particular thread takes about 100 times longer to display in
emacs than on the command line.

The parameter notmuch-show-max-text-part-size exists, but is currently
ineffective for this task because it only hides attachments, not
part 0.

In future commits, the parameter notmuch-show-{depth,height}-limit
will trigger a similar kind of hiding for bodies as
n-s-m-text-part-size already does for attachments.

8 months agodebian: add git as a build-dependency, for the test suite
David Bremner [Sun, 3 Jul 2022 15:11:00 +0000 (12:11 -0300)]
debian: add git as a build-dependency, for the test suite

This is needed to run (and test) notmuch-git.

8 months agoCLI/git: add --format-version argument to init subcommand
David Bremner [Thu, 23 Jun 2022 12:30:45 +0000 (09:30 -0300)]
CLI/git: add --format-version argument to init subcommand

This is primarily intended to support testing upward compatibility
with legacy repos.

8 months agoCL/git: add format version 1
David Bremner [Thu, 23 Jun 2022 12:30:44 +0000 (09:30 -0300)]
CL/git: add format version 1

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.

8 months agoCLI/git: replace most mentions of nmbug
David Bremner [Mon, 4 Jul 2022 15:33:48 +0000 (12:33 -0300)]
CLI/git: replace most mentions of nmbug

Particularly in help messages, nmbug is confusing for users who may
have never heard of it.

8 months agotest: known broken test for top level .notmuch in split configs
David Bremner [Sun, 16 Jan 2022 15:25:10 +0000 (11:25 -0400)]
test: known broken test for top level .notmuch in split configs

In split configurations there is no special significance to a top
level directory called .notmuch in the mail root. Users should
therefore be able to have mail stored underneath it.

8 months agobindings/python-cffi: fix docstring
David Bremner [Sun, 3 Jul 2022 20:26:46 +0000 (17:26 -0300)]
bindings/python-cffi: fix docstring

the method Database.get_message does exist any more (if it ever
did). This makes the docstring unhelpful as an example.