From nobody Sat Oct 09 21:20:56 2021 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 805C917EEFE0 for ; Sat, 9 Oct 2021 21:21:01 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HRdJs30D9z4kjH; Sat, 9 Oct 2021 21:21:01 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from auth1-smtp.messagingengine.com (auth1-smtp.messagingengine.com [66.111.4.227]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: dbaio/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 422CE24093; Sat, 9 Oct 2021 21:21:01 +0000 (UTC) (envelope-from dbaio@FreeBSD.org) Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailauth.nyi.internal (Postfix) with ESMTP id BEE0D27C0054; Sat, 9 Oct 2021 17:21:00 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Sat, 09 Oct 2021 17:21:00 -0400 X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrvddtvddgudehkecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfhfgggtuggjsehgtd erredttddvnecuhfhrohhmpedfffgrnhhilhhoucfirdcuuegrihhofdcuoegusggrihho sefhrhgvvgeuufffrdhorhhgqeenucggtffrrghtthgvrhhnpeeifeejueejtdeviefgte eugeegfedtjeeuteelkeeugeelkeevvdffffehtdehkeenucffohhmrghinhepfhhrvggv sghsugdrohhrghenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfh hrohhmpegusggrihhoodhmvghsmhhtphgruhhthhhpvghrshhonhgrlhhithihqdduudek udefleduvddtqddvieektddvjeeikedquggsrghioheppefhrhgvvgeuufffrdhorhhgse hfrghsthhmrghilhdrtghomh X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 9 Oct 2021 17:20:59 -0400 (EDT) Date: Sat, 9 Oct 2021 18:20:56 -0300 From: "Danilo G. Baio" To: John Baldwin Cc: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: Re: git: 5a5db32f4a - main - Fix build after c8e8be58e580 Message-ID: <20211009212056.khm7yupqjbdb6agd@t480.local> References: <202110062359.196NxFqS079143@gitrepo.freebsd.org> <0595c299-55ed-17c4-74ac-16a804541473@FreeBSD.org> <20211007205425.j4idybl7jrtwxeal@t480.local> List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="aba3tildclchg73u" Content-Disposition: inline In-Reply-To: X-ThisMailContainsUnwantedMimeParts: N --aba3tildclchg73u Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Oct 07, 2021 at 06:59:44PM -0300, Danilo G. Baio wrote: >=20 >=20 > On Thu, Oct 7, 2021, at 18:20, John Baldwin wrote: > > On 10/7/21 1:54 PM, Danilo G. Baio wrote: > >> On Thu, Oct 07, 2021 at 09:22:56AM -0700, John Baldwin wrote: > >>> On 10/6/21 4:59 PM, Danilo G. Baio wrote: > >>>> The branch main has been updated by dbaio: > >>>> > >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=3D5a5db32f4a1e3f507cdc5= 5f92d53e63adbb4f022 > >>>> > >>>> commit 5a5db32f4a1e3f507cdc55f92d53e63adbb4f022 > >>>> Author: Danilo G. Baio > >>>> AuthorDate: 2021-10-06 23:57:27 +0000 > >>>> Commit: Danilo G. Baio > >>>> CommitDate: 2021-10-06 23:57:27 +0000 > >>>> > >>>> Fix build after c8e8be58e580 > >>> > >>> It used to be possible to use 'make' in individual books or articles = to test > >>> things, and also to only build just html versions and not be required= to > >>> build PDF. Apparently our new system doesn't permit either of those,= so I > >>> gave up on trying to test this pre-commit. > >>> > >>> --=20 > >>> John Baldwin > >>=20 > >>=20 > >> To speed up the build time (right now), you can build only English HTML > >> documentation this way: > >>=20 > >> $ cd documentation > >> $ DOC_LANG=3D"en" make > >>=20 > >> 14 seconds here > >> against 2 minutes for all languages. > >>=20 > >> The `make run` also helps as pointed by Sergio. > >>=20 > >>=20 > >> ps. PDF is not built automatically. > > > > I tried plain 'make' at the documentation top-level and it failed due t= o missing > > asciidoctor-pdf (I had built docproj with PDF unchecked). > > > > I have used 'make' just fine for the website in the past. The error me= ssage > > came from the 'requirements' target in documentation/Makefile: > > > > RUN_DEPENDS=3D ${PYTHON_CMD} \ > > ${HUGO_CMD} \ > > ${LOCALBASE}/bin/asciidoctor \ > > ${LOCALBASE}/bin/asciidoctor-pdf \ > > ${LOCALBASE}/bin/rougify > > > > ... > > > > all: requirements starting-message generate-books-toc=20 > > generate-pgpkeys-txt build > > run: requirements starting-message generate-books-toc=20 > > generate-pgpkeys-txt run-local > > > > ... > > > > requirements: > > .for dep in ${RUN_DEPENDS} > > .if !exists(${dep}) > > @(echo ${dep} not found, please run 'pkg install docproj=20 > > python3'; exit 1) > > .endif > > .endfor > > > > Thus, even using 'make html' or 'make run' will fail if the PDF tools= =20 > > aren't installed > > even though those make targets don't generate PDF. > > > > The problem for me wasn't the build time, it was the explicit error and= =20 > > exit above. > > > > --=20 > > John Baldwin >=20 > ah got it. >=20 > I misunderstood the main issue.=20 >=20 > we need to fix this requirement.=20 >=20 > and thanks for pointing that out. I've just changed the requirements. https://cgit.freebsd.org/doc/commit/?id=3D151b473480373cea7cdc1af86a1e78379= 76429a1 Thank you! --=20 Danilo G. Baio (dbaio) --aba3tildclchg73u Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQKTBAABCgB9FiEEORj0UTsjzCy+enIkmpN7LfMuiNcFAmFiB7VfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDM5 MThGNDUxM0IyM0NDMkNCRTdBNzIyNDlBOTM3QjJERjMyRTg4RDcACgkQmpN7LfMu iNeznxAApQXZNcw7Mz1+g7A4OesvibcgwlxKve9tTco8Wm347kc6KUjoxifNp+HZ dh+Yfq8cePv8otUKO7VEFTBFsIOGE7YNrT26WmyVdBVmIW9N49lVzXzyBsz0ikC6 L5p7rWIbkRD3hXldCdHwubPYvCov3hCCt+oubAadldypbaDG8e5lloWhHb5y7Kgu GvXDlTY0KNWlQ4Fx0Q62bcRRRbqPso2Zq+Q6LJI2FH+MMjwMHyMi7YOvbx58fL2i OhLrWG/xhxoUT2ZqQ4b1sOMjm7HAhfAordBxs4fVcSA5AgglUL5IvrM5n0Dt0qll W1pvENfthOwa7ayNFGIqkimaEORUnNBQ7f+kJHbqZ5/ir4qhuqyKDN+nJ78Nrc9e pB+YB2pfg3D3A8J/Kd04FcpRglzmG6UCj5wQBLoU0817JNQDvf1m6QaEjYTr/y80 Mk6Y6Py0Vxzn2/PZvfh18lY9PfdOI/U0X8XGra1FZuaiPCA0HWHKF9O9zTrSXxM9 5yFc+dFVdl2eYQkxYz6TrkcNAp8dbnmrVtB9qE51WkvM2GlitnTYAB0N+zHdLGG8 oB+W8kBPPJHhBe8Fsst2K/tdtUlW3eZo3VsPOYUsPQ2diTZIFNNs3AK0OEdByjzL 7X9Vni43PPsODZHfyyc06HpcIyfqJR7OPXQpULBq3KKL/ZjcLxg= =GnRF -----END PGP SIGNATURE----- --aba3tildclchg73u--