X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=manpages%2Fnotmuch-insert-1.mdwn;h=46a6aa7a246fac84592663321b9cae689e3e9199;hb=HEAD;hp=bf44bdc4b4a1d9ae48eaa07110d6e7a553c186ff;hpb=29654905e64093a5275f4a554527231072efccb9;p=notmuch-wiki
diff --git a/manpages/notmuch-insert-1.mdwn b/manpages/notmuch-insert-1.mdwn
index bf44bdc..46a6aa7 100644
--- a/manpages/notmuch-insert-1.mdwn
+++ b/manpages/notmuch-insert-1.mdwn
@@ -13,10 +13,10 @@
DESCRIPTION
notmuch insert reads a message from standard input and delivers it into
- the maildir directory given by configuration option database.path, then
- incorporates the message into the notmuch database. It is an alternaâ
- tive to using a separate tool to deliver the message then running not-
- much new afterwards.
+ the maildir directory given by configuration option database.mail_root,
+ then incorporates the message into the notmuch database. It is an alâ
+ ternative to using a separate tool to deliver the message then running
+ notmuch-new(1) afterwards.
The new message will be tagged with the tags specified by the new.tags
configuration option, then by operations specified on the command-line:
@@ -26,16 +26,16 @@
base (it has same Message-ID), it will be added to the maildir folder
and notmuch database, but the tags will not be changed.
- The insert command supports hooks. See notmuch-hooks(5) for more
- details on hooks.
+ The insert command supports hooks. See notmuch-hooks(5) for more deâ
+ tails on hooks.
Option arguments must appear before any tag operation arguments. Supâ
ported options for insert include
- --folder=<folder>
+ --folder=<folder>
Deliver the message to the specified folder, relative to the
- top-level directory given by the value of database.path. The
- default is the empty string, which means delivering to the
+ top-level directory given by the value of database.mail_root.
+ The default is the empty string, which means delivering to the
top-level directory.
--create-folder
@@ -51,39 +51,45 @@
--no-hooks
Prevent hooks from being run.
+ --world-readable
+ When writing mail to the mailbox, allow it to be read by users
+ other than the current user. Note that this does not override
+ umask. By default, delivered mail is only readable by the curâ
+ rent user.
+
--decrypt=(true|nostash|auto|false)
If true and the message is encrypted, try to decrypt the message
- while indexing, stashing any session keys discovered. If auto,
- and notmuch already knows about a session key for the message,
- it will try decrypting using that session key but will not try
- to access the user's secret keys. If decryption is successful,
- index the cleartext itself. Either way, the message is always
+ while indexing, stashing any session keys discovered. If auto,
+ and notmuch already knows about a session key for the message,
+ it will try decrypting using that session key but will not try
+ to access the user's secret keys. If decryption is successful,
+ index the cleartext itself. Either way, the message is always
stored to disk in its original form (ciphertext).
- nostash is the same as true except that it will not stash
+ nostash is the same as true except that it will not stash
newly-discovered session keys in the database.
Be aware that the index is likely sufficient (and a stashed sesâ
- sion key is certainly sufficient) to reconstruct the cleartext
+ sion 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.
+ index is adequately protected. DO NOT USE --decrypt=true or
+ --decrypt=nostash without considering the security of your inâ
+ dex.
See also index.decrypt in notmuch-config(1).
EXIT STATUS
- This command returns exit status 0 on successful mail delivery,
- non-zero otherwise. The default is to indicate failed mail delivery on
- any errors, including message file delivery to the filesystem, message
- indexing to Notmuch database, changing tags, and synchronizing tags to
- maildir flags. The --keep option may be used to settle for successful
+ This command returns exit status 0 on successful mail delivery,
+ non-zero otherwise. The default is to indicate failed mail delivery on
+ any errors, including message file delivery to the filesystem, message
+ indexing to Notmuch database, changing tags, and synchronizing tags to
+ maildir flags. The --keep option may be used to settle for successful
message file delivery.
This command supports the following special exit status code for errors
- most likely to be temporary in nature, e.g. failure to get a database
+ most likely to be temporary in nature, e.g. failure to get a database
write lock.
75 (EX_TEMPFAIL)
@@ -95,7 +101,7 @@
SEE ALSO
- notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1), notâ
+ 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)
@@ -107,7 +113,7 @@
COPYRIGHT
- 2009-2018, Carl Worth and many others
+ 2009-2022, Carl Worth and many others
-0.26
+0.35