7c/e8c0c1b874bbdead101c6d7ce5cb25de3889b2

   1 Return-Path: <m.walters@qmul.ac.uk>\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 77C07431FAF\r
   6         for <notmuch@notmuchmail.org>; Sun, 25 Nov 2012 08:17:10 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -1.098\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-1.098 tagged_above=-999 required=5\r
  12         tests=[DKIM_ADSP_CUSTOM_MED=0.001, FREEMAIL_FROM=0.001,\r
  13         NML_ADSP_CUSTOM_MED=1.2, RCVD_IN_DNSWL_MED=-2.3] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id o4uGknE9uKyG for <notmuch@notmuchmail.org>;\r
  17         Sun, 25 Nov 2012 08:17:09 -0800 (PST)\r
  18 Received: from mail2.qmul.ac.uk (mail2.qmul.ac.uk [138.37.6.6])\r
  19         (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id 9E5C3431FAE\r
  22         for <notmuch@notmuchmail.org>; Sun, 25 Nov 2012 08:17:09 -0800 (PST)\r
  23 Received: from smtp.qmul.ac.uk ([138.37.6.40])\r
  24         by mail2.qmul.ac.uk with esmtp (Exim 4.71)\r
  25         (envelope-from <m.walters@qmul.ac.uk>)\r
  26         id 1TcetI-000699-4k; Sun, 25 Nov 2012 16:17:08 +0000\r
  27 Received: from 93-97-24-31.zone5.bethere.co.uk ([93.97.24.31] helo=localhost)\r
  28         by smtp.qmul.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.69)\r
  29         (envelope-from <m.walters@qmul.ac.uk>)\r
  30         id 1TcetH-0001XW-NC; Sun, 25 Nov 2012 16:17:07 +0000\r
  31 From: Mark Walters <markwalters1009@gmail.com>\r
  32 To: Peter Wang <novalazy@gmail.com>, notmuch@notmuchmail.org\r
  33 Subject: Re: [PATCH v2 19/20] man: document 'insert' command\r
  34 In-Reply-To: <1353806206-29133-20-git-send-email-novalazy@gmail.com>\r
  35 References: <1353806206-29133-1-git-send-email-novalazy@gmail.com>\r
  36         <1353806206-29133-20-git-send-email-novalazy@gmail.com>\r
  37 User-Agent: Notmuch/0.14+81~g9730584 (http://notmuchmail.org) Emacs/23.4.1\r
  38         (x86_64-pc-linux-gnu)\r
  39 Date: Sun, 25 Nov 2012 16:17:10 +0000\r
  40 Message-ID: <8738zxk67t.fsf@qmul.ac.uk>\r
  41 MIME-Version: 1.0\r
  42 Content-Type: text/plain; charset=us-ascii\r
  43 X-Sender-Host-Address: 93.97.24.31\r
  44 X-QM-SPAM-Info: Sender has good ham record.  :)\r
  45 X-QM-Body-MD5: ee7de07219567c631fef3a5ab54f1681 (of first 20000 bytes)\r
  46 X-SpamAssassin-Score: -1.8\r
  47 X-SpamAssassin-SpamBar: -\r
  48 X-SpamAssassin-Report: The QM spam filters have analysed this message to\r
  49         determine if it is\r
  50         spam. We require at least 5.0 points to mark a message as spam.\r
  51         This message scored -1.8 points.\r
  52         Summary of the scoring: \r
  53         * -2.3 RCVD_IN_DNSWL_MED RBL: Sender listed at http://www.dnswl.org/,\r
  54         *      medium trust\r
  55         *      [138.37.6.40 listed in list.dnswl.org]\r
  56         * 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail\r
  57         provider *      (markwalters1009[at]gmail.com)\r
  58         *  0.5 AWL AWL: From: address is in the auto white-list\r
  59 X-QM-Scan-Virus: ClamAV says the message is clean\r
  60 X-BeenThere: notmuch@notmuchmail.org\r
  61 X-Mailman-Version: 2.1.13\r
  62 Precedence: list\r
  63 List-Id: "Use and development of the notmuch mail system."\r
  64         <notmuch.notmuchmail.org>\r
  65 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  66         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  67 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  68 List-Post: <mailto:notmuch@notmuchmail.org>\r
  69 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  70 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  72 X-List-Received-Date: Sun, 25 Nov 2012 16:17:10 -0000\r
  73 \r
  74 On Sun, 25 Nov 2012, Peter Wang <novalazy@gmail.com> wrote:\r
  75 > Add initial documentation for notmuch insert command.\r
  76 > ---\r
  77 >  man/Makefile.local        |  1 +\r
  78 >  man/man1/notmuch-insert.1 | 60 +++++++++++++++++++++++++++++++++++++++++++++++\r
  79 >  2 files changed, 61 insertions(+)\r
  80 >  create mode 100644 man/man1/notmuch-insert.1\r
  81 >\r
  82 > diff --git a/man/Makefile.local b/man/Makefile.local\r
  83 > index 72e2a18..216aaa0 100644\r
  84 > --- a/man/Makefile.local\r
  85 > +++ b/man/Makefile.local\r
  86 > @@ -12,6 +12,7 @@ MAN1 := \\r
  87 >       $(dir)/man1/notmuch-count.1 \\r
  88 >       $(dir)/man1/notmuch-dump.1 \\r
  89 >       $(dir)/man1/notmuch-restore.1 \\r
  90 > +     $(dir)/man1/notmuch-insert.1 \\r
  91 >       $(dir)/man1/notmuch-new.1 \\r
  92 >       $(dir)/man1/notmuch-reply.1 \\r
  93 >       $(dir)/man1/notmuch-search.1 \\r
  94 > diff --git a/man/man1/notmuch-insert.1 b/man/man1/notmuch-insert.1\r
  95 > new file mode 100644\r
  96 > index 0000000..8b1c4e9\r
  97 > --- /dev/null\r
  98 > +++ b/man/man1/notmuch-insert.1\r
  99 > @@ -0,0 +1,60 @@\r
 100 > +.TH NOTMUCH-INSERT 1 2012-xx-xx "Notmuch 0.xx"\r
 101 > +.SH NAME\r
 102 > +notmuch-insert \- add a message to the maildir and notmuch database\r
 103 > +.SH SYNOPSIS\r
 104 > +\r
 105 > +.B notmuch insert\r
 106 > +.RI "[" options "]"\r
 107 > +.RI "[ +<" tag> "|\-<" tag "> ... ]"\r
 108 > +\r
 109 > +.SH DESCRIPTION\r
 110 > +\r
 111 > +.B notmuch insert\r
 112 > +reads a message from standard input\r
 113 > +and delivers it to the specified maildir folder,\r
 114 > +then incorporates the message into the notmuch database.\r
 115 > +It is an alternative to using a separate tool to deliver\r
 116 > +the message then running\r
 117 > +.B notmuch new\r
 118 > +afterwards.\r
 119 > +\r
 120 > +The new message will be tagged with the tags specified by the\r
 121 > +.B new.tags\r
 122 > +configuration option.\r
 123 > +Additional tagging operations may be specified on the command-line:\r
 124 > +tags prefixed by '+' are added while\r
 125 > +those prefixed by '\-' are removed.\r
 126 \r
 127 Is it worth emphasising that the command line tags are applied after the\r
 128 new tags so can be used to remove the new tags?\r
 129 \r
 130 Best wishes\r
 131 \r
 132 Mark\r
 133 \r
 134 > +Option arguments must appear before any tag operation arguments.\r
 135 > +Supported options for\r
 136 > +.B insert\r
 137 > +include\r
 138 > +.RS 4\r
 139 > +.TP 4\r
 140 > +.BI "--folder=<" folder ">"\r
 141 > +\r
 142 > +Deliver the message to the specified folder,\r
 143 > +relative to the top-level directory given by the value of\r
 144 > +\fBdatabase.path\fR.\r
 145 > +The default is to deliver to the top-level directory.\r
 146 > +\r
 147 > +.RE\r
 148 > +\r
 149 > +.RS 4\r
 150 > +.TP 4\r
 151 > +.B "--create-folder"\r
 152 > +\r
 153 > +Try to create the folder named by the\r
 154 > +.B "--folder"\r
 155 > +option, if it does not exist.\r
 156 > +Otherwise the folder must already exist for mail\r
 157 > +delivery to succeed.\r
 158 > +\r
 159 > +.RE\r
 160 > +.SH SEE ALSO\r
 161 > +\r
 162 > +\fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),\r
 163 > +\fBnotmuch-dump\fR(1), \fBnotmuch-hooks\fR(5), \fBnotmuch-reply\fR(1),\r
 164 > +\fBnotmuch-restore\fR(1), \fBnotmuch-search\fR(1),\r
 165 > +\fBnotmuch-search-terms\fR(7), \fBnotmuch-show\fR(1),\r
 166 > +\fBnotmuch-tag\fR(1)\r
 167 > -- \r
 168 > 1.7.12.1\r
 169 >\r
 170 > _______________________________________________\r
 171 > notmuch mailing list\r
 172 > notmuch@notmuchmail.org\r
 173 > http://notmuchmail.org/mailman/listinfo/notmuch\r