diff options
author | Manos Pitsidianakis <el13635@mail.ntua.gr> | 2022-12-04 16:07:32 +0200 |
---|---|---|
committer | Manos Pitsidianakis <el13635@mail.ntua.gr> | 2022-12-09 12:35:10 +0200 |
commit | 7606317f24d076bdc7db873c2b15811728ed946a (patch) | |
tree | 982085d14b22b4de94c646b508f25a0a82a5792d /docs | |
parent | 4f45b109745ebc29febc452b9bcb0cd88f131ffc (diff) | |
download | meli-7606317f24d076bdc7db873c2b15811728ed946a.zip |
melib/notmuch: add support for virtual mailbox hierarchy
Add optional "parent" property to notmuch mailbox configuration.
Closes #167
https://git.meli.delivery/meli/meli/issues/167
Diffstat (limited to 'docs')
-rw-r--r-- | docs/meli.conf.5 | 29 |
1 files changed, 24 insertions, 5 deletions
diff --git a/docs/meli.conf.5 b/docs/meli.conf.5 index 52bba8d3..40d67192 100644 --- a/docs/meli.conf.5 +++ b/docs/meli.conf.5 @@ -187,21 +187,38 @@ Its format is described below in notmuch is supported by loading the dynamic library libnotmuch. If its location is missing from your library paths, you must add it yourself. Alternatively, you can specify its path by using a setting. -.Bl -tag -width 36n -.It Ic root_mailbox -points to the directory which contains the -.Pa .notmuch/ -subdirectory. +.Pp notmuch mailboxes are virtual, since they are defined by user-given notmuch queries. You must explicitly state the mailboxes you want in the .Ic mailboxes field and set the .Ar query property to each of them. +To create a tree hierarchy with virtual mailboxes, define the +.Ar parent +property to a mailbox as the name of the parent mailbox you have used in your configuration. +.Pp +Account properties: +.Bl -tag -width 36n +.It Ic root_mailbox +points to the directory which contains the +.Pa .notmuch/ +subdirectory. .It Ic library_file_path Ar Path Use an arbitrary location of libnotmuch by specifying its full filesystem path. .Pq Em optional .El +Mailbox properties: +.Bl -tag -width 36n +.It Ic query Ar String +The notmuch query that defines what content this virtual mailbox has. +Refer to +.Xr notmuch-search-terms 7 +for notmuch's search syntax. +.It Ic parent Ar String +If you wish to build a mailbox hierarchy, define the name of a parent mailbox you have used in your configuration. +.Pq Em optional +.El Example: .Bd -literal [accounts.notmuch] @@ -212,6 +229,8 @@ format = "notmuch" "INBOX" = { query="tag:inbox", subscribe = true } "Drafts" = { query="tag:draft", subscribe = true } "Sent" = { query="from:username@example.com from:username2@example.com", subscribe = true } + "Archives" = { query="tag:archived", subscribe = true } + "Archives/2019" = { query="tag:archived date:01-2019..12-2019", parent="Archives", subscribe = true } .Ed .Ss IMAP only IMAP specific options are: |