Re: [Patch v12 1/4] Documentation of the debug method support in GDB Python API

[Eli Zaretskii <eliz@gnu.org>]

> Date: Tue, 1 Apr 2014 15:52:46 -0700
> From: Siva Chandra <sivachandra@google.com>
> 
> Siva> +The @value{GDBN} Python API provides classes, interfaces and functions
> Siva> +to implement, register and manipulate debug methods.  The core concepts
> Siva> +involved in implementing debug methods are @emph{debug method matchers}
> Siva> +and @emph{debug method workers}.
> 
> Eli> The last sentence is a repetition of what the previous section said.
> Eli> Do we really need this here?
> 
> I can remove the repetitive sentence. However, for the HTML version of
> the manual with each node on its own page, the repetition makes the
> page self contained (I think).

You can put a cross-reference to that other node.

> Siva> +An instance of @code{DebugMethodMatcher} has the following attributes:
> Siva> +
> Siva> +@defvar DebugMethodMatcher.name
> Siva> +The name of the matcher.
> Siva> +@end defvar
> 
> Eli> I think we use only the attribute name, without the class name.
> 
> Are you referring to 'DebugMethodMatcher.name'? I find that other
> Python types are also documented in this fashion.

They are all wrong.  The majority doesn't.