From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 2WfIAXrjr2kMayEAWB0awg (envelope-from ) for ; Tue, 10 Mar 2026 05:25:14 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; unprotected) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=OYN2Oinf; dkim=pass header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=LCbW5j75; dkim=pass (1024-bit key) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=OYN2Oinf; dkim=neutral header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=LCbW5j75; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id F18261E0DD; Tue, 10 Mar 2026 05:25:13 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, 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 21FC01E08D for ; Tue, 10 Mar 2026 05:25:12 -0400 (EDT) Received: from vm01.sourceware.org (localhost [127.0.0.1]) by sourceware.org (Postfix) with ESMTP id A39064BA23CD for ; Tue, 10 Mar 2026 09:25:11 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org A39064BA23CD Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=OYN2Oinf; dkim=pass header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=LCbW5j75; dkim=pass (1024-bit key) header.d=suse.de header.i=@suse.de header.a=rsa-sha256 header.s=susede2_rsa header.b=OYN2Oinf; dkim=neutral header.d=suse.de header.i=@suse.de header.a=ed25519-sha256 header.s=susede2_ed25519 header.b=LCbW5j75 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.223.131]) by sourceware.org (Postfix) with ESMTPS id 37F254BA23C9 for ; Tue, 10 Mar 2026 09:19:13 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 37F254BA23C9 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=suse.de Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.de ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 37F254BA23C9 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=195.135.223.131 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1773134353; cv=none; b=rElJL+ihGMKy87pgBxrLFMMNOE/gHVwuVdGeNQAbosJZw6lwfSA4bewnUPks3NzSle+vhkSlTmr0Ex4yvzaIeZK1zNCBta1vTb30vVZ2AlZfWvXAO2Sy4ykhWa6d9dGQfK2v7pzlJE5wS6SR9uGyF9cs5UPITZsgFsko3wKLLRE= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1773134353; c=relaxed/simple; bh=QDLw5LxDLTQn1/CuZgRlSoqFcMJufxtxII/3RqnaEKY=; h=DKIM-Signature:DKIM-Signature:DKIM-Signature:DKIM-Signature:From: To:Subject:Date:Message-ID:MIME-Version; b=Bkyc6n1J1Tm5VGTPopxiwaVElZg/Wcap3MSWInxsDyntP+3/RC0QMrFsdXBW2v4Vslb0LjADx/h6utfwNpTJGZ/B3fHO+VKVz2PGAQRnJhHiBX6do+iPebtE6OKJuVpnewed5mM69X7NBm1FLDM361vSC/wVLLJ+UtaZR3mDOas= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 37F254BA23C9 Received: from imap1.dmz-prg2.suse.org (unknown [10.150.64.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id 6F8055BE1A for ; Tue, 10 Mar 2026 09:18:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1773134324; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mtVBI8RvMfQX+c3JOJurTFEt9TQZKbchZ5Z2bF85oc0=; b=OYN2OinfgSx6voykU7BE7pn+uXNpe1/SadW+pnNKrATPDGf5o6at8TPvK5vmXB/4e2ijdp wrfTSZsa6lPq5JpgwPXNo7MTUnd+2ChFAZMm5G8icBMVpxuJAzHneAYV3A5T6j8H063o4d j31LdAiiG5aM7lTRjEKeb3u9OTx2Feg= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1773134324; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mtVBI8RvMfQX+c3JOJurTFEt9TQZKbchZ5Z2bF85oc0=; b=LCbW5j75lwhoGv0m9JjBFKcmwiBfH1A2Vk46EGFXQVoge7YHflLPHEg4LQr5R80lJx1aMt B8XWrPFkOCaCBOAw== Authentication-Results: smtp-out2.suse.de; none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa; t=1773134324; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mtVBI8RvMfQX+c3JOJurTFEt9TQZKbchZ5Z2bF85oc0=; b=OYN2OinfgSx6voykU7BE7pn+uXNpe1/SadW+pnNKrATPDGf5o6at8TPvK5vmXB/4e2ijdp wrfTSZsa6lPq5JpgwPXNo7MTUnd+2ChFAZMm5G8icBMVpxuJAzHneAYV3A5T6j8H063o4d j31LdAiiG5aM7lTRjEKeb3u9OTx2Feg= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_ed25519; t=1773134324; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=mtVBI8RvMfQX+c3JOJurTFEt9TQZKbchZ5Z2bF85oc0=; b=LCbW5j75lwhoGv0m9JjBFKcmwiBfH1A2Vk46EGFXQVoge7YHflLPHEg4LQr5R80lJx1aMt B8XWrPFkOCaCBOAw== Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id 5ADCC3F3A1 for ; Tue, 10 Mar 2026 09:18:44 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id eGn/FPThr2k2SAAAD6G6ig (envelope-from ) for ; Tue, 10 Mar 2026 09:18:44 +0000 From: Tom de Vries To: gdb-patches@sourceware.org Subject: [PATCH 7/7] [pre-commit] Make gdb/doc codespell-clean Date: Tue, 10 Mar 2026 10:18:43 +0100 Message-ID: <20260310091843.3214063-8-tdevries@suse.de> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20260310091843.3214063-1-tdevries@suse.de> References: <20260310091843.3214063-1-tdevries@suse.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spamd-Result: default: False [-2.80 / 50.00]; BAYES_HAM(-3.00)[100.00%]; NEURAL_HAM_LONG(-1.00)[-1.000]; MID_CONTAINS_FROM(1.00)[]; R_MISSING_CHARSET(0.50)[]; NEURAL_HAM_SHORT(-0.20)[-1.000]; MIME_GOOD(-0.10)[text/plain]; FUZZY_RATELIMITED(0.00)[rspamd.com]; RCVD_VIA_SMTP_AUTH(0.00)[]; RCPT_COUNT_ONE(0.00)[1]; ARC_NA(0.00)[]; DKIM_SIGNED(0.00)[suse.de:s=susede2_rsa,suse.de:s=susede2_ed25519]; DBL_BLOCKED_OPENRESOLVER(0.00)[suse.de:mid]; FROM_EQ_ENVFROM(0.00)[]; FROM_HAS_DN(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; TO_MATCH_ENVRCPT_ALL(0.00)[]; TO_DN_NONE(0.00)[]; PREVIOUSLY_DELIVERED(0.00)[gdb-patches@sourceware.org]; RCVD_TLS_ALL(0.00)[] 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 Fix typos in gdb/doc and replace "SME" with "sme" in gdb/contrib/codespell-ignore-words.txt, and add "wither" and "stap". --- .pre-commit-config.yaml | 2 +- gdb/contrib/codespell-ignore-words.txt | 4 +- gdb/doc/gdb.texinfo | 58 +++++++++++++++++++------- 3 files changed, 46 insertions(+), 18 deletions(-) diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml index c936cce67dc..65feb7f239e 100644 --- a/.pre-commit-config.yaml +++ b/.pre-commit-config.yaml @@ -71,7 +71,7 @@ repos: rev: v2.4.2 hooks: - id: codespell - files: '^(gdbsupport|gdbserver|gdb/(stubs|features|nat|contrib|dwarf2|tui|target|data-directory|po|system-gdbinit|mi|syscalls|arch|regformats|compile|python|guile|config|unittests|cli|testsuite/gdb.(ctf|dap|debuginfod|gdb|go|guile|mi|modula2|objc|opencl|opt|pascal|perf|replay|reverse|rocm|server|stabs|testsuite|tui|xml)))/' + files: '^(gdbsupport|gdbserver|gdb/(doc|stubs|features|nat|contrib|dwarf2|tui|target|data-directory|po|system-gdbinit|mi|syscalls|arch|regformats|compile|python|guile|config|unittests|cli|testsuite/gdb.(ctf|dap|debuginfod|gdb|go|guile|mi|modula2|objc|opencl|opt|pascal|perf|replay|reverse|rocm|server|stabs|testsuite|tui|xml)))/' args: [--toml, gdb/pyproject.toml] - id: codespell name: codespell-log diff --git a/gdb/contrib/codespell-ignore-words.txt b/gdb/contrib/codespell-ignore-words.txt index b6f80f3ce52..0594fc39a45 100644 --- a/gdb/contrib/codespell-ignore-words.txt +++ b/gdb/contrib/codespell-ignore-words.txt @@ -1,6 +1,8 @@ configury -SME +sme Synopsys aranges fpr parm +wither +stap diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 63f6fe39a55..09ee15f483a 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -384,6 +384,7 @@ or your friends (or enemies, to be evenhanded) have been unfairly omitted from this list, we would like to add your names! @end quotation +@c codespell:ignore-begin So that they may not regard their many labors as thankless, we particularly thank those who shepherded @value{GDBN} through major releases: @@ -562,6 +563,7 @@ Stafford Horne. Weimin Pan, David Faust and Jose E. Marchesi contributed support for the Linux kernel BPF virtual architecture. This work was sponsored by Oracle. +@c codespell:ignore-end @node Sample Session @chapter A Sample @value{GDBN} Session @@ -4978,11 +4980,14 @@ language of the breakpoint's function, other values mean to use the manually specified language (see @ref{Manually, ,Set Language Manually}). The syntax of the regular expression is the standard one used with tools -like @file{grep}. Note that this is different from the syntax used by +like @file{grep}. +@c codespell:ignore-begin +Note that this is different from the syntax used by shells, so for instance @code{foo*} matches all functions that include -an @code{fo} followed by zero or more @code{o}s. There is an implicit -@code{.*} leading and trailing the regular expression you supply, so to -match only functions that begin with @code{foo}, use @code{^foo}. +an @code{fo} followed by zero or more @code{o}s. +@c codespell:ignore-end +There is an implicit @code{.*} leading and trailing the regular expression you +supply, so to match only functions that begin with @code{foo}, use @code{^foo}. @cindex non-member C@t{++} functions, set breakpoint in When debugging C@t{++} programs, @code{rbreak} is useful for setting @@ -9989,7 +9994,9 @@ regular expression. @table @code @kindex search @kindex forward-search +@c codespell:ignore-begin @kindex fo @r{(@code{forward-search})} +@c codespell:ignore-end @cindex @code{$_} and commands that search source files @item forward-search @var{regexp} @itemx search @var{regexp} @@ -9997,8 +10004,11 @@ The command @samp{forward-search @var{regexp}} checks each line, starting with the one following the last line listed, for a match for @var{regexp}. It lists the line that is found and saves it in the convenience variable @code{$_} (@pxref{Convenience Vars, ,Convenience -Variables}). You can use the synonym @samp{search @var{regexp}} -or abbreviate the command name as @code{fo}. +Variables}). +@c codespell:ignore-begin +You can use the synonym @samp{search @var{regexp}} or abbreviate the command +name as @code{fo}. +@c codespell:ignore-end @kindex reverse-search @item reverse-search @var{regexp} @@ -27272,7 +27282,7 @@ exception. When IBT is enabled, the CPU implements a state machine that tracks indirect @code{JMP} and @code{CALL} instructions. The state machine can be either IDLE or WAIT_FOR_ENDBRANCH. When a @code{JMP} or @code{CALL} is -executed the state machine chages to the WAIT_FOR_ENDBRANCH state. In +executed the state machine changes to the WAIT_FOR_ENDBRANCH state. In WAIT_FOR_ENDBRANCH state the next instruction in the program stream must be an @code{ENDBR} instruction, otherwise the processor signals a control protection exception. After executing a @code{ENDBR} instruction @@ -28386,7 +28396,7 @@ palette. Integers 16-255 are the indexes into xterm extended 256-color palette dependent and sometimes can be changed with OSC 4 sequences, e.g. "\033]4;1;rgb:00/FF/00\033\\". A hexadecimal 24-bit TrueColor is specified in the format @samp{#RRGGBB} where RR, GG and BB are the 2-digit hexadecimal -integers specifiing the intensity of the red, green and blue color components, +integers specifying the intensity of the red, green and blue color components, respectively. It is the responsibility of the user to verify that the terminal supports @@ -34238,12 +34248,14 @@ The corresponding @value{GDBN} command is @samp{cd}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -environment-cd /kwikemart/marge/ezannoni/flathead-dev/devo/gdb ^done (gdb) @end smallexample +@c codespell:ignore-end @findex -environment-directory @@ -34278,6 +34290,7 @@ The corresponding @value{GDBN} command is @samp{dir}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -environment-directory /kwikemart/marge/ezannoni/flathead-dev/devo/gdb @@ -34293,6 +34306,7 @@ The corresponding @value{GDBN} command is @samp{dir}. ^done,source-path="$cdir:$cwd" (gdb) @end smallexample +@c codespell:ignore-end @findex -environment-path @@ -34329,6 +34343,7 @@ The corresponding @value{GDBN} command is @samp{path}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -environment-path @@ -34341,6 +34356,7 @@ The corresponding @value{GDBN} command is @samp{path}. ^done,path="/usr/local/bin:/usr/bin" (gdb) @end smallexample +@c codespell:ignore-end @findex -environment-pwd @@ -34360,12 +34376,14 @@ The corresponding @value{GDBN} command is @samp{pwd}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -environment-pwd ^done,cwd="/kwikemart/marge/ezannoni/flathead-dev/devo/gdb" (gdb) @end smallexample +@c codespell:ignore-end @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @node GDB/MI Thread Commands @@ -38280,12 +38298,14 @@ The corresponding @value{GDBN} command is @samp{file}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -file-exec-and-symbols /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx ^done (gdb) @end smallexample +@c codespell:ignore-end @findex -file-exec-file @@ -38309,12 +38329,14 @@ The corresponding @value{GDBN} command is @samp{exec-file}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -file-exec-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx ^done (gdb) @end smallexample +@c codespell:ignore-end @ignore @@ -38586,12 +38608,14 @@ The corresponding @value{GDBN} command is @samp{symbol-file}. @subsubheading Example +@c codespell:ignore-begin @smallexample (gdb) -file-symbol-file /kwikemart/marge/ezannoni/TRUNK/mbx/hello.mbx ^done (gdb) @end smallexample +@c codespell:ignore-end @ignore @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% SECTION %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -41886,11 +41910,13 @@ This command is useful for debugging the Agent Expression mechanism (@pxref{Agent Expressions}). The @samp{agent} version produces an expression useful for data collection, such as by tracepoints, while @samp{maint agent-eval} produces an expression that evaluates directly -to a result. For instance, a collection expression for @code{globa + -globb} will include bytecodes to record four bytes of memory at each -of the addresses of @code{globa} and @code{globb}, while discarding -the result of the addition, while an evaluation expression will do the -addition and return the sum. +to a result. +@c codespell:ignore-begin +For instance, a collection expression for @code{globa + globb} will include +bytecodes to record four bytes of memory at each of the addresses of +@code{globa} and @code{globb}, while discarding the result of the addition, +while an evaluation expression will do the addition and return the sum. +@c codespell:ignore-end If @code{-at} is given, generate remote agent bytecode for all the addresses to which @var{linespec} resolves (@pxref{Linespec Locations}). @@ -43181,7 +43207,7 @@ The two-digit @var{checksum} is computed as the modulo 256 sum of all characters between the leading @samp{$} and the trailing @samp{#} (an eight bit unsigned checksum). -Implementors should note that prior to @value{GDBN} 5.0 the protocol +Implementers should note that prior to @value{GDBN} 5.0 the protocol specification also included an optional two-digit @var{sequence-id}: @smallexample @@ -43226,7 +43252,7 @@ Fields within the packet should be separated using @samp{,} @samp{;} or @samp{:}. Except where otherwise noted all numbers are represented in @sc{hex} with leading zeros suppressed. -Implementors should note that prior to @value{GDBN} 5.0, the character +Implementers should note that prior to @value{GDBN} 5.0, the character @samp{:} could not appear as the third character in a packet (as it would potentially conflict with the @var{sequence-id}). @@ -45209,7 +45235,7 @@ command (@pxref{Remote Configuration, set remote thread-options}). execution. Invalid commands should be reported using the output string. Before the final result packet, the target may also respond with a number of intermediate @samp{O@var{output}} console output -packets. @emph{Implementors should note that providing access to a +packets. @emph{Implementers should note that providing access to a stubs's interpreter may have security implications}. Reply: -- 2.51.0