Provided by: notmuch_0.12-1_i386 bug

NAME

       notmuch-config - Access notmuch configuration file.

SYNOPSIS

       notmuch config get <section>.<item>

       notmuch config set <section>.<item> [value ...]

DESCRIPTION

       The  config  command  can be used to get or set settings in the notmuch
       configuration file.

           get The value of the specified configuration  item  is  printed  to
               stdout.  If  the  item has multiple values (it is a list), each
               value is separated by a newline character.

           set The specified configuration item is set to the given value.  To
               specify a multiple-value item (a list), provide each value as a
               separate command-line argument.

               If no values are provided,  the  specified  configuration  item
               will be removed from the configuration file.

       The available configuration items are described below.

           database.path
               The top-level directory where your mail currently exists and to
               where mail will be delivered in the  future.  Files  should  be
               individual  email  messages.  Notmuch  will  store its database
               within a  sub-directory  of  the  path  configured  here  named
               .notmuch.

           user.name
               Your full name.

           user.primary_email
               Your primary email address.

           user.other_email
               A list of other email addresses at which you receive email.

           new.tags
               A  list of tags that will be added to all messages incorporated
               by notmuch new.

           new.ignore
               A list of file and directory names, without path, that will not
               be  searched  for  messages  by notmuch new.  All the files and
               directories matching any of the names specified  here  will  be
               ignored, regardless of the location in the mail store directory
               hierarchy.

           maildir.synchronize_flags
               If  true,  then  the  following  maildir  flags   (in   message
               filenames)  will be synchronized with the corresponding notmuch
               tags:

                 Flag    Tag
                 ----    -------
                 D       draft
                 F       flagged
                 P       passed
                 R       replied
                 S       unread (added when 'S' flag is not present)

               The notmuch new command will notice flag changes  in  filenames
               and  update  tags,  while  the  notmuch tag and notmuch restore
               commands will notice tag changes and update flags in filenames.

               If there have been any changes in  the  maildir  (new  messages
               added,  old  ones  removed  or  renamed, maildir flags changed,
               etc.), it is advisable to run notmuch new before notmuch tag or
               notmuch restore commands to ensure the tag changes are properly
               synchronized to the maildir flags, as the commands  expect  the
               database and maildir to be in sync.

ENVIRONMENT

       The following environment variables can be used to control the behavior
       of notmuch.

       NOTMUCH_CONFIG
              Specifies  the  location  of  the  notmuch  configuration  file.
              Notmuch will use ${HOME}/.notmuch-config if this variable is not
              set.

SEE ALSO

       notmuch(1),   notmuch-count(1),   notmuch-dump(1),    notmuch-hooks(5),
       notmuch-new(1),    notmuch-reply(1),    notmuch-restore(1),    notmuch-
       search(1), notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)