From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 6EAD73858400 for ; Sat, 11 Sep 2021 16:19:18 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6EAD73858400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:36998) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mP5in-0001JI-P5; Sat, 11 Sep 2021 12:19:17 -0400 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:1354 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mP5in-0005Ty-CY; Sat, 11 Sep 2021 12:19:17 -0400 Date: Sat, 11 Sep 2021 19:19:06 +0300 Message-Id: <83a6kjgk5h.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org In-Reply-To: <37446c3e42665c3873d29ac5acae4826642c84e9.1631375869.git.andrew.burgess@embecosm.com> (message from Andrew Burgess on Sat, 11 Sep 2021 17:03:23 +0100) Subject: Re: [PATCH 1/3] gdb/python: introduce gdb.TargetConnection object type References: <37446c3e42665c3873d29ac5acae4826642c84e9.1631375869.git.andrew.burgess@embecosm.com> X-Spam-Status: No, score=-8.1 required=5.0 tests=BAYES_00, GIT_PATCH_0, KAM_DMARC_STATUS, RCVD_IN_BARRACUDACENTRAL, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Sep 2021 16:19:19 -0000 > From: Andrew Burgess > Date: Sat, 11 Sep 2021 17:03:23 +0100 > > diff --git a/gdb/NEWS b/gdb/NEWS > index f9485520438..6d8739573b3 100644 > --- a/gdb/NEWS > +++ b/gdb/NEWS > @@ -17,6 +17,22 @@ maint show backtrace-on-fatal-signal > integer, the index of the new item in the history list, is > returned. > > + ** New gdb.TargetConnection object type that represents a connection > + (as displayed by the 'info connections' command). > + > + ** The gdb.Inferior type now has a 'connection' property which is an > + instance of gdb.TargetConnection, the connection used by this > + inferior. This can be None if the inferior has no connection > + (for example, when exited). > + > + ** New 'gdb.events.connection_removed' event registry, which emits a > + 'gdb.ConnectionEvent' when a connection is removed from GDB. > + This event has a 'connection' property, a gdb.TargetConnection > + object for the connection being removed. > + > + ** New gdb.connections() function that returns a list of all > + currently active connections. > + > *** Changes in GDB 11 This part is OK. > +@node Connections In Python > +@subsubsection Connections In Python > +@cindex Connections In Python Index entries should not generally use capital letters (because then sorting the index will produce different orders in different locales). > +@value{GDBN} uses the @code{gdb.TargetConnection} object type to > +represent a connection in Python code. To get a list of all > +connections use @code{gdb.connections()} Please remove the "()" parentheses, there's no need to use them here. > +An example of a connection type that might have additional details is > +the @samp{remote} connection, in this case the details string can > +contain the @samp{hostname:port} that was used to connect to the Either "the host name and the port" (without @samp), or "@samp{@var{hostname}:@var{port}}", since these are meta-syntactic variables. Thanks.