From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id t/+aLQwtzWq/NjwAWB0awg (envelope-from ) for ; Mon, 12 Oct 2026 14:55:08 -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=bB7YToHi; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id A6D3D1E06B; Mon, 12 Oct 2026 14:55:08 -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 DCF131E050 for ; Mon, 12 Oct 2026 14:55:07 -0400 (EDT) Received: from vm01.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 6E4914BA23E1 for ; Mon, 12 Oct 2026 18:55:06 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6E4914BA23E1 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=bB7YToHi Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTP id 7DC384BA2E3D for ; Mon, 12 Oct 2026 18:54:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 7DC384BA2E3D 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 7DC384BA2E3D Authentication-Results: sourceware.org; arc=none smtp.remote-ip=170.10.133.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791831281; cv=none; b=bKjisJ4kTrNgn/7BgyUG/7cgV0a9+8zlFfCPne1Y0ZY6RfM8hE+rTKXjg4iypB3jWIZHjopNkpcN1GI5bpqayvnpDsZ7CuSE/jEZMJv03i1fIl/kB2TKRsNPt1kkEsr4xgcweo5a4NmEWafIY53R9DXsAxtNGp+p9ru9jXt5AoI= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1791831281; c=relaxed/simple; bh=2rOImluhtnOU9bm1NSdD0zlrkVvgvVwvRq1Vcsp6K1g=; h=DKIM-Signature:From:To:Subject:Date:Message-Id:MIME-Version; b=EhLydeIw7yFVRnoQNTShA78ZLB/VNeRY6AsZkc87Bd8UW7r0uwF7VSHfAo+sWX2Bru6UT/P2EYS09v8jUoiSeOFVmm9s7RChEM+7GTm8HOxlFnbxMsOBD9aV38Tcf+wgc4vNTz3jlhawT+/h7Mo+lC0xu8ZCKtIjsBLYAX6MsgI= 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=bB7YToHi DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7DC384BA2E3D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1791831281; 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: content-transfer-encoding:content-transfer-encoding; bh=x/ESXmucAP1CF35aJWJWdBLbK3m7Nn+PtmPj3sFP/MU=; b=bB7YToHiTd6i+PkZNn00m0a98URfpv0GLgK+n7Urthw3uoRdyR6mOQJrls10NCcfzcKPrP ZzEj9ZQGCU3HkSqgQo/Kxev59Hl1B0domKM5mo7MPuieU/PVlZJZmmLlqWJ5c+xpJ6BOmw trntvi9FnBjya5H/baS23bIcSLkcKXk= Received: from mail-wm1-f72.google.com (mail-wm1-f72.google.com [209.85.128.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-676-vUdvbFkWO0uw7rt7l5UKug-1; Mon, 12 Oct 2026 18:54:40 +0000 X-MC-Unique: vUdvbFkWO0uw7rt7l5UKug-1 X-Mimecast-MFC-AGG-ID: vUdvbFkWO0uw7rt7l5UKug_1791831279 Received: by mail-wm1-f72.google.com with SMTP id 5b1f17b1804b1-49cdc4080ddso16849955e9.1 for ; Mon, 12 Oct 2026 11:54:39 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20260707; t=1791831279; x=1792436079; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=x/ESXmucAP1CF35aJWJWdBLbK3m7Nn+PtmPj3sFP/MU=; b=kdkETEtDLCUxwj0pd21Wp6uMeKDWBMB2DP01qo9N2AKCxP723ZqqSgg674uwLyPPKi aPv7RZcffzUf/ANlD3DDh0jv3F/n23z39vMP2O1VU4Ua4JBQvZoA1vOSWzplD68Dugw9 T2/Q5w5d+E/8jodLPC2LCY8CgzzTF08Cq0/4Gas1DprVLzA4MDjpSRnzYftAPuzlMxGU 0gax1OzhOJRcgE2mi51oivE64e4YrXsGtn54FhY0I2PV51gKO/twCCOBwyDNbiWZDe3l X+VtSc1jCncwEFNWFYGQ+0F4cP0BcI+FG78Pvy7FZb6u8O7UKKF2iu4OgJU0OBCpgp0H twOw== X-Gm-Message-State: AFq9FYJTWQnV/YgoD8AyS7Zv/qg6ntOn773HRR3YFWIiKK/OpDv7LpZ0 RLxliehJ3j3jRetMax75mhDwMXGeVEy1J3tr0kF+Anr5XgytsWnNWIKGSKYPpf47lMTGVCukZt5 smpktSclUU4CiyBlBvqad9ituQRCGyZDzDlgXxJPAUduSrh+88NKi6KOXKcSEK090YA4ZebJzzI X32zyZhjs1VDs4OZPC/hFa0+rM03EHN2ajOwkg5jH3f3DNU8I= X-Gm-Gg: AYBFou2rx88UCqzriHToQI9rYeSpznMOcqPPK/QvjEc8Ks2XgmwCEBXc1IouZFwIXhC NXDgXdrEAgTDamuciicCx8NkR+du35xSaHl/KgUqklMTIR2iliLc83g2zXSXABOZkY92DG9xrRc x7sXUA0TkRylyfkkjMxvlkxGqxEpO931XELwyYn68vaHNUrnSTNJxQ8ILUcntYySJhp5xIE3r1x L7ecmyLhgJON5K6lwTJ+ElRHIQqoLgh8M7in4cQVxVyAHN41jhPQiDrvAEUX6kBQdR0ONGMLe+F +f64LGXrVLQg16VLvZO3C8nG9b0SIf9ft7noH0UvckwlckE1CEPQYTp9nyfsaL/Od98S X-Received: by 2002:a05:600c:810a:b0:4a0:ec5:46d9 with SMTP id 5b1f17b1804b1-4a18e3ef100mr181851275e9.0.1791831278815; Mon, 12 Oct 2026 11:54:38 -0700 (PDT) X-Received: by 2002:a05:600c:810a:b0:4a0:ec5:46d9 with SMTP id 5b1f17b1804b1-4a18e3ef100mr181851025e9.0.1791831278307; Mon, 12 Oct 2026 11:54:38 -0700 (PDT) Received: from localhost ([213.31.44.29]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4a18e48db03sm429833235e9.3.2026.10.12.11.54.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Oct 2026 11:54:37 -0700 (PDT) From: Andrew Burgess To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PATCH 0/5] gdb/doc: a series of doc clean ups Date: Mon, 12 Oct 2026 19:54:25 +0100 Message-Id: X-Mailer: git-send-email 2.25.4 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: 6Z6ys176BXnmFdWs0kN_URB5u5aoXfSi0OGocLG0akw_1791831279 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit content-type: text/plain; charset="US-ASCII"; x-default=true 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 This is mostly about using the correct @WORD wrapper in more places. The GDB docs tend to overuse @code{...} and @samp{...} when there are better choices available. There's also a patch related to how we format on/off choices in command help text. There's probably a lot more stuff that can be cleaned up in the docs, but I thought I'd see how this goes to begin with. Thanks, Andrew --- Andrew Burgess (5): gdb/doc: use (@value{GDBP}) for the prompt in examples gdb/doc: fix some incorrect '@table @code' uses gdb/doc: consistent formatting for on|off on @item lines gdb/doc: make more use of @option{...} formatting gdb/doc: more @command and @kbd gdb/doc/gdb.texinfo | 1820 +++++++++++++++++++++---------------------- gdb/doc/guile.texi | 64 +- gdb/doc/python.texi | 58 +- 3 files changed, 971 insertions(+), 971 deletions(-) base-commit: b7ee9065ecd249773b7d582eee723686fc58dd5d -- 2.55.0