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 070E93858D38 for ; Fri, 10 Mar 2023 15:52:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 070E93858D38 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 smtp202.mailbox.org (smtp202.mailbox.org [10.196.197.202]) (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 4PY9Y24V0Lz9sxs; Fri, 10 Mar 2023 16:52:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aarsen.me; s=MBO0001; t=1678463542; 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=ioz1JeLoMS9D3dvcVIYl4q8quGE/IITdQLzwzzkyxVs=; b=lAT0EHgLAOyLdl27QIJE9LCOL1j6uem48hO6XjkJiwijSMEeg8w69F7hykJ235UCxg9623 lWzWmm9XFyNYVQF7VZzt5Xz6Zo6WtZXlCtMtDznB09r2zstaPQjraajoFTPXDofKE0beI1 /+QuJK3EeOXL1xD/+/9zHpvzg0gXUYQYEK/uUGdONjcWSnNeBQivZkYv2sCOxCkgmIa696 5Rx3RXC7f7bwQz8ZxyLIPXdmMH7z8NmHLExfZWjweU8gzZxJLM+GD78tHTjTR0txpVHOZm lQsnWyhY543ahdvZFginSVZxvVQLKdxoxOlz3i8H3hY7A9iKD03/LvYSs1yLjg== References: <20230223102714.3606058-1-arsen@aarsen.me> <20230223102714.3606058-5-arsen@aarsen.me> <26dbe30b-455d-2e01-80b9-436175c2e179@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 4/5] Update texinfo.tex, remove the @gol macro/alias Date: Fri, 10 Mar 2023 16:49:03 +0100 In-reply-to: <26dbe30b-455d-2e01-80b9-436175c2e179@codesourcery.com> Message-ID: <87ttysppsc.fsf@aarsen.me> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_INFOUSMEBIZ,KAM_LOTSOFHASH,KAM_SHORT,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,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: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Afternoon, Sandra Loosemore writes: > On 2/23/23 03:27, Arsen Arsenovi=C4=87 via Gcc-patches wrote: >> The @gol macro appears to have existed as a workaround for a bug in old >> versions of makeinfo and/or texinfo.tex, where they would, in some types >> of output, fail to emit line breaks in @gccoptlists. After updating >> texinfo.tex, I noticed that this behavior appears to no longer be >> exhibited, instead, both acted correctly and inserted newlines. The >> (groff) manual output also appears unaffected. >> gcc/ChangeLog: >> * doc/include/texinfo.tex: Update to 2023-01-17.19. >> * doc/implement-c.texi: Remove usage of @gol. >> * doc/invoke.texi: Ditto. >> * doc/sourcebuild.texi: Ditto. >> * doc/include/gcc-common.texi: Remove @gol. In new Makeinfo and >> texinfo.tex versions, the bug it was working around appears to >> be gone. >> gcc/fortran/ChangeLog: >> * invoke.texi: Remove usages of @gol. >> * intrinsic.texi: Ditto. > > This is OK, but I'd like to see this patch split into two separate commit= s as > well -- one for the texinfo.tex import, and one for the @gol changes. The full log is below. This branch is also, as usual, visible on my fork at: https://git.sr.ht/~arsen/gcc texinfo_improvements ... and is visible in web form at: https://git.sr.ht/~arsen/gcc/log/texinfo_improvements I rebased the patchset to today's revision again. The log: commit 63fcce9b7d7af55fd73024fa42cb44fde9063c3a Author: Arsen Arsenovi=C4=87 Date: Thu Mar 9 21:44:29 2023 +0100 update_web_docs_git: Set CONTENTS_OUTPUT_LOCATION=3Dinline =20=20=20=20 maintainer-scripts/ChangeLog: =20=20=20=20 * update_web_docs_git: Set CONTENTS_OUTPUT_LOCATION=3Dinline in order to put @shortcontents above contents. See 9dd976a4-4e09-d901-b949-6d5037567b9b@codesourcery.com on gcc-patches. commit 04c696ed31e623d003a0472f83d6a93c53541790 Author: Arsen Arsenovi=C4=87 Date: Tue Feb 28 11:40:56 2023 +0100 docs: Fix up new instances of index reordering =20=20=20=20 This commit fixes up an instance of the index entry mis-ordering that occurred between the formulation and application of commit r13-6310-gf33d7a88d069d1. =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/extend.texi: Associate use_hazard_barrier_return index entry with its attribute. * doc/invoke.texi: Associate -fcanon-prefix-map index entry with its attribute commit cfc401f06bf46fd98ee1272e0204155d635b3c42 Author: Arsen Arsenovi=C4=87 Date: Thu Jan 26 18:50:38 2023 +0100 update_web_docs_git: Update CSS reference to new manual CSS =20=20=20=20 maintainer-scripts/ChangeLog: =20=20=20=20 * update_web_docs_git (CSS): Update CSS reference to point to /texinfo-manuals.css. commit d3c953045f99523a726d1d2b2d25bc9e9352fdfd Author: Arsen Arsenovi=C4=87 Date: Wed Jan 25 23:33:03 2023 +0100 doc: Remove the @gol macro/alias =20=20=20=20 The @gol macro appears to have existed as a workaround for a bug in old versions of makeinfo and/or texinfo.tex, where they would, in some types of output, fail to emit line breaks in @gccoptlists. After updating texinfo.tex, I noticed that this behavior appears to no longer be exhibited, instead, both acted correctly and inserted newlines. The (groff) manual output also appears unaffected. =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/implement-c.texi: Remove usage of @gol. * doc/invoke.texi: Ditto. * doc/sourcebuild.texi: Ditto. * doc/include/gcc-common.texi: Remove @gol. In new Makeinfo and texinfo.tex versions, the bug it was working around appears to be gone. =20=20=20=20 gcc/fortran/ChangeLog: =20=20=20=20 * invoke.texi: Remove usages of @gol. * intrinsic.texi: Ditto. commit e543f4acda2573331d02a99a779f8710abfb14c6 Author: Arsen Arsenovi=C4=87 Date: Fri Mar 10 16:21:33 2023 +0100 doc: Update texinfo.tex =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/include/texinfo.tex: Update to 2023-01-17.19. commit 5f093996a453656755a0209271d01392d05b849e Author: Arsen Arsenovi=C4=87 Date: Fri Mar 10 16:13:28 2023 +0100 docs: Add @defbuiltin family of helpers =20=20=20=20 The @defbuiltin{,x} macros are convenience macros for the often-repeated task of defining a built-in function in extend.texi. Usage of this macro should lead to a higher degree of consistency across pieces of text written by different people, and provide a better reading experience, as they prevent easy-to-make errors, like forgetting index entries for these functions. =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/include/gcc-common.texi: Add @defbuiltin{,x} and @enddefbuiltin for defining built-in functions. * doc/extend.texi: Apply @defbuiltin{,x} to many, but not all, places where it should be used. commit a867275185f2f2d5d654394a406ae28f16a4f26a Author: Arsen Arsenovi=C4=87 Date: Fri Mar 10 16:08:19 2023 +0100 doc: Fix a few minor errors spotted by testers =20=20=20=20 This commit addresses a few minor errors that were spotted while testing the GCC manual with a few people, and while working on wider changes. =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/extend.texi (Formatted Output Function Checking): New subsection for grouping together printf et al. (Exception handling) Fix missing @ sign before copyright header, which lead to the copyright line leaking into '(gcc)Exception handling'. * doc/gcc.texi: Set document language to en_US. (@copying): Wrap front cover texts in quotations, move in manual description text. commit 8e0739647b9fe429b57c7855b2ed0dee00407457 Author: Arsen Arsenovi=C4=87 Date: Sun Nov 20 17:57:46 2022 +0100 docs: Create Indices appendix =20=20=20=20 The GCC manual has multiple indices. By creating an appendix which lists them, we help makeinfo present a more accessible way for the reader to see all the indices. =20=20=20=20 gcc/ChangeLog: =20=20=20=20 * doc/gcc.texi: Add the Indices appendix, to make texinfo generate nice indices overview page. > -Sandra Have a lovely day. =2D-=20 Arsen Arsenovi=C4=87 --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iIYEARYKAC4WIQT+4rPRE/wAoxYtYGFSwpQwHqLEkwUCZAtSMxAcYXJzZW5AYWFy c2VuLm1lAAoJEFLClDAeosSTo+YA/0ptMP/jsKtNtEzNCQpDJjf3mjoYVzOVjQ9K bEaz4VqWAQCixdd5BArP1LqEnwZUANhvZi50tPHB7skzs/1qnCmpDA== =0VFd -----END PGP SIGNATURE----- --=-=-=--