mirror of https://github.com/djcb/mu.git
* update the manpage (still WIP)
This commit is contained in:
parent
460a4ecf65
commit
e9236bf0f8
72
man/mu.1
72
man/mu.1
|
@ -6,23 +6,19 @@ mu \- index and search the contents of e-mail messages stored in Maildirs
|
||||||
.B mu <command> [options] [parameter(s)]
|
.B mu <command> [options] [parameter(s)]
|
||||||
|
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.B mu
|
\fBmu\fR is a set of tools for indexing and searching e-mail messages stored in
|
||||||
is a set of tools for indexing and searching e-mail messages stored in
|
|
||||||
Maildirs. It does so by recursively scanning a Maildir directory tree and
|
Maildirs. It does so by recursively scanning a Maildir directory tree and
|
||||||
analyzing the e-mail messages found. The results of this analysis are then
|
analyzing the e-mail messages found. The results of this analysis are then
|
||||||
stored in a database. Using this database, you can quickly search for specific
|
stored in a database. Using this database, you can quickly search for specific
|
||||||
messages.
|
messages.
|
||||||
|
|
||||||
.B mu
|
\fBmu\fR also offers functionality for creating maildirs.
|
||||||
also offers functionality for creating maildirs.
|
|
||||||
|
|
||||||
The various tools are available as commands for a single
|
The various tools are available as commands for a single
|
||||||
.B mu
|
\fBmu\fR executable.
|
||||||
executable.
|
|
||||||
|
|
||||||
.SH GENERAL OPTIONS
|
.SH GENERAL OPTIONS
|
||||||
.B mu
|
\fBmu\fR offers a number of general options -- options that apply to all commands:
|
||||||
offers a number of general options -- options that apply to all commands:
|
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-a\fR, \fB\-\-muhome\fR causes \fBmu\fR to use an alternative directory to
|
\fB\-a\fR, \fB\-\-muhome\fR causes \fBmu\fR to use an alternative directory to
|
||||||
|
@ -31,7 +27,7 @@ store and read its database and logs. By default, \fB~/.mu\fR is used.
|
||||||
.TP
|
.TP
|
||||||
\fB\-d\fR, \fB\-\-debug\fR makes \fBmu\fR generate extra debug information,
|
\fB\-d\fR, \fB\-\-debug\fR makes \fBmu\fR generate extra debug information,
|
||||||
useful for debugging the program itself. Note that by default, debug
|
useful for debugging the program itself. Note that by default, debug
|
||||||
information goes to the log file, \fB~/.mu/mu.log\fR.
|
information goes to the log file, \fI~/.mu/mu.log\fR.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-q\fR, \fB\-\-quiet\fR causes \fBmu\fR not to output informational
|
\fB\-q\fR, \fB\-\-quiet\fR causes \fBmu\fR not to output informational
|
||||||
|
@ -53,8 +49,7 @@ the options for one command, or all of the commands.
|
||||||
|
|
||||||
|
|
||||||
.SH COMMANDS
|
.SH COMMANDS
|
||||||
.B mu
|
\fBmu\fR offers the following commands:
|
||||||
offers the following commands:
|
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fBindex\fR
|
\fBindex\fR
|
||||||
|
@ -67,11 +62,6 @@ for finding messages in your database, using certain search parameters (see
|
||||||
below for details). You can use \fBquery\fR and \fBsearch\fR as synonyms for
|
below for details). You can use \fBquery\fR and \fBsearch\fR as synonyms for
|
||||||
\fBfind\fR.
|
\fBfind\fR.
|
||||||
|
|
||||||
.TP
|
|
||||||
\fBcleanup\fR
|
|
||||||
for removing messages from your database for which there is no corresponding
|
|
||||||
message file anymore. This commonly happens when you delete or move messages.
|
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fBmkdir\fR
|
\fBmkdir\fR
|
||||||
for creating Maildirs.
|
for creating Maildirs.
|
||||||
|
@ -106,13 +96,16 @@ suffices to index the changes, which goes much faster. Also note that a
|
||||||
substantial amount of the time goes to printing the progress information; if
|
substantial amount of the time goes to printing the progress information; if
|
||||||
you turn that off (with \fB\-q\fR or \fB\-\-quiet\fR), it goes a lot faster.
|
you turn that off (with \fB\-q\fR or \fB\-\-quiet\fR), it goes a lot faster.
|
||||||
|
|
||||||
|
Phase two of the indexing-process is the removal of messages from the database
|
||||||
|
for which there is no longer a corresponding file in the Maildir. If you do
|
||||||
|
not want this, you can use \fB\-u\fR, \fB\-\-nocleanup\fR.
|
||||||
|
|
||||||
.SS Indexing options
|
.SS Indexing options
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\fB\-m\fR, \fB\-\-maildir\fR=\fI<maildir>\fR starts searching
|
\fB\-m\fR, \fB\-\-maildir\fR=\fI<maildir>\fR starts searching
|
||||||
at\fI<maildir>\fR. By default,
|
at\fI<maildir>\fR. By default,
|
||||||
.B mu
|
\fBmu\fR uses whatever the
|
||||||
uses whatever the
|
|
||||||
.B MAILDIR
|
.B MAILDIR
|
||||||
environment variable is set to; if that is not set, it tries
|
environment variable is set to; if that is not set, it tries
|
||||||
.B ~/Maildir
|
.B ~/Maildir
|
||||||
|
@ -123,12 +116,9 @@ environment variable is set to; if that is not set, it tries
|
||||||
re-index all mails, even ones that are already in the database.
|
re-index all mails, even ones that are already in the database.
|
||||||
|
|
||||||
.T
|
.T
|
||||||
\fB\-u\fR, \fB\-\-cleanup\fR automatically clean up the database after
|
\fB\-u\fR, \fB\-\-nocleanup\fR disables the database cleanup that
|
||||||
indexing. This is functionally equivalent to calling the
|
\fBmu\fR does by default after indexing.
|
||||||
.B cleanup
|
|
||||||
command after indexing. Please see the information for
|
|
||||||
.B cleanup
|
|
||||||
for details.
|
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
|
|
||||||
|
@ -163,42 +153,28 @@ offers all the search functionality that Xapian offers; please refer to:
|
||||||
Here, we will show the mu-specific ways to specify search patterns.
|
Here, we will show the mu-specific ways to specify search patterns.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.SS find options
|
.SS find options
|
||||||
|
|
||||||
.SS query syntax
|
.SS query syntax
|
||||||
In its simplest form, you can just can just specify a number of words, and
|
In its simplest form, you can just can just specify a number of words, and
|
||||||
.B mu
|
\fBmu\fR will search for messages that match all of those words. So,
|
||||||
will search for messages that match all of those words. So,
|
|
||||||
.nf
|
.nf
|
||||||
$ mu find monkey banana
|
$ mu find monkey banana
|
||||||
.fi
|
.fi
|
||||||
will find all messages which have both "monkey" AND "banana" in one of those
|
will find all messages which have both "monkey" AND "banana" in one of those
|
||||||
fields.
|
fields.
|
||||||
|
|
||||||
.SH THE CLEANUP COMMAND
|
|
||||||
|
|
||||||
|
|
||||||
.SH THE MKDIR COMMAND
|
.SH THE MKDIR COMMAND
|
||||||
|
With the
|
||||||
|
.B mkdir
|
||||||
|
command, you can create new Maildirs with permissions 0755. For example,
|
||||||
|
.nf
|
||||||
|
mu mkdir tom dick harry
|
||||||
|
.fi
|
||||||
|
will create three Maildirs \fItom\fR, \fIdick\fR and \fIharry\fR.
|
||||||
|
|
||||||
.SH OPTIONS
|
If the creation somehow fails, for safety reasons, \fBno\fR attempt is made to
|
||||||
.B mu
|
remove any parts that were created.
|
||||||
has a number of general options, which work with all the commands.
|
|
||||||
|
|
||||||
.B --maildir=, -m
|
|
||||||
.I <maildir>
|
|
||||||
set the full path to the maildir; note that you can also specify this path as
|
|
||||||
a non-option argument to
|
|
||||||
.B
|
|
||||||
mu-index
|
|
||||||
; if you use both, the non-option argument wins.
|
|
||||||
|
|
||||||
.B --quiet|-q
|
|
||||||
makes
|
|
||||||
.B mu-index
|
|
||||||
not put out any progress info during its indexing. This is not the default, as
|
|
||||||
running may take quite some time, and might confuse novice users.
|
|
||||||
|
|
||||||
|
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
As mentioned, \fBmu index\fR uses \fBMAILDIR\fR to find the user's Maildir if
|
As mentioned, \fBmu index\fR uses \fBMAILDIR\fR to find the user's Maildir if
|
||||||
|
|
Loading…
Reference in New Issue