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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
| | ==============
notmuch-insert
==============
SYNOPSIS
========
**notmuch** **insert** [options] **+<tag>** **-<tag>**
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 alternative to using a separate tool to deliver the
message then running *notmuch new* 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:
tags prefixed by '+' are added while those prefixed by '-' are removed.
If the new message is a duplicate of an existing message in the database
(it has same Message-ID), it will be added to the maildir folder and
notmuch database, but the tags will not be changed.
Option arguments must appear before any tag operation arguments.
Supported options for *insert* include
``--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 to deliver to the top-level directory.
``--create-folder``
Try to create the folder named by the ``--folder`` option, if it
does not exist. Otherwise the folder must already exist for mail
delivery to succeed.
EXIT STATUS
===========
This command returns exit status 0 if the message was successfully added
to the mail directory, even if the message could not be indexed and
added to the notmuch database. In the latter case, a warning will be
printed to standard error but the message file will be left on disk.
If the message could not be written to disk then a non-zero exit status
is returned.
SEE ALSO
========
*notmuch(1)*, *notmuch-config(1)*, *notmuch-count(1)*,
*notmuch-dump(1)*, *notmuch-hooks(5)*, *notmuch-reply(1)*,
*notmuch-restore(1)*, *notmuch-search(1)*, *notmuch-search-terms(7)*,
*notmuch-show(1)*, *notmuch-tag(1)*
|