Re: [rfc] Stop unlikely "run"'s earlier

[Eli Zaretskii <eliz at gnu dot org>]

> Date: Wed, 7 Nov 2007 17:17:30 -0500
> From: Daniel Jacobowitz <drow@false.org>
> 
> On Thu, Nov 08, 2007 at 12:06:16AM +0200, Eli Zaretskii wrote:
> > I'm okay with the change, but how do you feel about updating the docs
> > as well?  Should we?
> 
> I just looked at the description of "run" in the manual.  If anything,
> this patch brings GDB better in line with its manual, but if you can
> think of a way to describe the difference I'm all ears.

Well, under "target remote" (in the node "Connecting") we say:

    Once the connection has been established, you can use all the usual
    commands to examine and change data and to step and continue the
    remote program.

Given you description, I'd say this should be augmented by explaining
that the program is already running at this stage, and telling the
user to use "continue", as opposed to "run" in local debugging.

Also, under "run" (in node "Starting"), it'd be a good thing to cite
the error message you want top introduce:

  The "remote" target can not run programs.  Try "help target" or "continue".

and tell the reader that the most probable cause here is that "run"
was used rather than "continue".  Without such an explanation, I'd be
quite lost if I saw this message (what do you mean ``can't run''? how
can I debug the darn thing it it cannot be run?)

WDYT?