From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id mB13KPnOJWRBXR4AWB0awg (envelope-from ) for ; Thu, 30 Mar 2023 14:03:37 -0400 Received: by simark.ca (Postfix, from userid 112) id A3B6A1E223; Thu, 30 Mar 2023 14:03:37 -0400 (EDT) Authentication-Results: simark.ca; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.a=rsa-sha256 header.s=default header.b=YxUI5Yvo; dkim-atps=neutral X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-7.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, RDNS_DYNAMIC,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from sourceware.org (ip-8-43-85-97.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 4C6471E0D2 for ; Thu, 30 Mar 2023 14:03:37 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id DE65D3858404 for ; Thu, 30 Mar 2023 18:03:35 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org DE65D3858404 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1680199415; bh=xq4rO1L93Vo8TjvBl1A0jU+Mznziz0QNmpCaJlmWN4o=; h=To:Cc:Subject:Date:In-Reply-To:References:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=YxUI5YvonHJ8GTuABVdmBn8ShleBxPZjRQOy74BH+pZsPApSMKmVPZRZMRJYNMBIS cTMzs15JNqhHMb6jxgJF0jw6ePMhNFKXKCrZRHoFouufdpqqwW32n8oeaTRYmHt71e Qujc0AI+fhiDJKmEN/e1QLlkflFYF0PX36WZlhpY= Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by sourceware.org (Postfix) with ESMTPS id 1F8473858291 for ; Thu, 30 Mar 2023 18:03:15 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 1F8473858291 X-IronPort-AV: E=McAfee;i="6600,9927,10665"; a="325202203" X-IronPort-AV: E=Sophos;i="5.98,305,1673942400"; d="scan'208";a="325202203" Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Mar 2023 11:03:13 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10665"; a="859003963" X-IronPort-AV: E=Sophos;i="5.98,305,1673942400"; d="scan'208";a="859003963" Received: from labpc2315.iul.intel.com (HELO localhost) ([172.28.50.57]) by orsmga005-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Mar 2023 11:03:12 -0700 To: gdb-patches@sourceware.org Cc: eliz@gnu.org, Christina Schimpe Subject: [PATCH v2 1/1] gdb, doc: correct argument description for info connections/inferiors Date: Thu, 30 Mar 2023 20:02:39 +0200 Message-Id: <20230330180239.3217030-2-christina.schimpe@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230330180239.3217030-1-christina.schimpe@intel.com> References: <20230330180239.3217030-1-christina.schimpe@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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: , From: Christina Schimpe via Gdb-patches Reply-To: Christina Schimpe Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" From: Nils-Christian Kempke It said for 'info inferiors' and 'info connections' that the argument could be 'a space separated list of inferior numbers' which is correct but incomplete. In fact the arguments can be any space separated combination of numbers and (ascending) ranges. The beginning of the section now describes the ID list as a new keyword. Co-Authored-By: Christina Schimpe --- gdb/doc/gdb.texinfo | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 92d99349dbf..3ec267a7825 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -3216,6 +3216,15 @@ embedded targets may have several inferiors running in different parts of a single address space. Each inferior may in turn have multiple threads running in it. +@cindex ID list +The commands @code{info inferiors} and @code{info connections}, which will be +introduced below, accept a space-separated @dfn{ID list} as their argument +specifying one or more elements on which to operate. A list element can be +either a single non-negative number, like @samp{5}, or an ascending range of +such numbers, like @samp{5-7}. A list can consist of any combination of such +elements, even duplicates or overlapping ranges are valid. E.g.@: +@samp{1 4-6 5 4-4} or @samp{1 2 4-7}. + To find out what inferiors exist at any moment, use @w{@code{info inferiors}}: @@ -3223,9 +3232,8 @@ inferiors}}: @kindex info inferiors [ @var{id}@dots{} ] @item info inferiors Print a list of all inferiors currently being managed by @value{GDBN}. -By default all inferiors are printed, but the argument @var{id}@dots{} --- a space separated list of inferior numbers -- can be used to limit -the display to just the requested inferiors. +By default all inferiors are printed, but the ID list @var{id}@dots{} can be +used to limit the display to just the requested inferiors. @value{GDBN} displays for each inferior (in this order): @@ -3284,9 +3292,8 @@ To find out what open target connections exist at any moment, use @kindex info connections [ @var{id}@dots{} ] @item info connections Print a list of all open target connections currently being managed by -@value{GDBN}. By default all connections are printed, but the -argument @var{id}@dots{} -- a space separated list of connections -numbers -- can be used to limit the display to just the requested +@value{GDBN}. By default all connections are printed, but the ID list +@var{id}@dots{} can be used to limit the display to just the requested connections. @value{GDBN} displays for each connection (in this order): -- 2.25.1 Intel Deutschland GmbH Registered Address: Am Campeon 10, 85579 Neubiberg, Germany Tel: +49 89 99 8853-0, www.intel.de Managing Directors: Christin Eisenschmid, Sharon Heck, Tiffany Doon Silva Chairperson of the Supervisory Board: Nicole Lau Registered Office: Munich Commercial Register: Amtsgericht Muenchen HRB 186928