From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id WCVuHgdMzV77HAAA0tVLHw (envelope-from ) for ; Tue, 26 May 2020 17:04:07 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id cC9aGgdMzV4PYQAAB5/wlQ (envelope-from ) for ; Tue, 26 May 2020 17:04:07 +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 4C6D2940983 for ; Tue, 26 May 2020 17:04:05 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id B51686DE13A5; Tue, 26 May 2020 10:04:01 -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 UhuNEq8T27rp; Tue, 26 May 2020 10:04:01 -0700 (PDT) Received: from arlo.cworth.org (localhost [IPv6:::1]) by arlo.cworth.org (Postfix) with ESMTP id 863296DE13BE; Tue, 26 May 2020 10:03:57 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by arlo.cworth.org (Postfix) with ESMTP id DC8E06DE13BE for ; Tue, 26 May 2020 10:03: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 2lSwEdElny4o for ; Tue, 26 May 2020 10:03:55 -0700 (PDT) Received: from che.mayfirst.org (unknown [162.247.75.117]) by arlo.cworth.org (Postfix) with ESMTPS id 197FE6DE13A5 for ; Tue, 26 May 2020 10:03:55 -0700 (PDT) DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/simple; d=fifthhorseman.net; i=@fifthhorseman.net; q=dns/txt; s=2019; t=1590512633; h=from : to : subject : date : message-id : mime-version : content-type : from; bh=yKHVxSGqPKhGdt3UKJnCBRqUTvzJw5+V8S+0TlFR/qA=; b=TJPz+7mgunAnGoiScFkeaJNNqmjT73Dw6Nyjh+S84hcuN3Bn4WmcPP07PvlM1YVmrGyMA aRJ87hQDi9y6KZiBA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=fifthhorseman.net; i=@fifthhorseman.net; q=dns/txt; s=2019rsa; t=1590512633; h=from : to : subject : date : message-id : mime-version : content-type : from; bh=yKHVxSGqPKhGdt3UKJnCBRqUTvzJw5+V8S+0TlFR/qA=; b=ztGP/XJw8z99Wf7hAQT9WfG4d5EKFm6mVJ8y3mQ+NMdODF/8e2lNfVrYyXq0gYkRnsMaA dKqkYqIieK7gNfgGEwsPfU9Dd8RZtryMzHyJMjsYx7xD7X6h7zMoJSHj94qcsW2aNsTUJ3Z XLqVuCSs04ux48b6y4RgkuF8AOO8c6119Wguov+2PTUEYzfdbPrjjZQQyNsAJrPuRQlApm7 3cMtc6Vs9FSXZoxJvjO3jrlWNSUAePj9KREcogoBGky/ohV1jXlFhPyIQ6nr7onz6idtVbs po4wgWaZ8co7LvJni78oNTwqsLJYUy4E6PQT2lM6d5WZDeNAskIIbWePw6xQ== Received: from fifthhorseman.net (unknown [IPv6:2001:470:1f07:60d:f2de:f1ff:fec3:d109]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by che.mayfirst.org (Postfix) with ESMTPSA id 7308CF9A5 for ; Tue, 26 May 2020 13:03:53 -0400 (EDT) Received: by fifthhorseman.net (Postfix, from userid 1000) id 45E3C20269; Tue, 26 May 2020 13:03:50 -0400 (EDT) From: Daniel Kahn Gillmor To: Notmuch Mail Subject: doc build warnings when building out-of-tree Autocrypt: addr=dkg@fifthhorseman.net; prefer-encrypt=mutual; keydata= mDMEXEK/AhYJKwYBBAHaRw8BAQdAr/gSROcn+6m8ijTN0DV9AahoHGafy52RRkhCZVwxhEe0K0Rh bmllbCBLYWhuIEdpbGxtb3IgPGRrZ0BmaWZ0aGhvcnNlbWFuLm5ldD6ImQQTFggAQQIbAQULCQgH AgYVCgkICwIEFgIDAQIeAQIXgAIZARYhBMS8Lds4zOlkhevpwvIGkReQOOXGBQJd5Hw3BQkFpJWB AAoJEPIGkReQOOXGDYEA/j0ERjPxDleKMZ2LDcWc/3o5cLFwAVzBKQHppu0Be5IWAP0aeTnyEqlp RTE7M8zugwkhYeUYfYu0BjecDUMnYz6iDLgzBF3kewUWCSsGAQQB2kcPAQEHQK1IuW0GZmcrs2mx CYMl8IHse0tMF8cP7eBNXevrlx2ZiPUEGBYIACYCGwIWIQTEvC3bOMzpZIXr6cLyBpEXkDjlxgUC XeR7TwUJAiGl/gCBdiAEGRYIAB0WIQQsv6x2UaqQJzY+dXHEDyVUMvKBDwUCXeR7BQAKCRDEDyVU MvKBD7KmAQCHs+7588C4jto6fMje0Nu97zzoppjJM7lrGF2rVnbHvwD+MgmGUbHzPSUrTWnZBQDi /QM595bxNrBA4N1CiXhs2AMJEPIGkReQOOXGpp0BAM7YeBnt/UNvxJAGm4DidSfHU7RDMWe6Tgux HrH21cDkAQC9leNFXJsQ7F2ZniRPHa8CkictcQEKPL8VCWpfe8LbArg4BF3ke5wSCisGAQQBl1UB BQEBB0Cf+EiAXtntQMf51xpqb6uZ5O0eCLAZtkg0SXHjA1JlEwMBCAeIfgQYFggAJhYhBMS8Lds4 zOlkhevpwvIGkReQOOXGBQJd5HucAhsMBQkCIaVkAAoJEPIGkReQOOXGdYcBANYnW7VyL2CncKH1 iO4Zr0IwfdIv6rai1PUHL98pVi3cAP9tMh85CKGDa0Xi/fptQH41meollLW5tLb/bEWMuUNuBQ== Date: Tue, 26 May 2020 13:03:49 -0400 Message-ID: <87wo4yhbm2.fsf@fifthhorseman.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: multipart/mixed; boundary="===============9177012642903236002==" Errors-To: notmuch-bounces@notmuchmail.org Sender: "notmuch" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (body hash did not verify) header.d=fifthhorseman.net header.s=2019 header.b=TJPz+7mg; dkim=fail (body hash did not verify) header.d=fifthhorseman.net header.s=2019rsa header.b=ztGP/XJw; dmarc=fail reason="SPF not aligned (relaxed)" header.from=fifthhorseman.net (policy=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: -2.01 X-TUID: a4CKvbJ7PX+V --===============9177012642903236002== Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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. --dkg WITH_EMACS=3D1 sphinx-build -b man -d doc/_build/man_doctrees -q ../doc doc= /_build/man /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:383: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch.rsti'. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:385: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-lib.rsti= '. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:387: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-show.rst= i'. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:389: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-tag.rsti= '. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:220: WARNING: Undefined= substitution referenced: "docstring::notmuch-message-headers". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:223: WARNING: Undefined= substitution referenced: "docstring::notmuch-message-headers-visible". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:236: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-filename". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:239: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-git-send-email". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:242: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-message-id-strippe= d". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:245: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-mlarchive-link-and= -go". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:248: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-tags". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:251: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-cc". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:254: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-date". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:257: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-from". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:260: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-message-id". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:263: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-mlarchive-link". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:266: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-subject". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:269: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-to". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:347: WARNING: Undefined= substitution referenced: "docstring::notmuch-tagging-keys". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:353: WARNING: Undefined= substitution referenced: "docstring::notmuch-cycle-notmuch-buffers". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:364: WARNING: Undefined= substitution referenced: "docstring::notmuch-poll". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:367: WARNING: Undefined= substitution referenced: "docstring::notmuch-poll-script". [=E2=80=A6] WITH_EMACS=3D1 sphinx-build -b texinfo -d doc/_build/texinfo_doctrees -q ..= /doc doc/_build/texinfo /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:383: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch.rsti'. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:385: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-lib.rsti= '. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:387: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-show.rst= i'. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:389: WARNING: Problems = with "include" directive path: InputError: [Errno 2] No such file or directory: '../emacs/notmuch-tag.rsti= '. /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:220: WARNING: Undefined= substitution referenced: "docstring::notmuch-message-headers". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:223: WARNING: Undefined= substitution referenced: "docstring::notmuch-message-headers-visible". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:236: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-filename". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:239: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-git-send-email". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:242: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-message-id-strippe= d". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:245: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-mlarchive-link-and= -go". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:248: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-tags". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:251: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-cc". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:254: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-date". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:257: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-from". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:260: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-message-id". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:263: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-mlarchive-link". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:266: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-subject". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:269: WARNING: Undefined= substitution referenced: "docstring::notmuch-show-stash-to". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:347: WARNING: Undefined= substitution referenced: "docstring::notmuch-tagging-keys". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:353: WARNING: Undefined= substitution referenced: "docstring::notmuch-cycle-notmuch-buffers". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:364: WARNING: Undefined= substitution referenced: "docstring::notmuch-poll". /home/dkg/src/notmuch/notmuch/doc/notmuch-emacs.rst:367: WARNING: Undefined= substitution referenced: "docstring::notmuch-poll-script". --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYIAB0WIQQsv6x2UaqQJzY+dXHEDyVUMvKBDwUCXs1L9QAKCRDEDyVUMvKB D1u1AP9j//bS8RUkHgR1r/HF0saugRqVh5Sr027PdAh7Rm7Y9AEAqYPcZFwxt5E+ 1hPsZENPXeOwlZFnss/M0KAabAeWNwo= =eFmN -----END PGP SIGNATURE----- --=-=-=-- --===============9177012642903236002== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --===============9177012642903236002==--