summaryrefslogtreecommitdiff
path: root/man/mu-bookmarks.5.org
blob: 5b13ffb52125b16f82310e5dfdd971d908ead27c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
#+TITLE: MU BOOKMARKS
#+MAN_CLASS_OPTIONS: :section-id "@SECTION_ID@" :date "@MAN_DATE@"
#+include: macros.inc

* NAME

mu-bookmarks - file with bookmarks (shortcuts) for *mu* search expressions

* DESCRIPTION

Bookmarks are named shortcuts for search queries. They allow using a convenient
name for often-used queries. The bookmarks are also visible as shortcuts in the
*mu* experimental user interfaces, =mug= and =mug2=.

The bookmarks file is read from _<muhome>/bookmarks_. On Unix this would typically
be _~/.config/mu/bookmarks_, but this can be influenced using the *--muhome*
parameter for {{{man-link(mu-find,1)}}}.

The bookmarks file is a typical key=value *.ini*-file, which is best shown by
means of an example:

#+begin_example
[mu]
inbox=maildir:/inbox                  # inbox
oldhat=maildir:/archive subject:hat   # archived with subject containing 'hat'
#+end_example

The *[mu]* group header is required. For practical uses of bookmarks, see
{{{man-link(mu-find,1)}}}.

#+include: "author.inc" :minlevel 1

#+include: "copyright.inc" :minlevel 1

* SEE ALSO

{{{man-link(mu,1)}}},
{{{man-link(mu-find,1)}}}