From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id Mc0yEWkZzmr3FwEAWB0awg (envelope-from ) for ; Tue, 13 Oct 2026 07:43:37 -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=JitWk/XE; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 3F0DD1E051; Tue, 13 Oct 2026 07:43:37 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-3.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,RCVD_IN_VALIDITY_CERTIFIED_BLOCKED, RCVD_IN_VALIDITY_RPBL_BLOCKED,RCVD_IN_VALIDITY_SAFE_BLOCKED autolearn=ham autolearn_force=no version=4.0.1 Received: from vm01.sourceware.org (vm01.sourceware.org [38.145.34.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 E1D251E04E for ; Tue, 13 Oct 2026 07:43:35 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 7AED54BA23E6 for ; Tue, 13 Oct 2026 11:43:34 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7AED54BA23E6 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=JitWk/XE Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 6110F4BA2E39 for ; Tue, 13 Oct 2026 11:43:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 6110F4BA2E39 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 6110F4BA2E39 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=1791891790; cv=none; b=a8WEjK3iJ5+zDkwFSB6BVdrztSBlkMC72KfDaU3QeQOjbBvJWilV/jZVZQ/6JdIF8Wu/BWfF2F6hJQ51Dv6jfsZ2fSP0QnIAACWLdF5f3c6Kdkx7Ylz0zO0K2nNT3AgZCTD0Kulu3TbAhCCLNDspmRgAq5Eh2jOH2RQEhIx0/pY= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791891790; c=relaxed/simple; bh=V8CyB0ndwIRVGoXF64KzPYvubCDSXJ3ETunxw9pvJGI=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=CsN2E0F7COjHgfTQCLpo54dDpVOnxh2NkwTFxyuQMq381f8PJwKC8bGUtEoL7xTNshK5sOCQx9zlUzD58EHpN41cwJS+PX5w0gZGPWAHGD/9fIgBrQbWNCiHYZXHI6CrRSuUf3yg3ThP7jvbKZoeZGZuDj5tkfQlm5wl0/tmpuc= 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=JitWk/XE DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6110F4BA2E39 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 1xGauR-0006jt-S6; Tue, 13 Oct 2026 07:43:08 -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=J+/GfOIyYm4p9mle3GrUhn6/nE7BaL3GArZ1dGtUTNo=; b=JitWk/XE5T78 VUhHoyNY67gciPeN4cOBXNArdRkZlIPgqDpLzCBkQKwq/RPNrK3ABbM1x9RHLP9q05B+PjCNDBNZc 4hEvzX4ePJA9d2Tx4rpibE2/U+u4CDkL7abLlVt+2kDEtTCrITKGBHzGwyDtvF2PJiJIL1GYDM6Lr 7mou8Lv0oYOG7T3TeULT5pZD4z3QCJs02nnxef10ulc19fSiv1E3m8hX2/yapYJUQ/AyANFNC5xvh 2QE97iGv8zWf2ysR2/YwaXVGiMuZT8pC+zzGxX3QVs8NQs4zWiWzaUCRAqh5/sX6EtTaMzBaA4fiR 9wfsI6YKaPZnfCe3aeHz9Q==; Date: Tue, 13 Oct 2026 14:43:04 +0300 Message-Id: <861p9thlmf.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org In-Reply-To: <78963dad04bf629669f7affab3711ba7df159b46.1791831032.git.aburgess@redhat.com> (message from Andrew Burgess on Mon, 12 Oct 2026 19:54:30 +0100) Subject: Re: [PATCH 5/5] gdb/doc: more @command and @kbd References: <78963dad04bf629669f7affab3711ba7df159b46.1791831032.git.aburgess@redhat.com> 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:30 +0100 > > I spotted some places in the docs where we used @code{...} to wrap a > command name when we should be using @command{...}. This commit > started off with me just trying to fix these. > > Some cases can get a little confusing though. Consider the > documentation that discusses the GDB 'make' command. In talking about > what this GDB command does the documentation references the external > program 'make', which needs wrapping in @command{}, but there are also > mentions of the GDB command itself, which needs wrapping with @kbd{}. > > As these all seemed related I've tried to clean up as many of these as > I could find. As such, this commit is mostly changing things like > @code and @samp to @command and @kbd as needed. > --- > gdb/doc/gdb.texinfo | 128 ++++++++++++++++++++++---------------------- > 1 file changed, 64 insertions(+), 64 deletions(-) Thanks, this is okay, with a couple of nits below fixed. > @item GNU make > @value{GDBN}'s build system relies on features only found in the GNU > -make program. Other variants of @code{make} will not work. > +make program. Other variants of @command{make} will not work. ^^^^ This should also be in @command. > -To build @code{gdb} in a separate directory, run @file{configure} > +To build @code{gdb} in a separate directory, run @command{configure} ^^^^^^^^^^ This should use @value{GDBN}. Approved-By: Eli Zaretskii