From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id OP5wEs2J0l4gKQAA0tVLHw (envelope-from ) for ; Sat, 30 May 2020 16:29:01 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id uDJhDs2J0l5nSgAA1q6Kng (envelope-from ) for ; Sat, 30 May 2020 16:29:01 +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 D2FE594042B for ; Sat, 30 May 2020 16:28:59 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id 0AFA96DE0941; Sat, 30 May 2020 09:28:55 -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 xyLx9wj90FIK; Sat, 30 May 2020 09:28:54 -0700 (PDT) Received: from arlo.cworth.org (localhost [IPv6:::1]) by arlo.cworth.org (Postfix) with ESMTP id 8ACF16DE0361; Sat, 30 May 2020 09:28:53 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id AD1576DE0361 for ; Sat, 30 May 2020 09:28:52 -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 u6BMRZ43U6Nc for ; Sat, 30 May 2020 09:28:50 -0700 (PDT) Received: from fethera.tethera.net (fethera.tethera.net [198.245.60.197]) by arlo.cworth.org (Postfix) with ESMTPS id CACD76DE02AC for ; Sat, 30 May 2020 09:28:50 -0700 (PDT) Received: from remotemail by fethera.tethera.net with local (Exim 4.92) (envelope-from ) id 1jf4Lp-0000Ym-QD; Sat, 30 May 2020 12:28:49 -0400 Received: (nullmailer pid 597440 invoked by uid 1000); Sat, 30 May 2020 16:28:47 -0000 From: David Bremner To: Daniel Kahn Gillmor , Notmuch Mail Subject: Re: doc build warnings when building out-of-tree In-Reply-To: <87wo4yhbm2.fsf@fifthhorseman.net> References: <87wo4yhbm2.fsf@fifthhorseman.net> Date: Sat, 30 May 2020 13:28:47 -0300 Message-ID: <87367htmio.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: bJHzRekYKUlT Daniel Kahn Gillmor writes: > When building out-of-tree, the documentation (both manpages and info > files) are incomplete, but they do not explicitly fail. build logs > follow from doing "mkdir build && ../configure && make". > > If there's a way to make these warnings into hard failures, i think that > would be good -- we don't want to accidentally ship the output they > create. And of course actually fixing it would be even better. > > I'm afraid i'm not proficient enough in sphinx to know how to do either, > so i'm just reporting a bug for now. > I can't duplicate these errors with sphinx-doc 2.4.3-3 on Debian. Are the rsti files actually being built before calling sphinx-build? d