1 .TH NOTMUCH-CONFIG 1 2012-03-18 "Notmuch 0.12~rc2"
3 notmuch-config \- Access notmuch configuration file.
7 .RI "<" section ">.<" item ">"
10 .RI "<" section ">.<" item "> [" value " ...]"
16 command can be used to get or set settings in the notmuch
22 The value of the specified configuration item is printed to stdout. If
23 the item has multiple values (it is a list), each value is separated
24 by a newline character.
30 The specified configuration item is set to the given value. To specify
31 a multiple-value item (a list), provide each value as a separate
32 command-line argument.
34 If no values are provided, the specified configuration item will be
35 removed from the configuration file.
38 The available configuration items are described below.
43 The top-level directory where your mail currently exists and to where
44 mail will be delivered in the future. Files should be individual email
45 messages. Notmuch will store its database within a sub-directory of
46 the path configured here named
59 Your primary email address.
65 A list of other email addresses at which you receive email.
71 A list of tags that will be added to all messages incorporated by
78 A list of file and directory names, without path, that will not be
79 searched for messages by
81 All the files and directories matching any of the names specified here
82 will be ignored, regardless of the location in the mail store
88 .B maildir.synchronize_flags
89 If true, then the following maildir flags (in message filenames) will
90 be synchronized with the corresponding notmuch tags:
98 S unread (added when 'S' flag is not present)
102 command will notice flag changes in filenames and update tags, while
107 commands will notice tag changes and update flags in filenames.
109 If there have been any changes in the maildir (new messages added, old
110 ones removed or renamed, maildir flags changed, etc.), it is advisable
117 commands to ensure the tag changes are properly synchronized to the
118 maildir flags, as the commands expect the database and maildir to be
124 The following environment variables can be used to control the
128 Specifies the location of the notmuch configuration file. Notmuch will
129 use ${HOME}/.notmuch\-config if this variable is not set.
132 \fBnotmuch\fR(1), \fBnotmuch-count\fR(1), \fBnotmuch-dump\fR(1),
133 \fBnotmuch-hooks\fR(5), \fBnotmuch-new\fR(1), \fBnotmuch-reply\fR(1),
134 \fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),
135 \fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),