From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 92049 invoked by alias); 7 Sep 2019 06:33:43 -0000 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 Received: (qmail 92038 invoked by uid 89); 7 Sep 2019 06:33:43 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-16.1 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,SPF_PASS autolearn=ham version=3.3.1 spammy=H*r:4.82, H*r:sk:RSA_AES, H*r:142, letter X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (209.51.188.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 07 Sep 2019 06:33:42 +0000 Received: from fencepost.gnu.org ([2001:470:142:3::e]:55225) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1i6UHz-0008CH-Md; Sat, 07 Sep 2019 02:33:39 -0400 Received: from [176.228.60.248] (port=4987 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1i6UHx-0005sU-NT; Sat, 07 Sep 2019 02:33:38 -0400 Date: Sat, 07 Sep 2019 06:33:00 -0000 Message-Id: <83sgp862f2.fsf@gnu.org> From: Eli Zaretskii To: Pedro Alves CC: gdb-patches@sourceware.org In-reply-to: <20190906232807.6191-24-palves@redhat.com> (message from Pedro Alves on Sat, 7 Sep 2019 00:28:07 +0100) Subject: Re: [PATCH 23/23] Multi-target: NEWS and user manual References: <20190906232807.6191-1-palves@redhat.com> <20190906232807.6191-24-palves@redhat.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-IsSubscribed: yes X-SW-Source: 2019-09/txt/msg00101.txt.bz2 > From: Pedro Alves > Date: Sat, 7 Sep 2019 00:28:07 +0100 > > - > -* Inferiors and Programs:: Debugging multiple inferiors and programs > +* Inferiors Connections and Programs:: Debugging multiple inferiors connections and programs The new line is too long, please break it in two. > +@item > +the target connection the inferior is bound to. This includes the > +unique connection number assigned by @value{GDBN}, and the name of the > +protocol used by the connection. Having this @item start with a lowercase letter, and then having another sentence in it looks awkward, English-wise. How about making this a single sentence, as in "... is bound to, including the unique connection number ..."? > +@enumerate > +@item > +the connection number assigned by @value{GDBN} This should end in a period, as the other items do. > +@item > +the connection name, derived from the protocol used by the connection. "Name" sounds ... inaccurate, when it can be something like "extended-remote host:10000", doesn't it? How about "Type"? Or maybe call that "Description" and the last field "Details"? > +There's no explicit way to switch focus between connections. Instead, > +you switch focus between inferiors, which implicitly switches the > +focus to the selected inferior's connection. > + > To switch focus between inferiors, use the @code{inferior} command: What does "focus" mean in this context? Either we should explain that here, or have a cross-reference where that is already explained. > diff --git a/gdb/NEWS b/gdb/NEWS > index f382e887c0..20aad73aa5 100644 > --- a/gdb/NEWS > +++ b/gdb/NEWS This part is OK. Thanks.