From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id p6XzGj0XzmqwBwEAWB0awg (envelope-from ) for ; Tue, 13 Oct 2026 07:34:21 -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=bkhjZuoy; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 295671E051; Tue, 13 Oct 2026 07:34:21 -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 B214F1E04E for ; Tue, 13 Oct 2026 07:34:18 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C7D174BA23F5 for ; Tue, 13 Oct 2026 11:34:16 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C7D174BA23F5 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=bkhjZuoy Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 595064BA540B for ; Tue, 13 Oct 2026 11:33:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 595064BA540B 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 595064BA540B 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=1791891233; cv=none; b=jSaPCmmobjNoUsBFxQ/9QXdJJC4G6V6ROWKawl6Srf2Cjywz1ndmpbgSUB/G1fSslS1nRNaApcaludpTAmJXQHnHbHYmTXGf1/GrBVo7YOmhMcOoK5AGPQ2sovpE/yTyVhfvJJd+iU2+pTPXmTrrDQziS2BZIOA1QA+/xkUuRXY= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791891233; c=relaxed/simple; bh=0xw4E8J4C+OGdgvmvhLhzCW3WutTh+/px147xnW7lw8=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=eQPuZLxOz22zORhSsZEljBYfYGU28dC1SN3B+61+Sc4s1pz4YU0E7YBIkx1plkxqKTBDH18WJUQnXGhQpw+Bp9T4zIfwiq75HKUjk2sMbdenmmWv4rmOkAa1LF7JUIvwTvQ2ML/ZOwlbgzkP9K4fPQz2zxkstd0sC2pEOS6YjYw= 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=bkhjZuoy DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 595064BA540B 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 1xGalT-0005FQ-5t; Tue, 13 Oct 2026 07:33:51 -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=U67aB4aRmO9XHTm8CNlqO064zURst8miKgutSVqooMo=; b=bkhjZuoydcxF 6yI/kkzOnF2Ozcd9DqaqtA6GsA/8MEUkKQjuhyDnJZ3J8OYpficS3El3vomkHCM86ducfbW1wPQjZ NvWOJ04Q2Mfh0+dBn+NkmT4a0PuZnSWpdMn67Pd32xHkUmv8yE72DiH2uLu8f4ZRXwQEPSvGstODG by+RDpPXOD6sz43h/Db5HnjKO70GEazWcHX+PGqjMa/L1QmPY5uUFJOHN+J6+WHHhBaOq3pO94pmr fm7yPqsPoNmJfwiaDE1t0idgsKq+XedyTr5xNfhK3YrWdLDxpthPq8ODssJ4XnTmxakqt8WtBzMS/ yT2ovph468l8iEhbIp7n3w==; Date: Tue, 13 Oct 2026 14:33:49 +0300 Message-Id: <8633u9hm1u.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:28 +0100) Subject: Re: [PATCH 3/5] gdb/doc: consistent formatting for on|off on @item lines 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:28 +0100 > > When a command takes 'on' or 'off' as an option then we have a bunch > of styles for how this is presented within a table's @item line: > > @item set logging enabled [on|off] > @item -past-main [@code{on}|@code{off}] > @item set auto-load python-scripts @r{[}on@r{|}off@r{]} > > Of these the last seems to be the style that is most often used for > new additions. I think it's the correct one because: > > 1. Use @r{...} to wrap the characters that are not part of the > command: [|], this ensures these characters are formatted as > normal text, not using the table style, which should be @kbd. > > 2. Wrapping 'on' and 'off' in @code{...} is clearly wrong, there > are not code. Using @samp{...} might work, but this isn't what > we currently do, and the 'on' and 'off' could be considered just > another part of the command, so using the table's default @kbd > style seems reasonable enough. > > This commit updates some cases in the documentation which used the > first two styles to use the third style, this makes things more > consistent. > --- > gdb/doc/gdb.texinfo | 78 ++++++++++++++++++++++----------------------- > gdb/doc/guile.texi | 4 +-- > gdb/doc/python.texi | 4 +-- > 3 files changed, 43 insertions(+), 43 deletions(-) Thanks, this is okay. Approved-By: Eli Zaretskii