From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 32182 invoked by alias); 12 Aug 2012 05:06:31 -0000 Received: (qmail 32174 invoked by uid 22791); 12 Aug 2012 05:06:30 -0000 X-SWARE-Spam-Status: No, hits=-5.5 required=5.0 tests=AWL,BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,KHOP_RCVD_TRUST,KHOP_THREADED,RCVD_IN_DNSWL_LOW,RCVD_IN_HOSTKARMA_YE,T_RP_MATCHES_RCVD X-Spam-Check-By: sourceware.org Received: from mail-vc0-f169.google.com (HELO mail-vc0-f169.google.com) (209.85.220.169) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sun, 12 Aug 2012 05:06:17 +0000 Received: by vcbfl10 with SMTP id fl10so3061950vcb.0 for ; Sat, 11 Aug 2012 22:06:16 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:x-system-of-record:x-gm-message-state; bh=w2ia5vh5HVMJpu775q8iB5STH3eII7ap3XZhWYp4ZI4=; b=VoZ7EC1M3hkd9raQttPoB+hL6y6HsjdlJVPy0QXH2/ORkCV0V2VClLXXvhSvHMbIi4 Phg50cfXvhGAt9OaadTmPr9hYEQWXalhUZonsC2gz4vhK/2ntYzZadx0aMI8rDt7Bdj1 flYscN62qxrCVwcHXfwZJnm9vHJkizL0nfxV36vs2x2i84cus0b4ChPVAjJ26oZbPQfM mtGbfZP8PNCJSQtK/Q4PIwp0ymf4kxa84rcSiRTHO6OxisEj020TtgmhipkHHsNxt3w2 lXGW0ZECkABM7vinmgixAgqxSE0fIQrFNsUYbUZs0FM4Cx4iLed03VGr2PNnQ7W4nebx 0aZQ== Received: by 10.220.222.20 with SMTP id ie20mr6076047vcb.13.1344747976692; Sat, 11 Aug 2012 22:06:16 -0700 (PDT) MIME-Version: 1.0 Received: by 10.220.222.20 with SMTP id ie20mr6076037vcb.13.1344747976558; Sat, 11 Aug 2012 22:06:16 -0700 (PDT) Received: by 10.52.157.4 with HTTP; Sat, 11 Aug 2012 22:06:16 -0700 (PDT) In-Reply-To: <201208111336.41052.vapier@gentoo.org> References: <1344704080-24677-1-git-send-email-vapier@gentoo.org> <83fw7tcpst.fsf@gnu.org> <201208111336.41052.vapier@gentoo.org> Date: Sun, 12 Aug 2012 05:06:00 -0000 Message-ID: Subject: Re: [PATCH] gdb: improve usage strings From: Doug Evans To: Mike Frysinger Cc: Eli Zaretskii , gdb-patches@sourceware.org Content-Type: text/plain; charset=ISO-8859-1 X-System-Of-Record: true X-Gm-Message-State: ALoCoQnMGUt02nM+mGl4sR+jyVKs2yhyUBYGIf9BHMuS+BcirW99uohFNLKLJL3EMGY+2K2o5yxoUL5zoI4pkj544eJ6HmKEDBJXVwrATBv771jZtbZgTXfBiHZqN2uYeevSub3E1bTZHL2OQouXosCBFeisoG9Vo+2f8iWNV74HLbksyd9K+U6ZQpc2nfgWEnYNKcsXbaUMNB64YxHtu9TG22oyc/QKFA== 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: 2012-08/txt/msg00347.txt.bz2 On Sat, Aug 11, 2012 at 10:36 AM, Mike Frysinger wrote: > On Saturday 11 August 2012 13:16:18 Eli Zaretskii wrote: >> > From: Mike Frysinger >> > Date: Sat, 11 Aug 2012 12:54:40 -0400 >> > c = add_com ("signal", class_run, signal_command, _("\ >> > >> > -Continue program giving it signal specified by the argument.\n\ >> > -An argument of \"0\" means continue program without giving it a >> > signal.")); >> > +Continue program by sending it the specified signal.\n\ >> >> This "by sending it" is AFAIU inaccurate: we don't continue program >> _by_ sending it the signal, we continue the program _and_ send it the >> signal. I actually don't see anything wrong with the original >> wording. > > ok, but your response shows what i was trying to fix: > - adding "the" before "program" > - changing "giving" to "sending" > the "by" change was incidental > > so i'll change it to: > Continue program and send it the specified signal. fwiw, I'm not comfortable with that wording. To the naive user it's not clear (IMO) that the program is resumed with the specified signal, i.e., I can imagine the user wondering if there's a gap between when the target is resumed and when the signal is delivered. Do we have a target where there can be a delay? (e.g, the figurative equivalent of "continue &; kill SIGNAL)? Given that, I like something along the lines of "Continue program by sending it the specified signal."