* man: fix some troff formatting issues (thanks to Maciek Borzecki)
This commit is contained in:
@ -1,4 +1,4 @@
|
|||||||
.TH MU CFIND 1 "July 2012" "User Manuals"
|
.TH MU CFIND 1 "October 2012" "User Manuals"
|
||||||
|
|
||||||
.SH NAME
|
.SH NAME
|
||||||
|
|
||||||
@ -12,9 +12,9 @@ database and export them for use in other programs.
|
|||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
|
|
||||||
\fBmu cfind\fR is the \fBmu\fR command for finding \fIcontacts\fR (name and
|
\fBmu cfind\fR is the \fBmu\fR command for finding \fIcontacts\fR (name and
|
||||||
e-mail address of people who were either sender or receiver of mail). There
|
e-mail address of people who were either an e-mail's sender or
|
||||||
are different output formats available, for importing the contacts into
|
receiver). There are different output formats available, for importing the
|
||||||
other programs.
|
contacts into other programs.
|
||||||
|
|
||||||
.SH SEARCHING CONTACTS
|
.SH SEARCHING CONTACTS
|
||||||
|
|
||||||
@ -36,12 +36,12 @@ would find all contacts with a gmail-address, while
|
|||||||
$ mu cfind Mary
|
$ mu cfind Mary
|
||||||
.fi
|
.fi
|
||||||
|
|
||||||
would find all contact with Mary in either name or e-mail address.
|
lists all contacts with Mary in either name or e-mail address.
|
||||||
|
|
||||||
If you do not specify any search expression, \fBmu cfind\fR will return the
|
If you do not specify any search expression, \fBmu cfind\fR returns the full
|
||||||
full list of contacts. Note, \fBmu cfind\fR uses does not directly use the
|
list of contacts. Note, \fBmu cfind\fR uses does not directly use the
|
||||||
database, but uses a cache file with e-mail addresses that is populated during
|
database, but uses a cache file with e-mail addresses, which is populated
|
||||||
the indexing process.
|
during the indexing process.
|
||||||
|
|
||||||
The regular expressions are Perl-compatible (as per the PCRE-library).
|
The regular expressions are Perl-compatible (as per the PCRE-library).
|
||||||
|
|
||||||
@ -100,18 +100,18 @@ example:
|
|||||||
You can use \fBmu cfind\fR as an external address book server for
|
You can use \fBmu cfind\fR as an external address book server for
|
||||||
\fBmutt\fR. For this to work, add the following to your \fImuttrc\fR:
|
\fBmutt\fR. For this to work, add the following to your \fImuttrc\fR:
|
||||||
|
|
||||||
.sh
|
.nf
|
||||||
set query_command = "mu cfind --format=mutt-ab '%s'"
|
set query_command = "mu cfind --format=mutt-ab '%s'"
|
||||||
.si
|
.fi
|
||||||
|
|
||||||
Now, in mutt, you can easily search for e-mail address using the
|
Now, in mutt, you can easily search for e-mail addresses using the
|
||||||
\fBquery\fR-command, which is (by default) accessible by pressing \fBQ\fR.
|
\fBquery\fR-command, which is (by default) accessible by pressing \fBQ\fR.
|
||||||
|
|
||||||
.SH ENCODING
|
.SH ENCODING
|
||||||
|
|
||||||
\fBmu cfind\fR output is encoded according to the current locale except for
|
\fBmu cfind\fR output is encoded according to the current locale except for
|
||||||
\fI--format=bbdb\fR. This is hard-coded to UTF-8, and as such specified in the
|
\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.
|
output-file, so emacs/bbdb can handle things correctly, without guessing.
|
||||||
|
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
|
|
||||||
|
|||||||
@ -51,7 +51,7 @@ characters. All match. In general, \fBmu\fR tries to be 'eager' in matching,
|
|||||||
as filtering out unwanted results is usually preferrable over non matching
|
as filtering out unwanted results is usually preferrable over non matching
|
||||||
messages.
|
messages.
|
||||||
|
|
||||||
A wildcard search is a search where a \fB*\fR matches the last \fIn\R
|
A wildcard search is a search where a \fB*\fR matches the last \fIn\fR
|
||||||
character(s) in some string. The string must always start with one or more
|
character(s) in some string. The string must always start with one or more
|
||||||
characters before the wildcards. Since version 0.9.6, \fBmu\fR also supports
|
characters before the wildcards. Since version 0.9.6, \fBmu\fR also supports
|
||||||
wildcard searches for all fields except maildirs and paths. So, to get all
|
wildcard searches for all fields except maildirs and paths. So, to get all
|
||||||
@ -427,7 +427,7 @@ use a bookmarked search query. Using this option, a query from your bookmark
|
|||||||
file will be prepended to other search queries. See mu-bookmarks(1) for the
|
file will be prepended to other search queries. See mu-bookmarks(1) for the
|
||||||
details of the bookmarks file.
|
details of the bookmarks file.
|
||||||
|
|
||||||
.T
|
.TP
|
||||||
\fB\-t\fR, \fB\-\-threads\fR
|
\fB\-t\fR, \fB\-\-threads\fR
|
||||||
show messages in 'threaded' format -- that is, with indentation and arrows
|
show messages in 'threaded' format -- that is, with indentation and arrows
|
||||||
showing the conversation threads in the list of matching messages.
|
showing the conversation threads in the list of matching messages.
|
||||||
|
|||||||
@ -134,7 +134,7 @@ existing database, and a maildir with 27273 messages:
|
|||||||
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
||||||
$ time mu index --quiet
|
$ time mu index --quiet
|
||||||
66,65s user 6,05s system 27% cpu 4:24,20 total
|
66,65s user 6,05s system 27% cpu 4:24,20 total
|
||||||
.si
|
.fi
|
||||||
(about 103 messages per second)
|
(about 103 messages per second)
|
||||||
|
|
||||||
A second run, which is the more typical use case when there is a database
|
A second run, which is the more typical use case when there is a database
|
||||||
@ -144,7 +144,7 @@ already, goes much faster:
|
|||||||
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
||||||
$ time mu index --quiet
|
$ time mu index --quiet
|
||||||
0,48s user 0,76s system 10% cpu 11,796 total
|
0,48s user 0,76s system 10% cpu 11,796 total
|
||||||
.si
|
.fi
|
||||||
(more than 56818 messages per second)
|
(more than 56818 messages per second)
|
||||||
|
|
||||||
Note that each of test flushes the caches first; a more common use case might
|
Note that each of test flushes the caches first; a more common use case might
|
||||||
@ -153,8 +153,8 @@ quite 'warm' in that case:
|
|||||||
|
|
||||||
.nf
|
.nf
|
||||||
$ time mu index --quiet
|
$ time mu index --quiet
|
||||||
0,33s user 0,40s system 80% cpu 0,905 total
|
0,33s user 0,40s system 80% cpu 0,905 total
|
||||||
.si
|
.fi
|
||||||
which is more than 30000 messages per second.
|
which is more than 30000 messages per second.
|
||||||
|
|
||||||
|
|
||||||
@ -167,7 +167,7 @@ messages.
|
|||||||
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
||||||
$ time mu index --quiet
|
$ time mu index --quiet
|
||||||
27,79s user 2,17s system 48% cpu 1:01,47 total
|
27,79s user 2,17s system 48% cpu 1:01,47 total
|
||||||
.si
|
.fi
|
||||||
(about 813 messages per second)
|
(about 813 messages per second)
|
||||||
|
|
||||||
A second run, which is the more typical use case when there is a database
|
A second run, which is the more typical use case when there is a database
|
||||||
@ -177,7 +177,7 @@ already, goes much faster:
|
|||||||
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
$ sudo sh -c 'sync && echo 3 > /proc/sys/vm/drop_caches'
|
||||||
$ time mu index --quiet
|
$ time mu index --quiet
|
||||||
0,13s user 0,30s system 19% cpu 2,162 total
|
0,13s user 0,30s system 19% cpu 2,162 total
|
||||||
.si
|
.fi
|
||||||
(more than 173000 messages per second)
|
(more than 173000 messages per second)
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
.SH NAME
|
.SH NAME
|
||||||
|
|
||||||
\fBmu remove\fR is the \fBmu\R command to remove messages from the database.
|
\fBmu remove\fR is the \fBmu\fR command to remove messages from the database.
|
||||||
|
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user