5f/46b2304e2be923821b8e0393d1ea30a66ce36b

   1 Return-Path: <wking@tremily.us>\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 3E7FA431FBD\r
   6         for <notmuch@notmuchmail.org>; Wed,  9 Apr 2014 14:01:18 -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.1\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.1 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         RCVD_IN_DNSWL_NONE=-0.0001] 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 wRaIoa2olCgJ for <notmuch@notmuchmail.org>;\r
  17         Wed,  9 Apr 2014 14:01:14 -0700 (PDT)\r
  18 Received: from qmta12.westchester.pa.mail.comcast.net\r
  19         (qmta12.westchester.pa.mail.comcast.net [76.96.59.227])\r
  20         by olra.theworths.org (Postfix) with ESMTP id 46F83431FBC\r
  21         for <notmuch@notmuchmail.org>; Wed,  9 Apr 2014 14:01:14 -0700 (PDT)\r
  22 Received: from omta14.westchester.pa.mail.comcast.net ([76.96.62.60])\r
  23         by qmta12.westchester.pa.mail.comcast.net with comcast\r
  24         id ntWi1n0061HzFnQ5Cx1B8k; Wed, 09 Apr 2014 21:01:11 +0000\r
  25 Received: from odin.tremily.us ([24.18.63.50])\r
  26         by omta14.westchester.pa.mail.comcast.net with comcast\r
  27         id nx191n00K152l3L3ax1Ask; Wed, 09 Apr 2014 21:01:11 +0000\r
  28 Received: by odin.tremily.us (Postfix, from userid 1000)\r
  29         id 0A2BC1144166; Wed,  9 Apr 2014 14:01:08 -0700 (PDT)\r
  30 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin;\r
  31         t=1397077269; bh=f8+nQx2bPLs8AUXHYdGNHNUlx6x+cCIZYClO6ARffco=;\r
  32         h=Date:From:To:Cc:Subject:References:In-Reply-To;\r
  33         b=jl5sBhW0skAY1dhRXaZLuslnMpPciSy0/uim4tbTF1ZUoM1xfDsYvgIPqmCrAeRKf\r
  34         mfsKHqeZyc4euoZvq9SN3sensRtDheAAaW7ZfvupYEqjJTjUa+sv9eSTrMjAb+Mhsa\r
  35         adIYYtLmutT4U/9Ljuq3yXV1hrSWdBE6z5BTaPbs=\r
  36 Date: Wed, 9 Apr 2014 14:01:08 -0700\r
  37 From: "W. Trevor King" <wking@tremily.us>\r
  38 To: David Bremner <david@tethera.net>\r
  39 Subject: Re: [PATCH] NEWS: Document the recent 'nmbug clone' and @{upstream}\r
  40         changes\r
  41 Message-ID: <20140409210108.GB21805@odin.tremily.us>\r
  42 References: <878urg849d.fsf@zancas.localnet>\r
  43         <151b4a1b9612daa53fb47b60f0aa65f7a8e5ef5e.1396972599.git.wking@tremily.us>\r
  44         <871tx67nnx.fsf@zancas.localnet>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: multipart/signed; micalg=pgp-sha1;\r
  47         protocol="application/pgp-signature"; boundary="/WwmFnJnmDyWGHa4"\r
  48 Content-Disposition: inline\r
  49 In-Reply-To: <871tx67nnx.fsf@zancas.localnet>\r
  50 OpenPGP: id=39A2F3FA2AB17E5D8764F388FC29BDCDF15F5BE8;\r
  51         url=http://tremily.us/pubkey.txt\r
  52 User-Agent: Mutt/1.5.22 (2013-10-16)\r
  53 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
  54         s=q20140121; t=1397077271;\r
  55         bh=06bl5L1ciZ9nBPB1MRxtK4P7VNOCpdLg36yNOASXzgU=;\r
  56         h=Received:Received:Received:Date:From:To:Subject:Message-ID:\r
  57         MIME-Version:Content-Type;\r
  58         b=DM8QjImy0kEJiPpToSlxTvK4rKwabm75bOrD3btSmKKozgE9Q7sNeGt9/60uPVOcs\r
  59         pP0rRFdUvN59yWP0lR2aN/GeoAjBiGQoqxb4dgupmI1Z7bUGB6ZExRqXq49isyDtUB\r
  60         GsnTmekmYqLAqvKBWkWtE3Gn0ZnxDQBE/AokZvdwfwQlXnpbOt5cf7WIDWwie3XE5X\r
  61         sdk0afeK966hzdtlCCqXZheqmVTLPAcuEN43085UQmXopoDG2xfc3Vi+G09HDiGxny\r
  62         u/AHDmmg0RbPqgyLgzkbmAOy4Boj0yAR37b1RkNlq0NwswgjlYidE1rEqhsPlEk4YY\r
  63         ebglx9vsgFQMg==\r
  64 Cc: notmuch <notmuch@notmuchmail.org>\r
  65 X-BeenThere: notmuch@notmuchmail.org\r
  66 X-Mailman-Version: 2.1.13\r
  67 Precedence: list\r
  68 List-Id: "Use and development of the notmuch mail system."\r
  69         <notmuch.notmuchmail.org>\r
  70 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  72 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  73 List-Post: <mailto:notmuch@notmuchmail.org>\r
  74 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  75 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  77 X-List-Received-Date: Wed, 09 Apr 2014 21:01:18 -0000\r
  78 \r
  79 \r
  80 --/WwmFnJnmDyWGHa4\r
  81 Content-Type: text/plain; charset=utf-8\r
  82 Content-Disposition: inline\r
  83 Content-Transfer-Encoding: quoted-printable\r
  84 \r
  85 On Wed, Apr 09, 2014 at 08:22:26AM -0300, David Bremner wrote:\r
  86 > W. Trevor King writes:\r
  87 >=20\r
  88 > > The changes just landed with c200167 (nmbug: Add 'clone' and replace\r
  89 > > FETCH_HEAD with @{upstream}, 2014-03-09).\r
  90 > >\r
  91 > > The preferred markup language for NEWS seems to be Markdown, which is\r
  92 > > parsed by devel/news2wiki.pl into Markdown chunks for rendering by\r
  93 > > ikiwiki [1].\r
  94 > >\r
  95 > > [1]: http://notmuchmail.org/news/\r
  96 > > ---\r
  97 > >  NEWS | 20 ++++++++++++++++++++\r
  98 > >  1 file changed, 20 insertions(+)\r
  99 > >\r
 100 > > diff --git a/NEWS b/NEWS\r
 101 > > index d4f4ea4..e26fa0a 100644\r
 102 > > --- a/NEWS\r
 103 > > +++ b/NEWS\r
 104 > > @@ -20,6 +20,26 @@ Bug fix for saved searches with newlines in them.\r
 105 > >    Split lines confuse `notmuch count --batch`, so we remove embedded\r
 106 > >    newlines before calling notmuch count.\r
 107 > > =20\r
 108 > > +nmbug\r
 109 > > +-----\r
 110 > > +\r
 111 > > +nmbug adds a `clone` command for setting up the initial repository and\r
 112 > > +uses `@{upstream}` instead of `FETCH_HEAD` to track upstream changes.\r
 113 > > +\r
 114 > > +  The `@{upstream}` change reduces ambiguity when fetching multiple\r
 115 > > +  branches, but requires existing users update their bare `NMBGIT`\r
 116 > > +  repository (usually `~/.nmbug`) to a non-bare repository.  The\r
 117 > > +  easiest way to do this is:\r
 118 >=20\r
 119 > That bit about non-bare seems to be untrue/misleading?\r
 120 \r
 121 The old repositories were bare [1]:\r
 122 \r
 123   git clone --bare http://nmbug.tethera.net/git/nmbug-tags.git $HOME/.nmbug\r
 124 \r
 125 the new repositories are not [2]:\r
 126 \r
 127     system ('git', 'clone', '--no-checkout', '--separate-git-dir', $NMBGIT,\r
 128             $repository, $tempwork) =3D=3D 0\r
 129 \r
 130 We need non-bare repositories to have remote-tracking branches\r
 131 (distinct from local branches) [3], and we need remote-tracking\r
 132 branches to have working @{upstream}.\r
 133 \r
 134 I think that's reasonable support for my claim (and most of it is in\r
 135 the original c200167 commit message), but maybe not?\r
 136 \r
 137 > As a step 0, I guess commit any tag changes to nmbug?\r
 138 > > +\r
 139 > > +  1. Push any local commits to a remote repository.\r
 140 > > +  2. Remove your `NMBGIT` repository (e.g. `mv .nmbug .nmbug.bak`).\r
 141 > > +  3. Use the new `clone` command to create a fresh clone:\r
 142 > > +\r
 143 > > +        nmbug clone nmbug@nmbug.tethera.net:nmbug-tags\r
 144 > > +\r
 145 >=20\r
 146 > Jani mentioned on IRC that some people might track nmbug in a read only\r
 147 > way via git://\r
 148 \r
 149 Sure.  The current docs suggest HTTP [1], so I'm fine changing this to\r
 150 the HTTP URL (or the Git URL).  I think folks will get the idea\r
 151 regardless.  I can resubmit v2 with this update, or you can just\r
 152 squash it in if/when this patch lands in master, whatever is easiest.\r
 153 \r
 154 > > +  4. If you had local commits in step 1, add a remote for that\r
 155 > > +     repository and fetch them into the new repository.\r
 156 >=20\r
 157 > Is the "remote repository" in step 1 meant to be the central repo? or\r
 158 > just a backup?\r
 159 \r
 160 The backup.  If you have nothing to backup, you already got everything\r
 161 back after cloning the central repo.\r
 162 \r
 163 Cheers,\r
 164 Trevor\r
 165 \r
 166 [1]: http://notmuchmail.org/nmbug/\r
 167 [2]: http://git.notmuchmail.org/git/notmuch/blob/c20016742681e1ed48c83de326=\r
 168 39e10507ffa14d:/devel/nmbug/nmbug#l133\r
 169 [3]: http://git.kernel.org/cgit/git/git.git/tree/Documentation/git-clone.tx=\r
 170 t    =20\r
 171   --bare::\r
 172         Make a 'bare' Git repository=E2=80=A6\r
 173         Also the branch heads at the remote are copied directly\r
 174         to corresponding local branch heads, without mapping\r
 175         them to `refs/remotes/origin/`.  When this option is\r
 176         used, neither remote-tracking branches nor the related\r
 177         configuration variables are created.\r
 178 \r
 179 \r
 180 --=20\r
 181 This email may be signed or encrypted with GnuPG (http://www.gnupg.org).\r
 182 For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy\r
 183 \r
 184 --/WwmFnJnmDyWGHa4\r
 185 Content-Type: application/pgp-signature; name="signature.asc"\r
 186 Content-Description: OpenPGP digital signature\r
 187 \r
 188 -----BEGIN PGP SIGNATURE-----\r
 189 Version: GnuPG v2.0.22 (GNU/Linux)\r
 190 \r
 191 iQIcBAEBAgAGBQJTRbUSAAoJEKKfehoaNkbtSHAP/1/ymAREoL5Qzlz8H46toOZk\r
 192 ci6KmKxeajUZKs4JMl8hwrr/cyBrPPYqCcim6xHPVXrd6puQBmuOBn+W1X7h15Zo\r
 193 SOZcbISNwWuYV0/jJ5uE7hAV1Qk2waxJ3gTk9/cMgvCjryYjBQuzDw8Va4PccsrD\r
 194 5G/A6OouKADOnypG/YJ/4WJZJPVpXoKclmKnK6R3PK32rzqtQWJkRq3JrPyXT+/L\r
 195 ZWAsmHgxDeuMKsB8KdrAUzDNCNVa+WdeKPM9WO0TyK3lYy9qFaaEETOKXXFE22SB\r
 196 NEF+x6TBzUq5UPqNiKcw1n4tZSeRrqYad2E0/bAiaywNPSUN3M3sps2Zawi5CNUZ\r
 197 cl/xSyRLw67t0wEDOoiP3Tv5rZa8xR7F3dtQiEfTvV0Os2P9/EZoIKLzxETZVtXh\r
 198 BaqxB3nr8Dt4IUjQYoMCCnGony5jpGOEMKXfZ2sES/l/DdWMi/FSwmNRGaTNtzaW\r
 199 VCTun+bg1bw5WXvJLu6WjYkPXyt12yF9Q+ZrjtlmIfG08oIcv+E2Uf8CqGYAbjIq\r
 200 9dYUFYC4fDSNHo0/PVP8WFSEm0n674u5zMmAMS9ZRZExPCY6W82TW/H4j6whhV9K\r
 201 K2PUWXmBFse7eRGJPElHMZcBFbbXiNRr0aeEMB1IDt+0FunDSS3gAL67Bs2kW9E6\r
 202 IkqfzaeWft3fV3jatLy9\r
 203 =KwGQ\r
 204 -----END PGP SIGNATURE-----\r
 205 \r
 206 --/WwmFnJnmDyWGHa4--\r