Return-Path: X-Original-To: notmuch@notmuchmail.org Delivered-To: notmuch@notmuchmail.org Received: from localhost (localhost [127.0.0.1]) by olra.theworths.org (Postfix) with ESMTP id D8282429E21 for ; Fri, 16 Dec 2011 08:01:48 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org X-Spam-Flag: NO X-Spam-Score: -2.3 X-Spam-Level: X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5 tests=[RCVD_IN_DNSWL_MED=-2.3] autolearn=unavailable Received: from olra.theworths.org ([127.0.0.1]) by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Mhvl8IMDSfpC for ; Fri, 16 Dec 2011 08:01:48 -0800 (PST) Received: from tempo.its.unb.ca (tempo.its.unb.ca [131.202.1.21]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by olra.theworths.org (Postfix) with ESMTPS id 98FDC431FD0 for ; Fri, 16 Dec 2011 08:01:48 -0800 (PST) Received: from zancas.localnet (fctnnbsc36w-156034079193.pppoe-dynamic.High-Speed.nb.bellaliant.net [156.34.79.193]) (authenticated bits=0) by tempo.its.unb.ca (8.13.8/8.13.8) with ESMTP id pBGG1heY017747 (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NO); Fri, 16 Dec 2011 12:01:46 -0400 Received: from bremner by zancas.localnet with local (Exim 4.77) (envelope-from ) id 1RbaEA-0004oY-Q0; Fri, 16 Dec 2011 12:01:42 -0400 From: David Bremner To: "Notmuch Mail" Subject: have "notmuch help" call man? User-Agent: Notmuch/0.10.2+100~g430fb27 (http://notmuchmail.org) Emacs/23.3.1 (x86_64-pc-linux-gnu) Date: Fri, 16 Dec 2011 12:01:42 -0400 Message-ID: <87zkescxp5.fsf@zancas.localnet> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.13 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: Fri, 16 Dec 2011 16:01:49 -0000 Hi All; Currently help strings are compiled into the notmuch binary. This is a bit a of pain, since we have the same help text in two places. What do you think about having "notmuch help foo" invoke "man notmuch-foo" and create appropriate man pages (or links). There are other ways around the maintenance dilemma, including generating man pages and online help from some common source (e.g. in the style of id:"1288804736-5173-3-git-send-email-david@tethera.net"). For downsides, it might complicate things slightly for people who install notmuch in "odd" places. On the other hand, it is no worse than setting LD_LIBRARY_PATH. Also, there is the question of common text like search-terms, which could be included in every page, or maybe contained in man notmuch. David