From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6182 invoked by alias); 17 Nov 2007 11:32:33 -0000 Received: (qmail 6174 invoked by uid 22791); 17 Nov 2007 11:32:32 -0000 X-Spam-Check-By: sourceware.org Received: from romy.inter.net.il (HELO romy.inter.net.il) (213.8.233.24) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 17 Nov 2007 11:32:27 +0000 Received: from HOME-C4E4A596F7 ([81.5.32.198]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id JKP24812 (AUTH halo1); Sat, 17 Nov 2007 13:32:09 +0200 (IST) Date: Sat, 17 Nov 2007 11:32:00 -0000 Message-Id: From: Eli Zaretskii To: Daniel Jacobowitz CC: gdb-patches@sourceware.org In-reply-to: <20071107221730.GA31647@caradoc.them.org> (message from Daniel Jacobowitz on Wed, 7 Nov 2007 17:17:30 -0500) Subject: Re: [rfc] Stop unlikely "run"'s earlier Reply-to: Eli Zaretskii References: <20071107211833.GA28200@caradoc.them.org> <20071107221730.GA31647@caradoc.them.org> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2007-11/txt/msg00349.txt.bz2 > Date: Wed, 7 Nov 2007 17:17:30 -0500 > From: Daniel Jacobowitz > > 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?