From 902da10e9a53b3bd7a44606c263dcb8ab1679fc9 Mon Sep 17 00:00:00 2001 From: "W. Trevor King" Date: Fri, 1 Jan 2016 12:28:15 +1600 Subject: [PATCH] Re: [PATCH 3/5] nmbug-status: Add an nmbug-status(5) man page --- 16/b6ed5b5695d5d1e5e130e9701c300e392361c9 | 153 ++++++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 16/b6ed5b5695d5d1e5e130e9701c300e392361c9 diff --git a/16/b6ed5b5695d5d1e5e130e9701c300e392361c9 b/16/b6ed5b5695d5d1e5e130e9701c300e392361c9 new file mode 100644 index 000000000..b58409071 --- /dev/null +++ b/16/b6ed5b5695d5d1e5e130e9701c300e392361c9 @@ -0,0 +1,153 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by arlo.cworth.org (Postfix) with ESMTP id 9C0AD6DE182F + for ; Thu, 31 Dec 2015 12:30:21 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at cworth.org +X-Spam-Flag: NO +X-Spam-Score: -0.008 +X-Spam-Level: +X-Spam-Status: No, score=-0.008 tagged_above=-999 required=5 tests=[AWL=0.093, + DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, + RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=disabled +Received: from arlo.cworth.org ([127.0.0.1]) + by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id GJUZHMu4zCHF for ; + Thu, 31 Dec 2015 12:30:19 -0800 (PST) +Received: from resqmta-po-11v.sys.comcast.net (resqmta-po-11v.sys.comcast.net + [96.114.154.170]) + by arlo.cworth.org (Postfix) with ESMTPS id 2BA1F6DE192A + for ; Thu, 31 Dec 2015 12:30:18 -0800 (PST) +Received: from resomta-po-06v.sys.comcast.net ([96.114.154.230]) + by resqmta-po-11v.sys.comcast.net with comcast + id 0LVx1s0034yXVJQ01LWHV4; Thu, 31 Dec 2015 20:30:17 +0000 +Received: from mail.tremily.us ([73.221.72.168]) + by resomta-po-06v.sys.comcast.net with comcast + id 0LUF1s00V3dr3C901LUG6B; Thu, 31 Dec 2015 20:28:17 +0000 +Received: by mail.tremily.us (Postfix, from userid 1000) + id B188A1B2DFB3; Thu, 31 Dec 2015 12:28:15 -0800 (PST) +DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin; + t=1451593695; bh=gHVOEvMZlCmMcxQA1ciRDXE29EwbMkYLb1C+LGtv1lc=; + h=Date:From:To:Cc:Subject:References:In-Reply-To; + b=AWNEAiU/qVhsP3ziNmQ3qas4+cUCsYlhWstpVKoaPd1JkNkpwUhghYt6idFcAnW2S + AT8EljyGoYxsl8QjlENGMMXkjACqOtYUi5e5q7NOGNfloDrZRYjOG+AYnVINdVnvgE + OvGmPy/m0iGO1M/aRfE2jg31JMAx7XrdiZGUYQw8= +Date: Thu, 31 Dec 2015 12:28:15 -0800 +From: "W. Trevor King" +To: David Bremner +Cc: Jani Nikula , notmuch@notmuchmail.org +Subject: Re: [PATCH 3/5] nmbug-status: Add an nmbug-status(5) man page +Message-ID: <20151231202815.GL3680@odin.tremily.us> +References: + <0a1bd306cb2e306ff49d72b6d2466c1d4a0ade2b.1451502495.git.wking@tremily.us> + <87ege26fi4.fsf@nikula.org> <87fuyi4iwm.fsf@zancas.localnet> +MIME-Version: 1.0 +Content-Type: multipart/signed; micalg=pgp-sha1; + protocol="application/pgp-signature"; boundary="0qVF/w3MHQqLSynd" +Content-Disposition: inline +In-Reply-To: <87fuyi4iwm.fsf@zancas.localnet> +OpenPGP: id=39A2F3FA2AB17E5D8764F388FC29BDCDF15F5BE8; + url=http://tremily.us/pubkey.txt +User-Agent: Mutt/1.5.23 (2014-03-12) +DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net; + s=q20140121; t=1451593817; + bh=j4rgZkchJgznlrWdvJN40/8lxkyB582zv87ojXAuVYY=; + h=Received:Received:Received:Date:From:To:Subject:Message-ID: + MIME-Version:Content-Type; + b=bKo5xzYg6V3kLO6IPZ5vNRh+IsmylNj5PoyTtqMXyRGNLnNewOqL7HPSv9OFLedx/ + NWgY+onNk4PlYKbUebXgAGMQgZsUOfM2sPQ6QNvZYhZj0yMLe2cxJY00EvzjTU5IIy + WaDIkb9pJCAWYyCGzmrtyavhhJcWrv2JGO3usTdco+/mqKP/kG1k3NUFylnUVblWnd + rL4HYrRUvucgzBlP4F8EsE3pur5prKw4o1q2LDcotWi5yw4FpkP+N1cpeHIao19NcN + KkdWo+GEm63dzDSR1hSwmHQBvE9fUEcqjOeYx3KB8unLFc2hBG1Y48UZiMZ9i5ry0c + ATkoIJXc7lu9w== +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.20 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Thu, 31 Dec 2015 20:30:21 -0000 + + +--0qVF/w3MHQqLSynd +Content-Type: text/plain; charset=utf-8 +Content-Disposition: inline +Content-Transfer-Encoding: quoted-printable + +On Thu, Dec 31, 2015 at 01:39:21PM -0400, David Bremner wrote: +> Jani Nikula writes: +> > I am wondering about the man page though. I find it slightly +> > confusing there would be a man page named after the tool +> > describing just the config, but not the tool itself. + +Yeah, a man page about the tool itself would be good. If I add one, +we'd have a situation like procmail(1) and procmailrc(5). One +difficulty for naming the config-file-format man page is that +status-config.json is not a particularly specific name. If we're +renaming the tools anyway, I'd suggest we just go with +${EVENTUAL_NMBUG_STATUS_NAME}.json for the default config filename and +man page. + +> For me it's a bit odd to have a man page for a tool we don't install +> by default. Is it maybe time to "promote" nmbug-status to the +> notmuch- namespace and install it by default? + +Sounds good to me. And Gentoo has installed it (if you've set the +=E2=80=98nmbug=E2=80=99 USE flag [1]) since 0.11.1-r1, 2012-02-21 [2]. I'm= + not sure +what the new names should be. nmbug =E2=86=92 notmuch-dtag (for distributed +tag) and nmbug-status =E2=86=92 notmuch-report? + +> That would have to be somehow tied to installing the python +> bindings; + +On Gentoo, that happens via REQUIRED_USE [3,4]. An alternative for +packaging systems without USE-flag-style flexibility would be to spin +them off into a separate project that depends on Git and notmuch's +Python bindings. + +Cheers, +Trevor + +[1]: https://gitweb.gentoo.org/repo/gentoo.git/tree/net-mail/notmuch/metada= +ta.xml +[2]: https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/net-mail/notm= +uch/ChangeLog?hideattic=3D0&revision=3D1.23&view=3Dmarkup +[3]: https://gitweb.gentoo.org/repo/gentoo.git/tree/net-mail/notmuch/notmuc= +h-0.21.ebuild?id=3D45ba77ab1dee61a2590c9f4903e620c5cf4d5f68#n23 +[4]: https://projects.gentoo.org/pms/6/pms.html#x1-890008.2.7 + +--=20 +This email may be signed or encrypted with GnuPG (http://www.gnupg.org). +For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy + +--0qVF/w3MHQqLSynd +Content-Type: application/pgp-signature; name="signature.asc" +Content-Description: OpenPGP digital signature + +-----BEGIN PGP SIGNATURE----- +Version: GnuPG v2 + +iQIcBAEBAgAGBQJWhY/cAAoJEAPqygegUbGsyvUQAId/Noszvtwx3dFn1qvqSXAH +/hMBL8QcihLG1CSVyWDY4v5MhLIaVnfwmorXX0FoEni6Evp2V3WCICmAAb1CTAcJ +8bjhUmb4Jw+GqJEfyk4c/GNUAG54z60bngR1QnlPzN+4a81v+ZHgucbdxZhp1a7h +xk4al6eiZeMIXkSmkZ/80xQ7ffwRRsAjx4CGZqkuB4vp145gcLin7d/dSCx1wSxf +O5ePNPmEQRRw0lVToqbHmg42Npc9WA4Ld7bhIULIOebvYSGRZQq+I+oEOtoXfE1l +nqo78prm7AeyZHKQcQmSuFIAqdwUWKXfxHsxo+iXGt3m5KkbLAXv4xErCCM2R+Bh +woEioJaZmP99HlZ7LYWtUwC0ssRme5DdsmaFwLMeb0/d94A1+tYJL8kxF8PCBZRY +Ovmr0gTrBBOQ+YfQaArFifCEwUdbla5jbkepkisHsBmw/8MTQ01zF8rEJMiETaLk +tb/vUvvQ/TWPYfIE37KU0rObIjAJ2RR59rAXC7a+JouhzycRjh90jjW7ktBLvs5/ +1uGnl9cP0q8JhTw3AOtPMeriVHkkPMW2ZBjUYmGrYTvZdJiTdG1AUXIL914zSo+X +AUu41T9TJaAjXwqcjrenYygRWFhn5nsv9i2B81IxL/XUHq+MgIw45fLLizrZQ8iG +qN259+xq7XuRDgIXkExY +=dUcr +-----END PGP SIGNATURE----- + +--0qVF/w3MHQqLSynd-- -- 2.26.2