X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-new-1.mdwn;h=e29f2e89e6a8c55ebfa5c7ab38ee04e44af85e11;hb=716bcefd296e3ee39ff65e8ef89e671c9828191d;hp=81d5edd5e426835e998881c5ddfeaa602fc110f1;hpb=33b367e699bbcc8fecd001fab8033a4e91b13450;p=notmuch-wiki
diff --git a/manpages/notmuch-new-1.mdwn b/manpages/notmuch-new-1.mdwn
index 81d5edd..e29f2e8 100644
--- a/manpages/notmuch-new-1.mdwn
+++ b/manpages/notmuch-new-1.mdwn
@@ -1,73 +1,99 @@
NOTMUCH-NEW(1)
NAME
-
- notmuch-new - Incorporate new mail into the notmuch database.
+ notmuch-new - incorporate new mail into the notmuch database
SYNOPSIS
-
- notmuch new [--no-hooks]
+ notmuch new [options]
DESCRIPTION
-
Find and import any new messages to the database.
-
-
The new command scans all sub-directories of the database, performing
full-text indexing on new messages that are found. Each new message
will automatically be tagged with both the inbox and unread tags.
-
-
You should run notmuch new once after first running notmuch setup to
create the initial database. The first run may take a long time if you
have a significant amount of mail (several hundred thousand messages or
more). Subsequently, you should run notmuch new whenever new mail is
- delivered and you wish to incorporate it into the database. These sub-
+ delivered and you wish to incorporate it into the database. These subâ
sequent runs will be much quicker than the initial run.
-
-
Invoking notmuch with no command argument will run new if notmuch setup
has previously been completed, but notmuch new has not previously been
run.
-
-
notmuch new updates tags according to maildir flag changes if the
- maildir.synchronize_flags configuration option is enabled. See notmuch-
- config(1) for details.
-
+ maildir.synchronize_flags configuration option is enabled. See notâ
+ much-config(1) for details.
-
- The new command supports hooks. See notmuch-hooks(5) for more details
+ The new command supports hooks. See notmuch-hooks(5) for more details
on hooks.
-
-
Supported options for new include
+
+ --no-hooks
+ Prevents hooks from being run.
+
+ --quiet
+ Do not print progress or results.
+
+ --verbose
+ Print file names being processed. Ignored when combined with
+ --quiet.
+
+ --decrypt=(true|nostash|auto|false)
+ If true, when encountering an encrypted message, try to decrypt
+ it while indexing, and stash any discovered session keys. If
+ auto, try to use any session key already known to belong to this
+ message, but do not attempt to use the user's secret keys. If
+ decryption is successful, index the cleartext of the message.
+
+ Be aware that the index is likely sufficient (and the session
+ key is certainly sufficient) to reconstruct the cleartext of the
+ message itself, so please ensure that the notmuch message index
+ is adequately protected. DO NOT USE --decrypt=true or
+ --decrypt=nostash without considering the security of your
+ index.
+
+ See also index.decrypt in notmuch-config(1).
+
+ --full-scan
+ By default notmuch-new uses directory modification times
+ (mtimes) to optimize the scanning of directories for new mail.
+ This option turns that optimization off.
+EXIT STATUS
- --no-hooks
+ This command supports the following special exit status code
+
+ 75 (EX_TEMPFAIL)
+ A temporary failure occurred; the user is invited to retry.
+SEE ALSO
- Prevents hooks from being run.
+ notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), notâ
+ much-hooks(5), notmuch-insert(1), notmuch-reply(1), notmuch-restore(1),
+ notmuch-search(1), notmuch-search-terms(7), notmuch-show(1), notâ
+ much-tag(1)
-SEE ALSO
+AUTHOR
+
+ Carl Worth and many others
+
+COPYRIGHT
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), not-
- much-hooks(5), notmuch-reply(1), notmuch-restore(1), notmuch-search(1),
- notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1)
+ 2009-2019, Carl Worth and many others
-Notmuch 0.13.2
+0.29