From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 54ZDCHodzmoOOAEAWB0awg (envelope-from ) for ; Tue, 13 Oct 2026 08:00:58 -0400 Authentication-Results: simark.ca; dkim=pass (2048-bit key; unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=EkeHOEIF; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 0B05E1E051; Tue, 13 Oct 2026 08:00:58 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [IPv6:2620:52:6:3111::32]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 46F121E04E for ; Tue, 13 Oct 2026 08:00:56 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id BD0114BA23F5 for ; Tue, 13 Oct 2026 12:00:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org BD0114BA23F5 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=EkeHOEIF Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id B4D3A4BA23C3 for ; Tue, 13 Oct 2026 12:00:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org B4D3A4BA23C3 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org B4D3A4BA23C3 Authentication-Results: sourceware.org; arc=none smtp.remote-ip=2001:470:142:3::10 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791892826; cv=none; b=cYX+l7KCoJWF3cOxh+i9xTAz7PdJgXjtb26du0UVB0fnB2pimylIpVkskRaVusNlpP73ieQv4V/XTGj5NA/lkYR2L5Pr/3r2ZPaS/PmYLM11rsYfdRNiuTSlfRbhjVHTF0lcTScGBDqMd3yNM6yu0F7FZKJdLwVaxha6sYU3Kyo= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791892826; c=relaxed/simple; bh=UaKS6IA2ha6y1MXizjOvuqbkTog2oGsYE2on+Uu2rrI=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=LCylF7SvYhnmPbZUZtYOzM/QcoJO2pBN2Gq8fBTEjuAmyw4TLePehIWRUQZxIS2fQElCkp7mcnUlhkZCt4rTBh5cw1DU2M77pWuxaFDiOtLeManINc7+rbP2/Sj2HJrSTvyo6JbYiT7yqVe+LgcOYpPh7imxcnPcZlBpnygX8PI= ARC-Authentication-Results: i=1; sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=EkeHOEIF DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org B4D3A4BA23C3 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1xGbBB-0001Jb-JQ; Tue, 13 Oct 2026 08:00:25 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=eKF+JiECeGd3COJoEQ6AaYX7KXnX+Ych2jmOvxubRCs=; b=EkeHOEIFf0iY MFdTfrjU0CPFNg+X1HMBlzSHW+R+flhi6aiRwE8THR1ciO0r4CNTMbOo9jfqCLsW6p6E5b91BpLpk IFIXCPR5/PA+GPwtFDSN5HSyOVs9G6IiWyhp7QatySioeU3dHCLA22mQsZdjVM4u00ippT+jTpQha ZujIvUAHzSmTY3OjekB+oLjntB8Z85O5vtyhiJ0SUTuec49Ts//aXa+imLTGF8XUoWRJolqXSv9Ka xJTNghnXy52avoocxlUy9w1yKc5kQoOjzz6MAtKj2nDPANQbAOB03wCwysBHLETZaCB8zx5M2w/1e pMIve53LG+n9LhOln3OJ1Q==; Date: Tue, 13 Oct 2026 15:00:12 +0300 Message-Id: <86wlrlg69f.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org In-Reply-To: (message from Andrew Burgess on Mon, 12 Oct 2026 19:54:29 +0100) Subject: Re: [PATCH 4/5] gdb/doc: make more use of @option{...} formatting References: X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org > From: Andrew Burgess > Cc: Andrew Burgess > Date: Mon, 12 Oct 2026 19:54:29 +0100 > > I noticed that there are lots of places in our docs where command line > options, either for GDB or for other programs (e.g. compilers) are > formatted as either @code or @samp. Historically, @option was not originally available in Texinfo, that's why we have so many @samp instead. > In this commit I made use of regexp replacement looking for anything > that matched: "@(code|samp)\{-[^}]+\}" and if I was reasonably certain > that it was a command line option I switched to use @option{...}. If > I had any doubt then I left things as they were. > > I'm sure that there are places that I've missed, but hopefully this > makes the docs a little better. > --- > gdb/doc/gdb.texinfo | 350 ++++++++++++++++++++++---------------------- > gdb/doc/guile.texi | 4 +- > 2 files changed, 177 insertions(+), 177 deletions(-) Thanks, this is okay. Approved-By: Eli Zaretskii