* mu4e.texi: update documentation

This commit is contained in:
djcb 2012-06-10 16:14:35 +03:00
parent 8b4dd81581
commit 3c72b336f4
1 changed files with 15 additions and 22 deletions

View File

@ -982,19 +982,15 @@ see, are the result of some query. Even if you 'jump to a folder', in fact you
are executing a search query for messages that happen to have the property of are executing a search query for messages that happen to have the property of
being in a certain folder. being in a certain folder.
Queries normally return only up to @code{mu4e-search-results-limit} (default: By default, queries normally return only up to
500) results. You get @emph{all} results when you prefix your search commands @code{mu4e-search-results-limit} (default: 500) results. That's usually more
(such as with @code{mu4e-headers-search}, @code{mu4e-headers-search-bookmark}, than enough, and helps performance quite a bit. Sometimes, you may want to
@code{mu4e-headers-search-bookmark-edit-first} and show @emph{all} results; you can enable this with @t{M-x
@code{mu4e-headers-jump-to-maildir} with @kbd{C-u}. mu4e-headers-toggle-full-search}, or by customizing the variable
@code{mu4e-headers-full-search}. This applies to all search commands.
This limit was introduced in earlier versions of @t{mu4e}, where @t{emacs}
could become slow when there were many matches. This is no longer the case You can also influence the sort order and whether threads are shown or not;
(post @t{mu4e} version 0.9.8.3), but since it is still faster to limit the see @ref{Sort order and threading}.
number of matches, the limit remains.
Note that you can influence the sort order and whether threads are shown or
not; see @ref{Sort order and threading}.
@menu @menu
* Queries:: * Queries::
@ -1171,8 +1167,8 @@ bound to @key{M-left} and @key{M-right}, just like the way you can navigate to
previous and next pages in many webbrowsers. previous and next pages in many webbrowsers.
The functions try to be smart as to not record duplicate queries. Also, the The functions try to be smart as to not record duplicate queries. Also, the
numbers of queries remembered has a fixed limit, so long-running @t{mu4e} number of queries remembered has a fixed limit, so long-running @t{mu4e} won't
won't use too much memory. use too much memory.
If you want to forget previous/next queries, you can use If you want to forget previous/next queries, you can use
@code{mu4e-headers-forget-queries}. @code{mu4e-headers-forget-queries}.
@ -1887,13 +1883,10 @@ address-book with org-contacts} for now.
@item @emph{mu4e only seems to return a subset of all matches - how can I get @item @emph{mu4e only seems to return a subset of all matches - how can I get
all?}. Yes, for speed reasons (and because, if you are like the author, you all?}. Yes, for speed reasons (and because, if you are like the author, you
usually don't need thousands of matches), @t{mu4e} returns only up to the usually don't need thousands of matches), @t{mu4e} returns only up to the
value of the variable @code{m4ue-search-result-limit} matches. You can value of the variable @code{m4ue-search-result-limit} matches. To show
customize that variable, or simply press the emacs prefix @kbd{C-u} before @emph{all} results, use @t{M-x mu4e-headers-toggle-full-search}, or customize
your search command to get all matches. In other words, when you press @t{C-u the variable @code{mu4e-headers-full-search}. This applies to all search
s hello} you will get all matches, while @t{s hello} only gets you commands.
up-to-a-limited-number matches. Same for the other search based commands,
@code{mu4e-headers-jump-to-maildir} (default: @key{j}) and
@code{mu4e-headers-search-bookmark} (default: @key{b}).
@item @emph{How can I show attached images in my message view buffers?} See @item @emph{How can I show attached images in my message view buffers?} See
@ref{Viewing images inline}. @ref{Viewing images inline}.
@item @emph{How can I easily include attachments in the messages I write?} @item @emph{How can I easily include attachments in the messages I write?}