From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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--