alx/mu4e
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

mu-init: automatic export labels with --reinit

Browse Source 
When re-initializing the store, automatically write the labels to a file in mu's
cache, so user can later import them.
This commit is contained in:
Dirk-Jan C. Binnema
2025-08-16 15:48:08 +03:00
parent a6b1f47a30
commit 8c706a77db
6 changed files with 98 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
man/mu-init.1.org
View File

@ -13,26 +13,26 @@ mu-init - initialize the *mu* message database
* DESCRIPTION
*mu init* is the subcommand for setting up the *mu* message database. After *mu init*
has completed, you can run *mu index*
has completed, you can run *mu index*.
* INIT OPTIONS
** -m, --maildir _maildir_
Use _maildir_ as the root-maildir.
By default, *mu* uses the *MAILDIR* environment; if it is not set, it uses _~/Maildir_
if it is an existing directory. If neither of those can be used, the *--maildir*
option is required; it must be an absolute path (but ~~/~ expansion is
performed).
By default, *mu* uses the *MAILDIR* environment to find the root-maildir. If it is
not set, it uses _~/Maildir_ if it is an existing directory. If neither of those
can be used, the *--maildir* option is required; it must be an absolute path (but
~~/~ expansion is performed).
** --personal-address _email-address-or-regex_
** --my-address _email-address-or-regex_ (alias)
Specifies that some e-mail address is a personal address. The option can be used
Specifies that some e-mail address is a /personal/ address. The option can be used
multiple times, to specify all your addresses.
Any message in which at least one of the contact fields contains such an address
is considered a `personal' message; this can then be used for filtering in
{{{man-link(mu-find,1)}}}, {{{man-link(mu-cfind,1)}}} and *mu4e*, e.g. to
Any message in which at least one of the contact fields matches a personal
address, is considered a `personal' message; this can then be used for filtering
in {{{man-link(mu-find,1)}}}, {{{man-link(mu-cfind,1)}}} and *mu4e*, e.g. to
filter-out mailing list messages.
_email-address-or-regex_ can be either a plain e-mail address (such as
@ -78,6 +78,8 @@ Reinitialize the database from an earlier version; that is, create a new empty
database with the existing settings. This cannot be combined with the other *init*
options.
When you have _labels_ defined for messages in your database, *mu* automatically exports those to file for importing later. See *RESTORING LABELS* below.
#+include: "muhome.inc" :minlevel 2
* NGRAM SUPPORT
@ -93,6 +95,22 @@ variables such as *XAPIAN_CJK_NGRAM* are ignored.
#+include: "exit-code.inc" :minlevel 1
* RESTORING LABELS
When you have any _labels_ defined for your database, *mu* automatically exports
those to a file in the *mu* cache directory; you see this in the ~--init~ output.
#+begin_example
$ mu init --reinit
exported labels to: /home/user/.cache/mu/mu-export-2025-08-16-13:43:27.txt
#+end_example
You can restore those labels _after_ re-indexing, e.g.,
#+begin_example
$ mu label import /home/user/.cache/mu/mu-export-2025-08-16-13:43:27.txt
#+end_example
Please see {{{man-link(mu-label,1)}}} for further details.
* EXAMPLE
#+begin_example
@ -105,5 +123,6 @@ $ mu init --maildir=~/Maildir --my-address=alice@example.com --my-address=bob@ex
{{{man-link(mu-index,1)}}},
{{{man-link(mu-find,1)}}},
{{{man-link(mu-label,1)}}},
{{{man-link(mu-cfind,1)}}},
{{{man-link(pcre,3)}}}

11
man/mu-label.1.org
View File

@ -71,12 +71,17 @@ The *list* command lists all the labels that are currently in use in the store.
* EXPORT OPTIONS
The *export* command outputs /all/ labels in the store to a file, so you can *import*
it later. The command takes a path to a file as its argument.
it later. The command takes a path to a file or a directory (ending in '/') as
its argument.
If a file is specified, *mu* writes the export to it.
If a directory is specified, *mu* writes to a file in that directory. The directory must already exist.
When neither is specified, *mu* writes to a file in the current directory.
See *EXPORT FORMAT* below for details about the format.
If no file is specified, *mu* creates one for you, in the current directory.
* IMPORT OPTIONS
The *import* command is for restoring the labels from a file created through