2022-12-30 10:13:00 +01:00
|
|
|
#+TITLE: MU INIT
|
|
|
|
#+MAN_CLASS_OPTIONS: :section-id "@SECTION_ID@" :date "@MAN_DATE@"
|
2022-12-17 23:21:52 +01:00
|
|
|
|
|
|
|
* NAME
|
|
|
|
|
|
|
|
mu init -- initialize the mu message database
|
|
|
|
|
|
|
|
* SYNOPSIS
|
|
|
|
|
|
|
|
*mu [common-options] init [options]*
|
|
|
|
|
|
|
|
* DESCRIPTION
|
|
|
|
|
|
|
|
*mu init* is the subcommand for setting up the mu message database. After *mu init*
|
|
|
|
has completed, you can run *mu index*
|
|
|
|
|
|
|
|
* INIT OPTIONS
|
|
|
|
|
|
|
|
** -m, --maildir=<maildir>
|
|
|
|
starts searching at =<maildir>=. By default, *mu* uses whatever the *MAILDIR*
|
|
|
|
environment variable is set to; if it is not set, it tries =~/Maildir= if it
|
|
|
|
already exists.
|
|
|
|
|
2023-07-01 18:03:51 +02:00
|
|
|
** --my-address=<email-address-or-regex>
|
2022-12-17 23:21:52 +01:00
|
|
|
|
2023-07-01 18:03:51 +02:00
|
|
|
specifies that some e-mail address is 'my-address' (the option can be used
|
2022-12-17 23:21:52 +01:00
|
|
|
multiple times). Any message in which at least one of the contact fields
|
|
|
|
contains such an address is considered a 'personal' messages; this can then be
|
|
|
|
used for filtering in *mu-find(1)*, *mu-cfind(1)* and *mu4e*, e.g. to filter-out
|
|
|
|
mailing list messages.
|
|
|
|
|
2023-07-01 18:03:51 +02:00
|
|
|
=<email-address-or-regex>= can be either a plain e-mail address (such as
|
2022-12-30 10:13:00 +01:00
|
|
|
*foo@example.com*), or a basic PCRE regular-expression (see *pcre(3)* for details),
|
|
|
|
wrapped in */* (such as =/foo-.*@example\\.com/=). Depending on your shell, the
|
2022-12-31 08:40:00 +01:00
|
|
|
argument may need to be quoted.
|
2022-12-17 23:21:52 +01:00
|
|
|
|
2023-07-01 18:03:51 +02:00
|
|
|
** --ignored-address=<email-address-or-regex>
|
|
|
|
|
|
|
|
specifies that some e-mail address is to be ignored from the contacts-cache
|
|
|
|
(the option can be used multiple times). Such address then cannot be found with
|
|
|
|
*mu-cfind(1)* or in the Mu4e contacts cache.
|
|
|
|
|
|
|
|
=<my-email-address>= can be either a plain e-mail address or a regexp, just like
|
|
|
|
for the =--my-address= option.
|
|
|
|
|
2023-01-29 12:40:40 +01:00
|
|
|
** --reinit
|
|
|
|
|
2023-07-01 18:03:51 +02:00
|
|
|
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.
|
|
|
|
|
|
|
|
* EXAMPLE
|
|
|
|
#+begin_example
|
|
|
|
$ mu init --maildir=~/Maildir --my-address=alice@example.com --my-address=bob@example.com --ignored-address='/.*reply.*/'
|
|
|
|
#+end_example
|
2023-01-29 12:40:40 +01:00
|
|
|
|
2023-01-29 14:38:06 +01:00
|
|
|
#+include: "exit-code.inc" :minlevel 1
|
2023-01-29 12:40:40 +01:00
|
|
|
|
2022-12-17 23:21:52 +01:00
|
|
|
#+include: "muhome.inc" :minlevel 2
|
|
|
|
|
|
|
|
#+include: "prefooter.inc" :minlevel 1
|
|
|
|
|
|
|
|
* SEE ALSO
|
|
|
|
|
2022-12-30 10:13:00 +01:00
|
|
|
*mu-index(1)*, *mu-find(1)*, *mu-cfind(1)*, *pcre(3)*
|