[PATCH 2/2] gdb/python: make more use of RegisterDescriptors

Eli Zaretskii eliz@gnu.org
Fri Jul 24 10:36:41 GMT 2020


> From: Andrew Burgess <andrew.burgess@embecosm.com>
> Date: Fri, 24 Jul 2020 10:57:52 +0100
> 
> +A @code{gdb.RegisterDescriptor} object, see @ref{Registers In Python}
> +for further information.

Please add a comma after the closing brace of @ref.  Newer versions of
Texinfo don't need that, but older ones will barf.

> +@item
> +A @value{GDBN} internal, platform specific number.  Using these
> +numbers is supported for historic reasons, but is not recommended as
> +future changes to @value{GDBN} could change the mapping between numbers
> +and the registers they represent, breaking any Python code.  The

I suggest "breaking any Python code that uses the platform-specific
numbers", to qualify the breakage.

The documentation part is okay with these nits fixed.  Thanks.


More information about the Gdb-patches mailing list