From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mout-p-103.mailbox.org (mout-p-103.mailbox.org [IPv6:2001:67c:2050:0:465::103]) by sourceware.org (Postfix) with ESMTPS id 4D50D3858CDB for ; Thu, 9 Mar 2023 10:36:44 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 4D50D3858CDB Authentication-Results: sourceware.org; dmarc=pass (p=reject dis=none) header.from=aarsen.me Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=aarsen.me Received: from smtp1.mailbox.org (smtp1.mailbox.org [IPv6:2001:67c:2050:b231:465::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-103.mailbox.org (Postfix) with ESMTPS id 4PXQbD5GYbz9sTH; Thu, 9 Mar 2023 11:36:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aarsen.me; s=MBO0001; t=1678358200; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=lpZ+eujuosu/Zo+9u/QJj8LrghHj9R62aTBVaS4WTUg=; b=1EURZQdrygnvuxhumi1JmaouFB7m8t5H+Uv9Roj3J2WoM+bCiieM+rXSxwBPXJw6khqwnu Cexh3cPmxKouPz9eJLuvE6+zW0CLNtKgyKNV/K287XxjPVgKfkxDYmbJGGFOhENnKAJWIV mQwN0Tiw+1ubAxKg0Irn8rC0IzAqlscx40AjSDJ/RtWoAweRt5zBkSNswi0rOrGFGh2QtK YatgRwEAvy7qpWdv8par8/S+wxMjl1jhZyj88MMmIiKuZ5Fgh9ReKLAwg8O/EtMyUJg3CZ CUDYxAz85O4l4i8L3Klnj2vneyjwz1otX+uLhuIHeDTcEeLD03yuI1izmMBSug== References: <20230223102714.3606058-1-arsen@aarsen.me> <76f92bd2-7d4b-15ba-12ca-8de44e91b886@codesourcery.com> <86lek7txey.fsf@aarsen.me> <86a60m98dz.fsf@aarsen.me> <708c48a9-a64d-6485-3e42-1ef9d97ffc7e@codesourcery.com> From: Arsen =?utf-8?Q?Arsenovi=C4=87?= To: Sandra Loosemore Cc: gcc-patches@gcc.gnu.org, Gerald Pfeifer , Joseph Myers Subject: Re: [PATCH v2 0/5] A small Texinfo refinement Date: Thu, 09 Mar 2023 11:22:32 +0100 In-reply-to: <708c48a9-a64d-6485-3e42-1ef9d97ffc7e@codesourcery.com> Message-ID: <86356e6wjt.fsf@aarsen.me> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Rspamd-Queue-Id: 4PXQbD5GYbz9sTH X-Spam-Status: No, score=-5.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_INFOUSMEBIZ,KAM_SHORT,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Sandra Loosemore writes: >> As an example, let's take this link: >> https://gcc.gnu.org/onlinedocs/gcc-12.2.0/gcc/Warning-Options.html#index= -Wpedantic >> This should place you below the item line this index entry refers to, >> and there aren't any copiable anchors (see equivalent in my render for >> an example of those), both of which were often named as annoyances with >> the onlinedocs while the Sphinx experiment was taking place. >> A similar thing happens in the standalone and Emacs info viewers (but >> that's less noticeable there since the cursor is placed in the middle of >> the screen when jumping to an index entry there). Try, for instance, >> 'info gcc Wpedantic' (your cursor will be placed just below the item >> line). >> The fix for the first of these issues should already be applied by >> Gerald (in the reordering commits, IIRC at least, save for one that I >> created later because someone snuck in new "misplaced" indices), and >> that fix should also fix up previous versions of Texinfo. >> Even with this change, the copiable anchors will remain missing since >> released Texinfo versions lack some AST transformations that enable >> those. > > OK, I can see the difference there between the current online docs, the s= et you > produced with the unreleased Texinfo support, and what I got building with > Texinfo 6.7. > >> Otherwise, manuals should work fine with older releases, unless I missed >> something when refactoring @defbuiltin and removing @gols (which I do >> believe are superfluous with current versions of texinfo.tex, which is >> why I bumped that too). > > I did a few spot-checks here and there of those changes. I saw a couple = of > line break problems but they turn out to be due to existing errors in the= .texi > files that were not introduced by your (mostly mechanical) changes. Thanks. I tried to check all usage sites of @gol in PDF output too, to make sure its removal didn't have a negative impact, but I only tested new makeinfo and the texinfo.tex I pushed to my branch (2023-01-17.19). I expect the version of makeinfo to have no impact for that output, since it should just offload to texi2dvi. >> FWIW, I (briefly) tested with Texinfo 6.0, and output seems okay. On >> 5.0, I got a few warnings, but I think even 6.0 is apt considering its >> age. I haven't given it a proper scrutiny, though (workdays are busy >> this time of year..). > > Texinfo 6.0 was released in 2015, 5.0 in 2013. FWIW, Trusty Tahr (the cu= rrent > oldest Ubuntu LTS release) has 5.2. 4.7 was released in 2004, I don't kn= ow why > anyone would still be trying to use that unless it's needed for building = legacy > code from the same era. Heh, I hadn't realized how far back LTS releases go.. I don't think there's any new language constructs that the GCC manual could make use of currently, so it shouldn't be too difficult to retain at least a "builds with diagnostics" level of support for those versions. > I think we could do away with the requirement for a specific minimum vers= ion, > and make install.texi say something similar to what it says for e.g. awk = -- > just use a "recent" version, and note that new versions produce better ou= tput > and very old ones may produce diagnostics. I'll add that do my own todo = list. That seems reasonable, thanks. > -Sandra =2D-=20 Arsen Arsenovi=C4=87 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iOYEARYKAI4WIQT+4rPRE/wAoxYtYGFSwpQwHqLEkwUCZAm2tl8UgAAAAAAuAChp c3N1ZXItZnByQG5vdGF0aW9ucy5vcGVucGdwLmZpZnRoaG9yc2VtYW4ubmV0RkVF MkIzRDExM0ZDMDBBMzE2MkQ2MDYxNTJDMjk0MzAxRUEyQzQ5MxAcYXJzZW5AYWFy c2VuLm1lAAoJEFLClDAeosSTNaYBALv+V9Jv9payJ7DXWlpnoVZ5kG9VFjyPkj4y wYsUTQ4EAQCX3bMgQgOZqVLzRt3nE/tieDtX+BhdlgWGtE417L22DA== =LOVQ -----END PGP SIGNATURE----- --=-=-=--