da/a4ed46b48fe35e54e31bda52aa4b3f49e08917

   1 Return-Path: <jani@nikula.org>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 6F7BA431FC3\r
   6         for <notmuch@notmuchmail.org>; Sat, 27 Apr 2013 14:28:11 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id QMXgLmr0JWNa for <notmuch@notmuchmail.org>;\r
  16         Sat, 27 Apr 2013 14:28:11 -0700 (PDT)\r
  17 Received: from mail-lb0-f169.google.com (mail-lb0-f169.google.com\r
  18         [209.85.217.169]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id B2994431FC2\r
  21         for <notmuch@notmuchmail.org>; Sat, 27 Apr 2013 14:28:10 -0700 (PDT)\r
  22 Received: by mail-lb0-f169.google.com with SMTP id z5so1727lbh.14\r
  23         for <notmuch@notmuchmail.org>; Sat, 27 Apr 2013 14:28:09 -0700 (PDT)\r
  24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25         d=google.com; s=20120113;\r
  26         h=x-received:from:to:subject:in-reply-to:references:user-agent:date\r
  27         :message-id:mime-version:content-type:x-gm-message-state;\r
  28         bh=f0M2Vo4HQRPoKGMMdBqb5xv9Bc3mXF/ouhEaW/UISaE=;\r
  29         b=FfgLCrXEX4Oob0spq8QBn4hyScKafXV+xwiAzQ9ZnZrSLjlTqv+0Hf/M70Lc0BBFcv\r
  30         4LRuiF/vi6AqmvO0E7OoCmgaAhmoXbfKuQEr6AM2MT1rxJjzNvQyfvbzp7MrheFPWb+p\r
  31         Y5KJ/KQSHts11Tg91QdaLxZm5P6bT9G20WdYFseYc9z13DZmvcJCedwkkWLaLXOibusZ\r
  32         KddL9SNmLa7tj41m9cSBtbKg6ocMWoybQWMhUE0dfKfFcVKJYqqLitPVK9H7tZ0w3YCv\r
  33         FwvvyVQChHOHojyk/DS90novfZCjKirqQtaQSpalLmH8GDVpDOMbAMTd5PXHeXxZM1gD\r
  34         9OHA==\r
  35 X-Received: by 10.112.168.97 with SMTP id zv1mr24114537lbb.25.1367098089290;\r
  36         Sat, 27 Apr 2013 14:28:09 -0700 (PDT)\r
  37 Received: from localhost (dsl-hkibrasgw2-58c376-211.dhcp.inet.fi.\r
  38         [88.195.118.211])\r
  39         by mx.google.com with ESMTPSA id e2sm2448758lag.5.2013.04.27.14.28.08\r
  40         for <multiple recipients>\r
  41         (version=TLSv1.2 cipher=RC4-SHA bits=128/128);\r
  42         Sat, 27 Apr 2013 14:28:08 -0700 (PDT)\r
  43 From: Jani Nikula <jani@nikula.org>\r
  44 To: Peter Wang <novalazy@gmail.com>, notmuch@notmuchmail.org\r
  45 Subject: Re: [PATCH v5 04/12] man: document 'insert' command\r
  46 In-Reply-To: <1364942517-6982-5-git-send-email-novalazy@gmail.com>\r
  47 References: <1364942517-6982-1-git-send-email-novalazy@gmail.com>\r
  48         <1364942517-6982-5-git-send-email-novalazy@gmail.com>\r
  49 User-Agent: Notmuch/0.15.2+70~g2eeb96a (http://notmuchmail.org) Emacs/24.2.1\r
  50         (x86_64-pc-linux-gnu)\r
  51 Date: Sun, 28 Apr 2013 00:27:57 +0300\r
  52 Message-ID: <8738ubr7du.fsf@nikula.org>\r
  53 MIME-Version: 1.0\r
  54 Content-Type: text/plain\r
  55 X-Gm-Message-State:\r
  56  ALoCoQnPXqZUpHjuzratpVi7esDU8eziwkykMb2os708XShDL1cpUMvh5D9fryalaihzCycSCI/m\r
  57 X-BeenThere: notmuch@notmuchmail.org\r
  58 X-Mailman-Version: 2.1.13\r
  59 Precedence: list\r
  60 List-Id: "Use and development of the notmuch mail system."\r
  61         <notmuch.notmuchmail.org>\r
  62 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  63         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  64 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  65 List-Post: <mailto:notmuch@notmuchmail.org>\r
  66 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  67 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  68         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  69 X-List-Received-Date: Sat, 27 Apr 2013 21:28:11 -0000\r
  70 \r
  71 On Wed, 03 Apr 2013, Peter Wang <novalazy@gmail.com> wrote:\r
  72 > Add initial documentation for notmuch insert command.\r
  73 \r
  74 Of all commands, this man page begs more discussion about the failure\r
  75 modes and exit status.\r
  76 \r
  77 BR,\r
  78 Jani.\r
  79 \r
  80 \r
  81 > ---\r
  82 >  man/Makefile.local        |  1 +\r
  83 >  man/man1/notmuch-insert.1 | 38 ++++++++++++++++++++++++++++++++++++++\r
  84 >  2 files changed, 39 insertions(+)\r
  85 >  create mode 100644 man/man1/notmuch-insert.1\r
  86 >\r
  87 > diff --git a/man/Makefile.local b/man/Makefile.local\r
  88 > index 72e2a18..216aaa0 100644\r
  89 > --- a/man/Makefile.local\r
  90 > +++ b/man/Makefile.local\r
  91 > @@ -12,6 +12,7 @@ MAN1 := \\r
  92 >       $(dir)/man1/notmuch-count.1 \\r
  93 >       $(dir)/man1/notmuch-dump.1 \\r
  94 >       $(dir)/man1/notmuch-restore.1 \\r
  95 > +     $(dir)/man1/notmuch-insert.1 \\r
  96 >       $(dir)/man1/notmuch-new.1 \\r
  97 >       $(dir)/man1/notmuch-reply.1 \\r
  98 >       $(dir)/man1/notmuch-search.1 \\r
  99 > diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1\r
 100 > new file mode 100644\r
 101 > index 0000000..870e1bc\r
 102 > --- /dev/null\r
 103 > +++ b/man/man1/notmuch-insert.1\r
 104 > @@ -0,0 +1,38 @@\r
 105 > +.TH NOTMUCH-INSERT 1 2013-xx-xx "Notmuch 0.xx"\r
 106 > +.SH NAME\r
 107 > +notmuch-insert \- add a message to the maildir and notmuch database\r
 108 > +.SH SYNOPSIS\r
 109 > +\r
 110 > +.B notmuch insert\r
 111 > +.RI "[ +<" tag> "|\-<" tag "> ... ]"\r
 112 > +\r
 113 > +.SH DESCRIPTION\r
 114 > +\r
 115 > +.B notmuch insert\r
 116 > +reads a message from standard input\r
 117 > +and delivers it into the maildir directory given by configuration option\r
 118 > +.BR database.path ,\r
 119 > +then incorporates the message into the notmuch database.\r
 120 > +It is an alternative to using a separate tool to deliver\r
 121 > +the message then running\r
 122 > +.B notmuch new\r
 123 > +afterwards.\r
 124 > +\r
 125 > +The new message will be tagged with the tags specified by the\r
 126 > +.B new.tags\r
 127 > +configuration option, then by operations specified on the command-line:\r
 128 > +tags prefixed by '+' are added while\r
 129 > +those prefixed by '\-' are removed.\r
 130 > +\r
 131 > +If the new message is a duplicate of an existing message in the database\r
 132 > +(it has same Message-ID), it will be added to the maildir folder and\r
 133 > +notmuch database, but the tags will not be changed.\r
 134 > +\r
 135 > +.RE\r
 136 > +.SH SEE ALSO\r
 137 > +\r
 138 > +\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),\r
 139 > +\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-reply\fR(1),\r
 140 > +\fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),\r
 141 > +\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),\r
 142 > +\fBnotmuch-tag\fR(1)\r
 143 > -- \r
 144 > 1.7.12.1\r
 145 >\r
 146 > _______________________________________________\r
 147 > notmuch mailing list\r
 148 > notmuch@notmuchmail.org\r
 149 > http://notmuchmail.org/mailman/listinfo/notmuch\r