From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) by sourceware.org (Postfix) with ESMTP id 6C37D3858D33 for ; Mon, 16 Oct 2023 10:16:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 6C37D3858D33 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gentoo.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gentoo.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 6C37D3858D33 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:ea4a:1:5054:ff:fec7:86e4 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1697451388; cv=none; b=gX1IvvxeF5lFV06eVSAef9kyPzC4gUWMzyRPNp+DJnqfyQSkStJ2y3hsMZYUUn2dfCJSAcQg1fm+BKW5C8a7GQTObAPeQ7EwWOxnfJtTpuIMz9Blpyrq0p46oej4xvmNKqSHBBitHVG4Kr+zLmeaCGsyo77PoToYCGB61Koj/r0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1697451388; c=relaxed/simple; bh=Qt8BZbQaIja/ZUyF5TIeHsyR6u0D35IQ8BWHad9BZQU=; h=Date:From:To:Subject:Message-ID:MIME-Version; b=rhhpBWIgqyFYe5C+WmvpPnSY6sf+1c4QLHHk4HbMv5qGS8mcWgDNm+5yjbpEfWo7SHC6EALs8Yo1Iu/dSVk9ZUM1JdqAJ5HbjRxCQIrYyEZdm60ueWdpI7Om+X0fWAbS8zeUMczmsViC6ZZhsZF4AH43JvV/CKjXmRA9Vd6dfGQ= ARC-Authentication-Results: i=1; server2.sourceware.org Received: by smtp.gentoo.org (Postfix, from userid 559) id 02F6A335D17; Mon, 16 Oct 2023 10:16:27 +0000 (UTC) Date: Mon, 16 Oct 2023 16:01:25 +0545 From: Mike Frysinger To: "R. Diez" Cc: "newlib@sourceware.org" Subject: Re: [PATCH] libgloss: doc: generate single page & split html manuals Message-ID: References: <20231015082206.32686-1-vapier@gentoo.org> <1541507901.13276384.1697448698591@mail.yahoo.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="W0CUyEJhYlbOqzkX" Content-Disposition: inline In-Reply-To: <1541507901.13276384.1697448698591@mail.yahoo.com> X-Spam-Status: No, score=-3.6 required=5.0 tests=BAYES_00,BODY_8BITS,JMQ_SPF_NEUTRAL,KAM_DMARC_STATUS,KAM_SHORT,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --W0CUyEJhYlbOqzkX Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 16 Oct 2023 09:31, R. Diez wrote: > > libgloss/Makefile.in=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 | 11 +++++++++-- > > libgloss/doc/Makefile.inc |=C2=A0 7 +++++++ >=20 > Does this mean that only libgloss is affected? Or does the libc part also= have the concept of split / single HTML manuals? i'll update newlib (libc+libm) once people are happy with this direction. > > +@HAVE_DOC_TRUE@html-local: doc/porting/index.html >=20 > Is 'html-local' the new target? this is an internal Automake hook point. people still run `make html` and they'll get both forms of the manual. https://www.gnu.org/software/automake/manual/1.16.5/automake.html#index-htm= l_002dlocal > > +@HAVE_DOC_TRUE@AM_MAKEINFOFLAGS =3D --no-split > > [...] > > +@HAVE_DOC_TRUE@doc/porting/index.html: doc/porting.texi doc/$(am__dirs= tamp) > > +@HAVE_DOC_TRUE@=C2=A0=C2=A0=C2=A0 $(AM_V_GEN)$(MAKEINFOHTML) $(AM_MAKE= INFOHTMLFLAGS) $(MAKEINFOFLAGS) \ > > +@HAVE_DOC_TRUE@=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 --split=3Dno= de $< -o $(@D) > > [...] > > +AM_MAKEINFOFLAGS =3D --no-split > > [...] > > +html-local: %D%/porting/index.html > > +%D%/porting/index.html: %D%/porting.texi %D%/$(am__dirstamp) > > +=C2=A0=C2=A0=C2=A0 $(AM_V_GEN)$(MAKEINFOHTML) $(AM_MAKEINFOHTMLFLAGS) = $(MAKEINFOFLAGS) \ > > +=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 --split=3Dnode $< -o $(@D) >=20 >=20 > I do not actually know what @HAVE_DOC_TRUE@ means. Makefile.in is generated code that isn't meant to be read by most people. > All I can see above next to AM_MAKEINFOFLAGS is "--no-split", but then th= e command-line arguments are both "--split=3Dnode". Is that not a contradic= tion? standard CLI behavior: later options override earlier one. -mike --W0CUyEJhYlbOqzkX Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEuQK1JxMl+JKsJRrUQWM7n+g39YEFAmUtDXkACgkQQWM7n+g3 9YFAow//VVyaffULQ0yvBeGr5M5dueys/6yvnThM+A7xeghbTiJPHUxc+q+hKhgd F1Clfy3ppG2n6wC/yxukbOtYRTi7MZ9GZe+ozdY18d8dv6WB1ABrRukFyQ6z8AQq ChcvTxvlccg/xW9j79lVM9M+ir8ZkQ24zwRPa9lKrgY0yvc+sOzhuOdglAeg7Bdw up/y/B6zO2DtaDRqFF26o7mgSsgGNGaMDXKTbh+tZfdcPYTkGllVF9o+AG1f/+P6 X3g9+Cv2gWivOlobLkZ9K+wFC7ord4/ToPqNG+Ksi36HMvC7hTunskrnAR/3UbyJ OY+bIS5s9VxumIeaEoMMvAfP7XWL1YB4YN2b4veMN5mdazHyk9xN6iPNyeTpfSpX LJE5x7AvZH9RCFFyH/XROIE7Ko0wQrqumVGt6l5Im6TrGJ2SXPvznRuwrywaJDwN T4CI8aRjS6ruBEXTY5PjmyBFTI74FjepUS2Ok/ZVvEuC8CjluAKNpt4N7xyEUVyX 3uYzXf9vFHPYoXKBCO3uEDnmq6Tp3F/oRiyzz9QCKK8XRhqwb2BgZSDn1c3I4sfV DfUFMkqGrOvUXZMT7UECrTqBpchD3f3l64Es+8WWjVFz5ypHez2EVMhEKuy3c40p +2el5pIZZ+BL3GsNPk/Zm8e9uBtDbAcEQ/McxXaKgas/APrZ4lc= =9Pcq -----END PGP SIGNATURE----- --W0CUyEJhYlbOqzkX--