--- /dev/null
+Return-Path: <wking@tremily.us>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+ by olra.theworths.org (Postfix) with ESMTP id CFD5D431FBC\r
+ for <notmuch@notmuchmail.org>; Sun, 5 Oct 2014 08:47:43 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5\r
+ tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001]\r
+ autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+ by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+ with ESMTP id XXvyCefL5BdU for <notmuch@notmuchmail.org>;\r
+ Sun, 5 Oct 2014 08:47:36 -0700 (PDT)\r
+Received: from resqmta-po-08v.sys.comcast.net (resqmta-po-08v.sys.comcast.net\r
+ [96.114.154.167])\r
+ (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
+ (No client certificate requested)\r
+ by olra.theworths.org (Postfix) with ESMTPS id 2FB6E431FB6\r
+ for <notmuch@notmuchmail.org>; Sun, 5 Oct 2014 08:47:36 -0700 (PDT)\r
+Received: from resomta-po-15v.sys.comcast.net ([96.114.154.239])\r
+ by resqmta-po-08v.sys.comcast.net with comcast\r
+ id zTnU1o0015AAYLo01Tnaz3; Sun, 05 Oct 2014 15:47:34 +0000\r
+Received: from odin.tremily.us ([24.18.63.50])\r
+ by resomta-po-15v.sys.comcast.net with comcast\r
+ id zTnZ1o005152l3L01TnZuY; Sun, 05 Oct 2014 15:47:34 +0000\r
+Received: from mjolnir.tremily.us (unknown [192.168.0.150])\r
+ by odin.tremily.us (Postfix) with ESMTPS id 5FABA13F02B2;\r
+ Sun, 5 Oct 2014 08:47:32 -0700 (PDT)\r
+Received: (nullmailer pid 15029 invoked by uid 1000);\r
+ Sun, 05 Oct 2014 15:47:26 -0000\r
+From: "W. Trevor King" <wking@tremily.us>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH] NEWS: Document "nmbug: Translate to Python"\r
+Date: Sun, 5 Oct 2014 08:47:21 -0700\r
+Message-Id:\r
+ <30987ac1951b6703839d1ec8546c91f2e94935ac.1412523971.git.wking@tremily.us>\r
+X-Mailer: git-send-email 2.1.0.60.g85f0837\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
+ s=q20140121; t=1412524054;\r
+ bh=gXbQ9UMfAALzcs7kDxkHL6H/zv2uoLq+zu2CR7f41wI=;\r
+ h=Received:Received:Received:Received:From:To:Subject:Date:\r
+ Message-Id;\r
+ b=rfhWIzJmxlrQqcfJSEieOmRwhj09YCoetqyAhtpFdMagRin434Sle+wTt0EdYfdW1\r
+ CrzizY0G+TfW489akTSDxuvvwm31LVAHnRdiPMlbn97TPA4FkOlpqr1qFP9cA2fUZs\r
+ 3GG01gS89CDZQcF7iCuk4oLrOfKlO/SNn8vbIStVFK9Q6KNBlfoWxxEppA2Rr4rn8M\r
+ H4pVyAsPdVg9AfmbGofC+lHoe5mL1DgHM1+ovA66xpZC7+ogGYOaX82t9FPBV4QUy9\r
+ uwz1SvismsBHqOTD1cvyi8mu9mg9IB5tNve75JlHXHuoFU2Ma1xLZq7iDBCGSWb+Bj\r
+ lVUhxsLDfOzig==\r
+Cc: Tomi Ollila <tomi.ollila@iki.fi>, David Bremner <bremner@debian.org>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+ <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+ <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sun, 05 Oct 2014 15:47:44 -0000\r
+\r
+This is mostly culled from the commit message for 7f2cb3be (nmbug:\r
+Translate to Python, 2014-10-03). I realized while writing it that\r
+the 7f2cb3be commit message has:\r
+\r
+ * 'nmbug log' now execs 'git log', as there's no need to keep the\r
+ Python process around once we've launched Git there.\r
+\r
+But we dropped that exec in favor of the subprocess approach between\r
+v3 and v4, I just forgot to update the commit message [1].\r
+\r
+[1]: id:e630b6763e9d0771718afee41ea15b29bb4a1de8.1409935538.git.wking@tremily.us\r
+ http://article.gmane.org/gmane.mail.notmuch.general/19007\r
+---\r
+ NEWS | 48 ++++++++++++++++++++++++++++++++++++++++++++++++\r
+ 1 file changed, 48 insertions(+)\r
+\r
+diff --git a/NEWS b/NEWS\r
+index fa57e5d..c111dd0 100644\r
+--- a/NEWS\r
++++ b/NEWS\r
+@@ -22,6 +22,54 @@ Library changes\r
+ Add return status to notmuch_database_close and\r
+ notmuch_database_destroy\r
+ \r
++nmbug\r
++-----\r
++\r
++The Perl script has been translated to Python; you'll need Python 2.7\r
++or anything from the 3.x line. This gives us better control over\r
++subprocesses without resorting to third-party modules. Most of the\r
++user-facing interface is the same, but there are a few changes, where\r
++reproducing the original interface was too difficult or we saw a\r
++change to make the underlying Git interface accessible:\r
++\r
++* 'nmbug help' has been split between the general 'nmbug --help' and\r
++ the command-specific 'nmbug COMMAND --help'.\r
++\r
++* Commands are no longer split into "most common", "other useful", and\r
++ "less common" sets.\r
++\r
++* 'nmbug commit' now only uses a single argument for the optional\r
++ commit-message text.\r
++\r
++* The default repository for 'nmbug push' and 'nmbug fetch' is now the\r
++ current branch's upstream (branch.<name>.remote) instead of\r
++ 'origin'. When we have to, we extract this remote by hand, but\r
++ where possible we just call the Git command without a repository\r
++ argument, and leave it to Git to figure out the default.\r
++\r
++* 'nmbug push' accepts multiple refspecs if you want to explicitly\r
++ specify what to push. Otherwise, the refspec(s) pushed depend on\r
++ push.default. The Perl version hardcoded 'master' as the pushed\r
++ refspec.\r
++\r
++* 'nmbug pull' defaults to the current branch's upstream\r
++ (branch.<name>.remote and branch.<name>.merge) instead of hardcoding\r
++ 'origin' and 'master'. It also supports multiple refspecs if for\r
++ some crazy reason you need an octopus merge (but mostly to avoid\r
++ breaking consistency with 'git pull').\r
++\r
++* 'nmbug status' now catches stderr, and doesn't print errors like:\r
++\r
++ No upstream configured for branch 'master'\r
++\r
++ The Perl implementation had just learned to avoid crashing on that\r
++ case, but wasn't yet catching the dying subprocess's stderr.\r
++\r
++* 'nmbug archive' now accepts positional arguments for the tree-ish\r
++ and additional 'git archive' options. For example, you can run:\r
++\r
++ $ nmbug archive HEAD -- --format tar.gz\r
++\r
+ nmbug-status\r
+ ------------\r
+ \r
+-- \r
+2.1.0.60.g85f0837\r
+\r
projects / notmuch-archives.git / commitdiff