Re: CLI and GDB/MI documentation patch

[Bob Rossi <bob_rossi at cox dot net>]

On Fri, May 12, 2006 at 10:53:43AM +0300, Eli Zaretskii wrote:
> > Date: Thu, 11 May 2006 21:17:30 -0400
> > From: Bob Rossi <bob_rossi@cox.net>
> > 
> > I hope this looks correct. Please let me know otherwise. I think it's 
> > an improvement over what is there now, and could save others valuable
> > research time.
> 
> Sorry, I don't understand what you are trying to say here, exactly.
> Explaining why we did something in the past does not belong in the
> manual (except maybe in a footnote, if it is _very_ important to
> mention history).

Well, I see your point, and you are the expert in this area. The reason
I put this in the manual is because I think it's important front end
developers know what will happen when they enter CLI commands into mi2.

Old versions of mi2 will act incorrectly, where as new versions of mi2 
will work better.

> Perhaps I wasn't following the thread closely enough, so I missed
> something important.  Can you state what information is missing from
> the current text in this section?  You say above that the changes
> ``could save others valuable research time''--what did you need to
> research, and why, and what did you find that wasn't described in the
> manual?

Well, first off, this is incorrect:

    This mechanism is provided as an aid to developers of @sc{gdb/mi}
    clients and not as a reliable interface into the CLI.

So I thought it was important to describe that it is OK to pass CLI
commands to the MI interpreter for now. However, using -interpreter-exec
is a better approach.

Also, look at Vladimir's comments. None of this information is intuitive
using the MI interface. You have to slowly figure it out.

Thanks,
Bob Rossi