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 CB7F86DE12DD for ; Tue, 19 Mar 2019 12:07:02 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org X-Spam-Flag: NO X-Spam-Score: -0.015 X-Spam-Level: X-Spam-Status: No, score=-0.015 tagged_above=-999 required=5 tests=[AWL=-0.014, 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 YXzL8wwCj5Sy for ; Tue, 19 Mar 2019 12:07:01 -0700 (PDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by arlo.cworth.org (Postfix) with ESMTPS id AE91E6DE12B7 for ; Tue, 19 Mar 2019 12:07:01 -0700 (PDT) Received: from remotemail by fethera.tethera.net with local (Exim 4.89) (envelope-from ) id 1h6K4i-0008Gk-3A; Tue, 19 Mar 2019 15:07:00 -0400 Received: (nullmailer pid 3834 invoked by uid 1000); Tue, 19 Mar 2019 19:06:59 -0000 From: David Bremner To: Jani Nikula , notmuch@notmuchmail.org Subject: Re: [PATCH] doc: add support for adding configure options as Sphinx tags In-Reply-To: <20190319190146.26155-1-jani@nikula.org> References: <20190319190146.26155-1-jani@nikula.org> Date: Tue, 19 Mar 2019 16:06:59 -0300 Message-ID: <87bm26fzu4.fsf@tethera.net> MIME-Version: 1.0 Content-Type: text/plain X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.29 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: Tue, 19 Mar 2019 19:07:02 -0000 Jani Nikula writes: > Add the configure options specified in $(TAGS) that equal 1 as tags on > the Sphinx command line using the -t option. The tags may be used to > conditionally include documentation using the Sphinx "only" directive > [1]. > > As an example, indicate in the documentation whether the Xapian field > processor is likely to be available (assuming the notmuch binary was > built in the same environment as the documentation). > > [1] http://www.sphinx-doc.org/en/stable/markup/misc.html#including-content-based-on-tags > > --- > > This is something I wrote two years ago, ISTR David asking about > something like this on IRC, but I've already forgotten what it was > about... The urgent-ish issue is getting the docs building without emacs. Hopefully similar technology can comment out the emacs docs from the sphinx index page? d