From 5991eae60b7f2de6c3377298a0ba7c2df33e02cd Mon Sep 17 00:00:00 2001 From: inwit Date: Mon, 4 Sep 2023 17:04:09 +0200 Subject: doc: clarify notmuch+maildir behavior with respect to files While notmuch mainly deals with messages and queries, adding either of *maildir-store* or *maidlir-account-path* will give the impression that aerc actually deals with files and folders under the notmuch interface. Clarify this point to avoid confusions. Signed-Off-By: inwit Acked-by: Robin Jarry --- doc/aerc-notmuch.5.scd | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/doc/aerc-notmuch.5.scd b/doc/aerc-notmuch.5.scd index b3d6ee89..6837f720 100644 --- a/doc/aerc-notmuch.5.scd +++ b/doc/aerc-notmuch.5.scd @@ -63,14 +63,20 @@ options are available: *maildir-store* = __ Path to the maildir store containing the message files backing the notmuch database. This is often the same as the notmuch database path. - This is optional. If specified, it will be used by aerc to list - available folders and enable commands such as *:delete* and *:archive*. + If specified, this option will be used by aerc to list available folders + and enable commands such as *:delete* and *:archive*. + + N.B.: aerc will still always show messages and not files (under notmuch, + a single message can be represented by several files), which makes the + semantics of certain commands as *move* ambiguous: for example, if you + try to move a message represented by several files, aerc will not know + what to do and thus refuse. *maildir-account-path* = __ Path to the maildir account relative to the *maildir-store*. This could be used to achieve traditional maildir one tab per account - behavior. + behavior. The note on *maildir-store* also applies to this option. # USAGE -- cgit