From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id D09C76DE0943 for ; Wed, 7 Dec 2016 03:27:31 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: -0.006 X-Spam-Level: X-Spam-Status: No, score=-0.006 tagged_above=-999 required=5 tests=[AWL=0.005, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01] autolearn=disabled Received: from arlo.cworth.org ([127.0.0.1]) by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id QwnKms23FmSs for ; Wed, 7 Dec 2016 03:27:30 -0800 (PST) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by arlo.cworth.org (Postfix) with ESMTPS id 3D91D6DE00D3 for ; Wed, 7 Dec 2016 03:27:30 -0800 (PST) Received: from remotemail by fethera.tethera.net with local (Exim 4.84_2) (envelope-from ) id 1cEaNN-0000e5-Bn; Wed, 07 Dec 2016 06:27:05 -0500 Received: (nullmailer pid 24208 invoked by uid 1000); Wed, 07 Dec 2016 11:27:26 -0000 From: David Bremner To: Tomi Ollila , David Bremner , Maarten Aertsen , Notmuch Mail Subject: [PATCH 1/2] cli/insert: document the use of EX_TEMPFAIL Date: Wed, 7 Dec 2016 07:27:12 -0400 Message-Id: <20161207112713.24148-2-david@tethera.net> X-Mailer: git-send-email 2.10.2 In-Reply-To: <20161207112713.24148-1-david@tethera.net> References: <20161207112713.24148-1-david@tethera.net> X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Dec 2016 11:27:31 -0000 --- doc/man1/notmuch-insert.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/man1/notmuch-insert.rst b/doc/man1/notmuch-insert.rst index 9e7afc3..9847e67 100644 --- a/doc/man1/notmuch-insert.rst +++ b/doc/man1/notmuch-insert.rst @@ -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. -- 2.10.2