b8/e32120e3d5f348fba26522886d30002a586c3b

   1 Return-Path: <bremner@unb.ca>\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 14BD8429E25\r
   6         for <notmuch@notmuchmail.org>; Fri, 11 Nov 2011 15:55:23 -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: -2.3\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_MED=-2.3] 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 VlxbwbHGEOyC for <notmuch@notmuchmail.org>;\r
  16         Fri, 11 Nov 2011 15:55:22 -0800 (PST)\r
  17 Received: from tempo.its.unb.ca (tempo.its.unb.ca [131.202.1.21])\r
  18         (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 61ECC431FB6\r
  21         for <notmuch@notmuchmail.org>; Fri, 11 Nov 2011 15:55:22 -0800 (PST)\r
  22 Received: from rocinante.cs.unb.ca (14.134.108.206.static.addr.dsl4u.ca\r
  23         [206.108.134.14] (may be forged)) (authenticated bits=0)\r
  24         by tempo.its.unb.ca (8.13.8/8.13.8) with ESMTP id pABNtGqK025018\r
  25         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NO);\r
  26         Fri, 11 Nov 2011 19:55:17 -0400\r
  27 Received: from bremner by rocinante.cs.unb.ca with local (Exim 4.76)\r
  28         (envelope-from <bremner@unb.ca>)\r
  29         id 1RP0wG-0001gq-2X; Fri, 11 Nov 2011 18:55:16 -0500\r
  30 From: David Bremner <david@tethera.net>\r
  31 To: Jameson Graef Rollins <jrollins@finestructure.net>,\r
  32  notmuch@notmuchmail.org\r
  33 Subject: Re: [PATCH v3] contrib/nmbug: new script for sharing tags with a\r
  34         given prefix.\r
  35 In-Reply-To: <877h36fdgb.fsf@servo.finestructure.net>\r
  36 References: <1320627586-10068-1-git-send-email-david@tethera.net>\r
  37         <1321024095-6387-1-git-send-email-david@tethera.net>\r
  38         <877h36fdgb.fsf@servo.finestructure.net>\r
  39 User-Agent: Notmuch/0.9+51~g0234a16 (http://notmuchmail.org) Emacs/23.3.1\r
  40         (x86_64-pc-linux-gnu)\r
  41 Date: Fri, 11 Nov 2011 18:55:15 -0500\r
  42 Message-ID: <87ty6a9puk.fsf@rocinante.cs.unb.ca>\r
  43 MIME-Version: 1.0\r
  44 Content-Type: text/plain; charset=us-ascii\r
  45 X-BeenThere: notmuch@notmuchmail.org\r
  46 X-Mailman-Version: 2.1.13\r
  47 Precedence: list\r
  48 List-Id: "Use and development of the notmuch mail system."\r
  49         <notmuch.notmuchmail.org>\r
  50 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  51         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  52 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  53 List-Post: <mailto:notmuch@notmuchmail.org>\r
  54 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  55 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  56         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  57 X-List-Received-Date: Fri, 11 Nov 2011 23:55:23 -0000\r
  58 \r
  59 On Fri, 11 Nov 2011 15:26:28 -0800, Jameson Graef Rollins <jrollins@finestructure.net> wrote:\r
  60 > On Fri, 11 Nov 2011 10:08:15 -0500, David Bremner <david@tethera.net> wrote:\r
  61 > > The most important commands are\r
  62 > > \r
  63 > >     commit  xapian -> git\r
  64 > >     checkout        git -> xapian\r
  65 > >     merge   fetched git + git -> xapian\r
  66 > >     status  find differences between xapian, git, and remote git.\r
  67 > \r
  68 > Hey, David.  Just for clarification, the above seems a little\r
  69 > inconsistent with the documentation included with the script, which\r
  70 > implies that the "most common commands", which are I believe meant to be\r
  71 > the only ones that the user should routinely have to use, are "commit",\r
  72 > "push", and "pull".  I got the impression that "checkout" and "merge"\r
  73 > should only be needed if you're trying to recover a broken system.\r
  74 \r
  75 Hi Jamie;\r
  76 \r
  77 I think the commit message and the online help are aimed a different\r
  78 audience, so it is not crucial (or even desirable) that they be exactly\r
  79 the same.  Perhaps it would be more clear to say that these are the\r
  80 "non-trivial" commands.\r
  81 \r
  82 The "most commonly used commands" could be retitled "the minimal set of\r
  83 commands to use nmbug". My own workflow involves fetch, merge, and the\r
  84 occasional checkout. Your might or might not; in my case it has to do\r
  85 with the fact that I am syncing tags in several different ways.\r
  86 \r
  87 > > There are also some convenience wrappers around git commands.\r
  88 > Isn't much of nmbug "convenience wrappers around git commands"? \r
  89 \r
  90 The distinction I'm trying to make here is between one-liners like\r
  91 "fetch" and slightly hairy things like "commit", where I had to learn\r
  92 new things about git to implement the latter.\r
  93 \r
  94 > It seems to me that the fact that nmbug is using git underneath should\r
  95 > be almost completely abstracted away from the user.\r
  96 \r
  97 Well, in the sense that user should not normally have to use raw git\r
  98 commands, I agree. I don't really see any point in hiding the fact that\r
  99 it is using git e.g. in the documentation.  It doesn't seem likely that\r
 100 nmbug will support more than one version control system without a\r
 101 complete rewrite.\r
 102 \r
 103 And of course the commit messages are supposed to tell how things work,\r
 104 so no point being coy there.\r
 105 \r
 106 d\r