2021-02-13 12:33:12 +01:00
|
|
|
.TH MU 1 "February 2021" "User Manuals"
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2012-01-21 11:12:41 +01:00
|
|
|
.SH NAME
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2011-05-25 21:04:13 +02:00
|
|
|
mu \- a set of tools to deal with Maildirs and message files, in particular to
|
|
|
|
index and search e-mail messages.
|
2010-01-01 19:45:33 +01:00
|
|
|
|
|
|
|
.SH SYNOPSIS
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2013-03-17 18:46:40 +01:00
|
|
|
In alphabetical order:
|
|
|
|
|
2010-11-22 20:45:08 +01:00
|
|
|
.B mu [options]
|
2018-09-01 09:20:07 +02:00
|
|
|
general mu command.
|
2010-11-22 20:45:08 +01:00
|
|
|
|
2013-03-17 18:46:40 +01:00
|
|
|
.B mu add
|
2018-09-01 09:20:07 +02:00
|
|
|
add specific messages to the database. See
|
|
|
|
.BR mu-add(1)
|
2013-03-17 18:46:40 +01:00
|
|
|
|
|
|
|
.B mu cfind [options] [<regexp>]
|
2018-09-01 09:20:07 +02:00
|
|
|
find contacts. See
|
|
|
|
.BR mu-cfind(1)
|
2013-03-17 18:46:40 +01:00
|
|
|
|
|
|
|
.B mu extract [options] <file> [<parts>] [<regexp>]
|
2018-09-01 09:20:07 +02:00
|
|
|
extract attachments and other MIME-parts. See
|
|
|
|
.BR mu-extract(1)
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2010-02-04 21:44:05 +01:00
|
|
|
.B mu find [options] <search expression>
|
2018-09-01 09:20:07 +02:00
|
|
|
find messages. See
|
|
|
|
.BR mu-find(1)
|
|
|
|
|
|
|
|
.B mu help [command]
|
|
|
|
get help for some command. See
|
|
|
|
.BR mu-help(1)
|
2010-01-01 19:45:33 +01:00
|
|
|
|
2013-03-17 18:46:40 +01:00
|
|
|
.B mu index [options]
|
2018-09-01 09:20:07 +02:00
|
|
|
(re)index the messages in a Maildir. See
|
|
|
|
.BR mu-index(1)
|
2010-01-24 12:16:16 +01:00
|
|
|
|
2020-02-06 19:22:43 +01:00
|
|
|
.B mu info [options]
|
|
|
|
show information about the mu database
|
|
|
|
.BR mu-info(1)
|
|
|
|
|
|
|
|
.B mu init [options]
|
|
|
|
initialize the mu database
|
|
|
|
.BR mu-init(1)
|
|
|
|
|
2010-02-04 21:44:05 +01:00
|
|
|
.B mu mkdir [options] <dir> [<dirs>]
|
2018-09-01 09:20:07 +02:00
|
|
|
create a new Maildir. See
|
|
|
|
.BR mu-mkdir(1)
|
2010-01-24 12:16:16 +01:00
|
|
|
|
2013-03-17 18:46:40 +01:00
|
|
|
.B mu remove [options]
|
2018-09-01 09:20:07 +02:00
|
|
|
remove specific messages from the database. See
|
|
|
|
.BR mu-remove(1)
|
2013-03-17 18:46:40 +01:00
|
|
|
|
|
|
|
.B mu script [options]
|
2018-09-01 09:20:07 +02:00
|
|
|
run a mu (Guile) script. See
|
2020-06-30 17:46:04 +02:00
|
|
|
.BR mu-script(1)
|
2013-03-17 18:46:40 +01:00
|
|
|
|
|
|
|
.B mu server [options]
|
2018-09-01 09:20:07 +02:00
|
|
|
start a server process (for \fBmu4e\fR-internal use). See
|
|
|
|
.BR mu-server(1)
|
2013-03-17 18:46:40 +01:00
|
|
|
|
|
|
|
.B mu view <file> [<files>]
|
2018-09-01 09:20:07 +02:00
|
|
|
view a specific message. See
|
|
|
|
.BR mu-view(1)
|
2011-04-05 06:34:22 +02:00
|
|
|
|
2010-01-01 19:45:33 +01:00
|
|
|
.SH DESCRIPTION
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2010-11-30 07:31:59 +01:00
|
|
|
\fBmu\fR is a set of tools for dealing with Maildirs and the e-mail messages
|
|
|
|
in them.
|
2010-02-04 21:44:05 +01:00
|
|
|
|
2018-09-01 09:20:07 +02:00
|
|
|
\fBmu\fR's main purpose is to enable searching of e-mail messages. It
|
|
|
|
does so by periodically scanning a Maildir directory tree and
|
|
|
|
analyzing the e-mail messages found (this is called 'indexing'). The
|
|
|
|
results of this analysis are stored in a database, which can then be
|
|
|
|
queried.
|
2010-02-04 21:44:05 +01:00
|
|
|
|
2018-09-01 09:20:07 +02:00
|
|
|
In addition to indexing and searching, \fBmu\fR also offers
|
|
|
|
functionality for viewing messages, extracting attachments and
|
|
|
|
creating maildirs, and searching and exporting contact information.
|
2010-01-04 19:21:33 +01:00
|
|
|
|
2010-11-30 07:31:59 +01:00
|
|
|
\fBmu\fR can be used from the command line or can be integrated with various
|
|
|
|
e-mail clients.
|
2010-11-22 20:45:08 +01:00
|
|
|
|
|
|
|
This manpage gives a general overview of the available commands
|
2013-06-04 00:30:20 +02:00
|
|
|
(\fBindex\fR, \fBfind\fR, etc.); each \fBmu\fR command has its own
|
|
|
|
man-page as well.
|
2010-01-04 19:21:33 +01:00
|
|
|
|
2011-05-25 21:04:13 +02:00
|
|
|
.SH COLORS
|
2010-10-25 23:25:14 +02:00
|
|
|
|
2014-10-11 13:18:19 +02:00
|
|
|
Some \fBmu\fR sub-commands support colorized output, and do so by
|
|
|
|
default. If you don't want colors, you can use \fI--nocolor\fR.
|
2011-05-25 21:04:13 +02:00
|
|
|
|
2011-05-26 22:39:54 +02:00
|
|
|
Currently, \fBmu find\fR, \fBmu view\fR, \fBmu cfind\fR and \fBmu extract\fR
|
|
|
|
support colors.
|
2011-05-25 21:04:13 +02:00
|
|
|
|
2011-05-29 13:05:28 +02:00
|
|
|
.SH ENCODING
|
|
|
|
|
2011-06-02 10:09:50 +02:00
|
|
|
\fBmu\fR's output is in the current locale, with the exceptions of the output
|
|
|
|
specifically meant for output to UTF8-encoded files. In practice, this means
|
2012-02-18 16:11:32 +01:00
|
|
|
that the output of commands \fBindex\fR, \fBview\fR,
|
2011-06-02 10:09:50 +02:00
|
|
|
\fBextract\fR is always encoded according to the current locale.
|
|
|
|
|
|
|
|
The same is true for \fBfind\fR and \fBcfind\fR, with some exceptions, where
|
|
|
|
the output is always UTF-8, regardless of the locale.
|
|
|
|
|
|
|
|
For \fBcfind\fR the exception is \fI--format=bbdb\fR. This is hard-coded to
|
|
|
|
UTF-8, and as such specified in the output-file, so emacs/bbdb can handle it
|
|
|
|
correctly without guessing.
|
|
|
|
|
|
|
|
For \fBfind\fR the output is encoded according the locale for
|
|
|
|
\fI--format=plain\fR (the default), and UTF-8 for all other formats
|
|
|
|
(\fIjson\fR, \fIsexp\fR, \fIxml\fR).
|
2011-05-29 13:05:28 +02:00
|
|
|
|
2011-05-25 21:04:13 +02:00
|
|
|
.SH DATABASE AND FILE
|
2010-10-25 23:25:14 +02:00
|
|
|
|
2012-02-18 16:11:32 +01:00
|
|
|
Commands \fBmu index\fR and \fBfind\fR and \fBcfind\fR work with the database,
|
2020-05-12 23:56:55 +02:00
|
|
|
while the other ones work on individual mail files. Hence, running \fBview\fR,
|
2010-08-23 07:23:58 +02:00
|
|
|
\fBmkdir\fR and \fBextract\fR does not require the mu database.
|
|
|
|
|
|
|
|
The various commands are discussed in more detail in their own separate
|
|
|
|
man-pages; here the general options are discussed.
|
2010-01-01 19:45:33 +01:00
|
|
|
|
2010-10-25 23:25:14 +02:00
|
|
|
.SH OPTIONS
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2013-06-04 00:30:20 +02:00
|
|
|
\fBmu\fR offers several general options that apply to all commands,
|
2010-08-27 07:26:41 +02:00
|
|
|
including \fBmu\fR without any command.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2010-09-08 23:13:54 +02:00
|
|
|
\fB\-\-muhome\fR
|
2019-07-12 16:36:08 +02:00
|
|
|
use an alternative directory to store and read the database, write the logs,
|
|
|
|
etc. By default, \fBmu\fR uses XDG Base Directory Specification (e.g. on Linux
|
|
|
|
by default \fI~/.cache/mu\fR, \fI~/.config/mu\fR). Earlier versions of \fBmu\fR defaulted
|
|
|
|
to \fI~/.mu\fR, which now requires \fI\-\-muhome=~/.mu\fR.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2010-01-17 14:12:57 +01:00
|
|
|
\fB\-d\fR, \fB\-\-debug\fR
|
|
|
|
makes \fBmu\fR generate extra debug information,
|
2010-01-17 13:03:15 +01:00
|
|
|
useful for debugging the program itself. By default, debug information goes to
|
2020-04-19 13:02:48 +02:00
|
|
|
the log file, \fI~/.cache/mu/mu.log\fR. It can safely be deleted when \fBmu\fR is
|
2010-11-30 07:31:59 +01:00
|
|
|
not running. When running with \fB--debug\fR option, the log file can grow
|
|
|
|
rather quickly. See the note on logging below.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2010-01-17 14:12:57 +01:00
|
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
|
|
causes \fBmu\fR not to output informational
|
2010-01-17 13:03:15 +01:00
|
|
|
messages and progress information to standard output, but only to the log
|
|
|
|
file. Error messages will still be sent to standard error. Note that \fBmu
|
|
|
|
index\fR is \fBmuch\fR faster with \fB\-\-quiet\fR, so it is recommended you
|
|
|
|
use this option when using \fBmu\fR from scripts etc.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2010-08-27 07:26:41 +02:00
|
|
|
\fB\-\-log-stderr\fR
|
2010-11-30 07:31:59 +01:00
|
|
|
causes \fBmu\fR to \fBnot\fR output log messages to standard error, in
|
|
|
|
addition to sending them to the log file.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2021-02-13 12:33:12 +01:00
|
|
|
\fB\-V\fR, \fB\-\-version\fR
|
2010-11-30 07:31:59 +01:00
|
|
|
prints \fBmu\fR version and copyright information.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
|
|
|
.TP
|
2010-01-17 14:12:57 +01:00
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
2018-09-01 09:20:07 +02:00
|
|
|
lists the various command line options.
|
2010-01-06 20:40:46 +01:00
|
|
|
|
2011-08-13 01:35:05 +02:00
|
|
|
.SH ERROR CODES
|
|
|
|
|
|
|
|
The various mu subcommands typically exit with 0 (zero) upon success, and
|
2019-07-12 16:36:08 +02:00
|
|
|
non-zero when some error occurred.
|
2011-08-13 01:35:05 +02:00
|
|
|
|
2010-01-01 19:45:33 +01:00
|
|
|
.SH BUGS
|
2010-11-30 21:11:40 +01:00
|
|
|
|
2010-09-22 23:04:37 +02:00
|
|
|
Please report bugs if you find them:
|
2014-12-20 23:08:17 +01:00
|
|
|
.BR https://github.com/djcb/mu/issues
|
2010-01-01 19:45:33 +01:00
|
|
|
|
|
|
|
.SH AUTHOR
|
2010-01-17 13:03:15 +01:00
|
|
|
|
2010-01-01 19:45:33 +01:00
|
|
|
Dirk-Jan C. Binnema <djcb@djcbsoftware.nl>
|
|
|
|
|
|
|
|
.SH "SEE ALSO"
|
2018-03-10 21:08:17 +01:00
|
|
|
.BR mu-index (1), mu-find (1), mu-cfind (1), mu-mkdir (1), mu-view (1),
|
|
|
|
.BR mu-extract (1), mu-easy (1), mu-bookmarks (5), mu-query (7)
|
2019-07-12 16:36:08 +02:00
|
|
|
.BR https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
|