From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 77CBEC4332F for ; Mon, 19 Dec 2022 01:53:16 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 8DC9285304; Mon, 19 Dec 2022 02:53:13 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="DvIjPq1y"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 9723985391; Mon, 19 Dec 2022 02:53:11 +0100 (CET) Received: from mail-qt1-x82c.google.com (mail-qt1-x82c.google.com [IPv6:2607:f8b0:4864:20::82c]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id BB95B85303 for ; Mon, 19 Dec 2022 02:53:08 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qt1-x82c.google.com with SMTP id bw27so5120644qtb.3 for ; Sun, 18 Dec 2022 17:53:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=e9GPEJudVhBlwNZvLJFQJfs1dX5yCiLceOtm5wd49do=; b=DvIjPq1yA8b6REvsl4F0+bMpWEoJuX+hXkZl0FPRt8exS8ass1gmW5QVPqTp1Mv2+K 3nyFyRFGlHE2grlML5kOYisnU3Cwys4qP8NFIrB0TCvv/kXM8VyvHTnzH+Ef3mt5xk1/ lIPmRYd0IF6JhI749iuCm9vEniF0zlgj6L5xc= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=e9GPEJudVhBlwNZvLJFQJfs1dX5yCiLceOtm5wd49do=; b=XqVEORT33+RxUZYS0em1Bq2JQglRIGxnkM43RFbJKgEA1QRK00ydaOD45VXfEEJfT1 hNucPLfL5vKf4d9dhh8KOMnRCRl+zZ/wAVeyzhtIkn3M+6yaKO8rYmmPv8W+E3UAtTmw 6f80NX+7MwvjTDrARIjWzDFnvFHuJVVcBI+FEN2EqL26F/IGQ1t0U0KQLnGmLYsIwAWj J5dIPIb9xLjk4d1qtM819SEt+V6CZFtY4/zJ38kAo0dgC4JkKo1vqYRO0peMMhJ0l821 MmksRAjwmY3lpS/OIzXZsMfuE2ZDlnAT3STiIL644Yp8uOIxA/jVNnUTcSSajmRQWTSr lqQw== X-Gm-Message-State: ANoB5plzB0Dw/6Td7X8ZEFEVrRdrosSSRXaPvPOixgBe0NFAxIWWt7Kt 1FsbJCDlJ9KZSDm5KP1BPBMtiw== X-Google-Smtp-Source: AA0mqf4zR4Cc3EfE3Q3Jd7fj2mA5QCznJy8ytmmdznHIcRSuFZ1t+DJC1nd7v7xf6vaKrtLLjv1Lug== X-Received: by 2002:ac8:74d9:0:b0:3a7:eb36:5cb1 with SMTP id j25-20020ac874d9000000b003a7eb365cb1mr54127530qtr.36.1671414787550; Sun, 18 Dec 2022 17:53:07 -0800 (PST) Received: from bill-the-cat (2603-6081-7b00-6400-d5a0-abff-1b88-4d34.res6.spectrum.com. [2603:6081:7b00:6400:d5a0:abff:1b88:4d34]) by smtp.gmail.com with ESMTPSA id b24-20020ac844d8000000b0035badb499c7sm5298129qto.21.2022.12.18.17.53.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 18 Dec 2022 17:53:07 -0800 (PST) Date: Sun, 18 Dec 2022 20:53:05 -0500 From: Tom Rini To: Heinrich Schuchardt Cc: Maxim Cournoyer , u-boot@lists.denx.de, Maxim Cournoyer , Marek =?iso-8859-1?Q?Beh=FAn?= , Pali =?iso-8859-1?Q?Roh=E1r?= , Quentin Schulz , Simon Glass Subject: Re: [PATCH] doc: add texinfodocs and infodocs targets Message-ID: <20221219015305.GI3787616@bill-the-cat> References: <20221217025137.2514-1-maxim.cournoyer@savoirfairelinux.com> <112c5967-ae51-7312-0534-9bb01d9ef404@gmx.de> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="xL9Vlh4NZt3cCSwz" Content-Disposition: inline In-Reply-To: <112c5967-ae51-7312-0534-9bb01d9ef404@gmx.de> X-Clacks-Overhead: GNU Terry Pratchett X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.6 at phobos.denx.de X-Virus-Status: Clean --xL9Vlh4NZt3cCSwz Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Dec 17, 2022 at 01:27:52PM +0000, Heinrich Schuchardt wrote: > On 12/17/22 02:51, Maxim Cournoyer wrote: > > Sphinx supports generating Texinfo sources and Info documentation, > > which can be navigated easily and is convenient to search (via the > > indexed nodes or anchors, for example). This is basically the same as > > 1f050e904dd6f2955eecbd22031d912ccb2e7683, which was recently applied > > to the Linux kernel. > >=20 > > Signed-off-by: Maxim Cournoyer > > --- > >=20 > > Makefile | 2 +- > > doc/Makefile | 11 +++++++++++ > > doc/media/Makefile | 3 ++- > > 3 files changed, 14 insertions(+), 2 deletions(-) > >=20 > > diff --git a/Makefile b/Makefile > > index de5746399a..597a8886c3 100644 > > --- a/Makefile > > +++ b/Makefile > > @@ -2372,7 +2372,7 @@ tcheck: > > # Documentation targets > > # -------------------------------------------------------------------= -------- > > DOC_TARGETS :=3D xmldocs latexdocs pdfdocs htmldocs epubdocs cleandoc= s \ > > - linkcheckdocs dochelp refcheckdocs > > + linkcheckdocs dochelp refcheckdocs texinfodocs infodocs > > PHONY +=3D $(DOC_TARGETS) > > $(DOC_TARGETS): scripts_basic FORCE > > $(Q)$(MAKE) $(build)=3Ddoc $@ > > diff --git a/doc/Makefile b/doc/Makefile > > index f5de65e927..62effd0fec 100644 > > --- a/doc/Makefile > > +++ b/doc/Makefile > > @@ -69,6 +69,15 @@ quiet_cmd_sphinx =3D SPHINX $@ --> file://$(abspath= $(BUILDDIR)/$3/$4) > > htmldocs: > > @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,html,$(var),,$(= var))) > >=20 > > +texinfodocs: > > + @$(srctree)/scripts/sphinx-pre-install --version-check > > + @+$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,texinfo,$(var),t= exinfo,$(var))) > > + > > +# Note: the 'info' Make target is generated by sphinx itself when > > +# running the texinfodocs target defined above. > > +infodocs: texinfodocs > > + $(MAKE) -C $(BUILDDIR)/texinfo info > > + > > linkcheckdocs: > > @$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,linkcheck,$(var)= ,,$(var))) > >=20 > > @@ -109,6 +118,8 @@ cleandocs: > > dochelp: > > @echo ' U-Boot documentation in different formats from ReST:' > > @echo ' htmldocs - HTML' > > + @echo ' texinfodocs - Texinfo' > > + @echo ' infodocs - Info' >=20 > This does not work: >=20 > $ make infodocs > make[1]: ./scripts/sphinx-pre-install: No such file or directory >=20 > $ make texinfodocs > make[1]: ./scripts/sphinx-pre-install: No such file or directory > make[1]: *** [doc/Makefile:73: texinfodocs] Error 127 > make: *** [Makefile:2378: texinfodocs] Error 2 >=20 > @Tom: > Should we add a build step for each of the new targets to > .gitlab-ci.yml and .azure-pipelines.yml? We should rename the job and build all doc targets, once they've been fixed I think. --=20 Tom --xL9Vlh4NZt3cCSwz Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGzBAABCgAdFiEEGjx/cOCPqxcHgJu/FHw5/5Y0tywFAmOfxAEACgkQFHw5/5Y0 tyxV+Qv+PcGjPaSyuc4D9Be2A7x5QbIH4eKms182Z3RHcZwEvDbmGgFYLVqePXyx 9VHHJHVCveCuYVz0lBnV6+6NOHaIeZod45+6v8Hmk3p562t8rNspK1qri0EdHrjP 8yvOkN57iWVyBiFqddyVwzqKD0vZ1LNyx3HviCD8Slmn1MHJ7kXSj+lh6UioF4wn ZI7UtBbPFmUA/6bV4FZAsdeldqsHrl8aNkk5cY1TKDxjJjSvFzcvXFrrHnL2ISbN m1jhwg88Scwky79H5afT7c5xL600278usAdwT631n16QndvEGS6MfSpHDDgR9pf8 iTrNFxT6n6OFA7PeOnlCSLfwp2jmldqZDOzhzcVYhEXli5XH3znM8Gr9jQxxJpSm Ao9LztmFQSKW6coPNAEqxFqubPghtywmXDtcocLHFMX+ppeKxmQexb3/nI40yyXk qyniMFc0v5y/cquRa96a+AlmDamRfSMAp9QPlJhqw8Fg+fgutD2VkoRNeLCxknLT gcPPmT3W =pYwt -----END PGP SIGNATURE----- --xL9Vlh4NZt3cCSwz--