Re: [PATCH 1/5] gdb/doc: improve Python Disassembler API documentation

Eli Zaretskii via Gdb-patches
2023-04-04T11:36:22Z

> Cc: Andrew Burgess <aburgess@redhat.com>
> Date: Tue, 4 Apr 2023 09:21:03 +0100
> From: Andrew Burgess via Gdb-patches <gdb-patches@sourceware.org>
>
> --- a/gdb/doc/python.texi
> +++ b/gdb/doc/python.texi
> @@ -6909,7 +6909,7 @@
> @code{RuntimeError} exception if it is invalid.
> @end defun
>
> -@defun DisassembleInfo.__init__ (info)
> +@defun DisassembleInfo.__init__ (@var{info})

You consistently rewrite the Texinfo source to use @var inside the
argument lists of a @defun. I already asked why, as I don't think
this is required. I don't think you replied. So once again: why are
you doing this? what problems happen if you don't?

Otherwise, this is fine. Thanks.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>