From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id UKISMrvw1F46BQAA0tVLHw (envelope-from ) for ; Mon, 01 Jun 2020 12:12:43 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id uCTNLbvw1F5iSwAAbx9fmQ (envelope-from ) for ; Mon, 01 Jun 2020 12:12:43 +0000 Received: from arlo.cworth.org (arlo.cworth.org [50.126.95.6]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 2C3A69400EF for ; Mon, 1 Jun 2020 12:12:41 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id A46EB6DE024E; Mon, 1 Jun 2020 05:12:36 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org 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 shKj85ktt6Fv; Mon, 1 Jun 2020 05:12:36 -0700 (PDT) Received: from arlo.cworth.org (localhost [IPv6:::1]) by arlo.cworth.org (Postfix) with ESMTP id 8EC386DE024F; Mon, 1 Jun 2020 05:12:35 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id B87CE6DE024F for ; Mon, 1 Jun 2020 05:12:33 -0700 (PDT) X-Virus-Scanned: Debian amavisd-new at cworth.org 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 QeJ9z3qh7jka for ; Mon, 1 Jun 2020 05:12:31 -0700 (PDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by arlo.cworth.org (Postfix) with ESMTPS id B0F046DE024E for ; Mon, 1 Jun 2020 05:12:31 -0700 (PDT) Received: from remotemail by fethera.tethera.net with local (Exim 4.92) (envelope-from ) id 1jfjIr-00042j-9r; Mon, 01 Jun 2020 08:12:29 -0400 Received: (nullmailer pid 291486 invoked by uid 1000); Mon, 01 Jun 2020 12:12:27 -0000 From: David Bremner To: Tomi Ollila , Daniel Kahn Gillmor , Notmuch Mail Subject: Re: [PATCH] doc: fix for out-of-tree builds of notmuch-emacs docs In-Reply-To: References: <87k10sz3wb.fsf@tethera.net> <20200531161503.4100110-1-david@tethera.net> Date: Mon, 01 Jun 2020 09:12:27 -0300 Message-ID: <87v9kbx9w4.fsf@tethera.net> MIME-Version: 1.0 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: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: notmuch-bounces@notmuchmail.org Sender: "notmuch" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 50.126.95.6 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Spam-Score: -1.01 X-TUID: 9JF5jGj6Okq+ Tomi Ollila writes: > On Sun, May 31 2020, David Bremner wrote: > >> The sphinx-doc include directive does not have the ability to include >> files from the build tree, so we replace the include with reading the >> files in conf.py. The non-trivial downside of this is that the emacs >> docstrings are now defined for every rst source file. They are >> namespaced with docstring::, so hopefully there will not be any >> surprises. One thing that is noticable is a small (absolute) time >> penalty in running sphinx-doc. > > IMO good enough tolerable hack to get this done for no (read: I don't > know alternatives). > > Some comments below... Pushed a version with most of Tomi's comments applied (and s/append/extend/) d