Re: [patch][python] Add symbol, symbol table and frame block support to GDB API

Eli Zaretskii
2010-02-19T14:28:41Z

> Date: Fri, 19 Feb 2010 14:14:57 +0000
> From: Phil Muldoon <pmuldoon@redhat.com>
> Cc: Eli Zaretskii <eliz@gnu.org>, gdb-patches ml <gdb-patches@sourceware.org>
>
> +* Python scripting
> +
> +The GDB Python API now has access to symbols, symbol tables, and
> +frame's code blocks.
> +

This is okay, thanks.

> +@defmethod Frame block
> +Returns the frame's code block. @xref{Blocks In Python}.
> +@end defmethod
> +
> +@defmethod Frame function
> +Returns the symbol for the function corresponding to this frame.
> +@xref{Symbols In Python}.
> +@end defmethod

Please use "Return" rather than "Returns".

> +Please see @ref{Frames In Python} for a more in-depth discussion on
> +frames. Furthermore, see @ref{Stack, ,Examining the Stack} for more
> +detailed technical information on @value{GDBN}'s book-keeping of the
> +stack.

And still no comma after @ref{...}.