From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id D6XTLZk60mrtLhsAWB0awg (envelope-from ) for ; Fri, 16 Oct 2026 10:54:17 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=aA/82lmw; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 97EC31E050; Fri, 16 Oct 2026 10:54:17 -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 CFC511E04E for ; Fri, 16 Oct 2026 10:54:16 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 35A334BA2E32 for ; Fri, 16 Oct 2026 14:54:10 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 35A334BA2E32 Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=aA/82lmw Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTP id 8AC5D4BA2E0B for ; Fri, 16 Oct 2026 14:52:06 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8AC5D4BA2E0B Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 8AC5D4BA2E0B Authentication-Results: sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1792162326; cv=none; b=m99jLUHcm8lD2G3c8mdJi9WWOYn7onemYwLPqEjlk7j7cw62U80x0049dncZ5uEDsV3umzDSZkQNr6F+jmc3UPVi7EG2HmC6BKK6wFy60O5y21942a0ESG+TfhOalTKcD/K7UszP16bHlmvuGls4XV1ezH5T+7OLK5IKjNbDsew= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1792162326; c=relaxed/simple; bh=kGvsuD9MpH3O+CZgOem8JXIby5A1TXtG1FQdGFnUOV4=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=xY+KV/R48+xRrX3+ZSpMOrj/ltYhJS3v7Y5h0PyQGfhxAsaODDthrHTshRFOVyUZjeyYm1ZgTzZGef12PRhZbw/lebtShPdcUuZ+B48O7ulX+H16LInPb7sesP4LE++N00hj//M3QmbB7I7c6/7qmCSZRhawMacLN42jeVsFKOw= ARC-Authentication-Results: i=1; sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=aA/82lmw DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 8AC5D4BA2E0B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1792162326; 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=G4GFhrzlxC9NhURRyMZOuwB0+aNI1gfL5dksFMgf3Ww=; b=aA/82lmww9/6dpsUcAMUft2I4PGhYC80V48LrVn06TOPICeorLg3nG4u63Bl318u58UHrB Tn7HqlXqkuJMnpyzBnXrAWPmot5/YRAV0CVnyRQUicdebcszkGnnwRJn/SYFqOHGnq+9lX w4KmogWYUo/C1ftKEMDg/n7AJ9n7lkw= Received: from mail-wr1-f71.google.com (mail-wr1-f71.google.com [209.85.221.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-571-Zh-ckPzWPIGGpd8VlZAfcw-1; Fri, 16 Oct 2026 14:52:04 +0000 X-MC-Unique: Zh-ckPzWPIGGpd8VlZAfcw-1 X-Mimecast-MFC-AGG-ID: Zh-ckPzWPIGGpd8VlZAfcw_1792162324 Received: by mail-wr1-f71.google.com with SMTP id ffacd0b85a97d-48e011829easo426682f8f.3 for ; Fri, 16 Oct 2026 07:52:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1792162324; x=1792767124; h=content-type:mime-version:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to:content-type; bh=G4GFhrzlxC9NhURRyMZOuwB0+aNI1gfL5dksFMgf3Ww=; b=q8Nlfeo0AGoOPm8b5Be0l1znL4tW3+Y493tLgjtXEUG//ENXEdNVBw76jJwbwqGa/7 l18mKivHclc7PlHuIQF0wFk+Qtl1wqmPiRuS5X2nm9OeIbv6vIFG9bhn59EQhZPzosvr 56Q7mixO4wU5amhDeOmS353ZWL97SJ7Cn42s1YPi86g1EPGGBHfB1I6ddwh1V/3TTlYw bwgGxNplwjuJ4K2VzDm5b6kS+O8FVFBZgXLRErek2vGdFj7HdzjJ/8xw+dEsFrXlC0G0 eeMksECeRFsA5DYjLOB0+6w7bvgMY5tNEA2MerUouhLdvB74EqYfZmImQFVm6qZWvtl9 fw6g== X-Gm-Message-State: AFq9FYJb8jCBqPkPyuf4ku0NyUzKcVvEo8kZ+R5PLAvLFkEUpu3B7lhx jgk2oIw/iW7aZxz8FzVBillM8YXYlF67X0LIALmC56BoPaLOgeP8T4woW4y0zAD+/fZn4ZRKhY/ RtVLvWwew4pjuVk8xKGb0W08J0emPo5qSPtr/Q/D9rIpwQTDswQGBkgnLUnTZ7mjmiwj6sN4= X-Gm-Gg: AYBFou31wgeUdktHKnDhgoIST6eNfymw4VuYAS9Lpq2w8MmxrX/ytNUCdgkJV/pi0/s u2gTkvo53Zw8cZ6zW2OxrVTHn+PhPjQIWeRFivnloIpn6BDRo7E8QT16vKeEdwCSG/dFo/o0wuA qKEcf1k6KsaAn0Q87JwjjTQkSR1K5UNEmm5UydhYDBp6kS4KVm3HC2Mfotlm6GodCJRu0peAZdZ OlVhgURMyhHyZ8wB1VfRqHZzb3Uk9akavY9v7ND1MY7G9xnXzmvHsYDo2bk/idvnGxJm2C9UE7N 2VL62/+vqG5yZzACy/ySJwZ7e76okek0CEv48+M50z8T5QBBWaxaVcZfR4TIW6VxNy9C X-Received: by 2002:adf:e012:0:10b0:48c:4d32:ccfd with SMTP id ffacd0b85a97d-48dba7845d7mr33433154f8f.6.1792162323703; Fri, 16 Oct 2026 07:52:03 -0700 (PDT) X-Received: by 2002:adf:e012:0:10b0:48c:4d32:ccfd with SMTP id ffacd0b85a97d-48dba7845d7mr33433122f8f.6.1792162323264; Fri, 16 Oct 2026 07:52:03 -0700 (PDT) Received: from localhost ([213.31.44.29]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-48dfd4c5813sm8579791f8f.17.2026.10.16.07.52.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 16 Oct 2026 07:52:02 -0700 (PDT) From: Andrew Burgess To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [PATCH 5/5] gdb/doc: more @command and @kbd In-Reply-To: <861p9thlmf.fsf@gnu.org> References: <78963dad04bf629669f7affab3711ba7df159b46.1791831032.git.aburgess@redhat.com> <861p9thlmf.fsf@gnu.org> Date: Fri, 16 Oct 2026 15:52:01 +0100 Message-ID: <87o6ct8zqm.fsf@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: PVI-JTJjuVrcBu1jUcEZdtYSDk1QaaSd7Mnl6aEzaNw_1792162324 X-Mimecast-Originator: redhat.com Content-Type: text/plain 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 Eli Zaretskii writes: >> 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 Eli, I addressed the nits you pointed out and pushed this series. Thanks, Andrew