cli/insert: document the use of EX_TEMPFAIL
authorDavid Bremner <david@tethera.net>
Wed, 7 Dec 2016 11:27:12 +0000 (07:27 -0400)
committerDavid Bremner <david@tethera.net>
Thu, 15 Dec 2016 11:21:02 +0000 (20:21 +0900)
doc/man1/notmuch-insert.rst

index 9e7afc36d75f24df41b7154b78a7f6a5e889f1a9..9847e674688ed1cb23b95ef87ccc2efb89599268 100644 (file)
@@ -60,6 +60,13 @@ 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 write lock.
+
+``75 (EX_TEMPFAIL)``
+    A temporary failure occured; the user is invited to retry.
+
 The exit status of the **post-insert** hook does not affect the exit
 status of the **insert** command.