[RFC] Thread Name Printers

[Eli Zaretskii]

> Date: Fri, 24 Aug 2012 15:02:04 -0700
> From: Aaron Gamble <agamble@google.com>
> Cc: gdb-patches@sourceware.org
> 
> New patch. See inline comments.

Thanks.  I have comments about the documentation part.

> +Thread name printers are registered and may be disabled and enabled by the
> +provided alias when the printer was registered.

What does it mean "enabled by the provided alias"?

> +Once a printer has been defined, it can be instantiated and added to the global
> +list of printers as follows:
> +@code{my_printer_class().add_printer("my printer alias")}

The last line should be in @smallexample block.

> +@defun thread_name_printer.prepare (@var{self})
> +@value{GDBN} will call this method for each printer at the beginning of the
> +'info threads' command.

"info threads" should be in @code and without the quotes.

> +method in each enabled printer until a string is returned. It is up to each thread printer
                                                            ^^
Two spaces here.

> +@var{thread_info} is the InferiorThread as defined in @pxref{Threads In Python}.

@pxref is for text in parentheses.  You want @ref here.