Re: [RFC] MI non-stop and multiprocess docs.

[Vladimir Prus <vladimir@codesourcery.com>]

On Thursday 13 November 2008 00:06:39 Eli Zaretskii wrote:
> > From: Vladimir Prus <vladimir@codesourcery.com>
> > Date: Wed, 12 Nov 2008 23:20:28 +0300
> > Cc: gdb-patches@sources.redhat.com
> > 
> > > > > Finally, this chapter seems to be not on design of MI, but more about
> > > > > advice to frontend implementors.  So I think it should be renamed
> > > > > accordingly, and some introductory text added to its beginning saying
> > > > > this is the intent of the chapter.
> > > > 
> > > > I don't quite agree. These section describes the main building blocks and 
> > > > concepts of GDB/MI, and is necessary to understand anything in GDB/MI
> > > > docs.
> > > 
> > > Right, but IMO that isn't "MI design", either.
> > 
> > Ok, what title would you suggest?
> 
> "General Aspects of Interacting with GDB/MI"?

That's heavy, I think. If you object to "design" then what about:

	- "GDB/MI General Overview", or
	- "GDB/MI General Concepts",

> > > > > > +that even commands that operate on global state (like global
> > > > > > +variables, or breakpoints), still access the target in the context of
> > > > > > +a specific thread
> > > > > 
> > > > > What do you mean by "global variables" here?  As written, the text
> > > > > seems to say that global variables and breakpoints are commands, or
> > > > > maybe global state, which doesn't sound right to me.  "Breakpoints"
> > > > > could be replaced with "breakpoint commands", but I don't know what
> > > > > replacement to suggest for "global variables".
> > > > 
> > > > global variables, and breakpoints, are examples of the "global state"
> > > > that GDB commands can operate on.
> > > 
> > > What GDB commands operate on global variables?
> > 
> > Say, 'print' and 'set' can operate on global variables.
> 
> Then how about
> 
>   even commands that operate on global state, such as @code{print},
>   @code{set}, and breakpoint commands, still access the target in the
>   context of a specific thread.

Changed.

> > > The new version is fine, except that there are still instances of only
> > > one space after a period that ends a sentence.
> > 
> > I've just went though MI section with a regexp, fixing this issue.
> 
> Thanks.  One instance still got through:
> 
> > +To allow the user to discover such grouping, and to support arbitrary
> > +hierarchy of machines/cores/processes, MI introduces the concept of a
> > +@dfn{thread group}.  Thread group is a collection of threads and other
> > +thread groups. A thread group always has a string identifier, a type,

Fixed.

- Volodya