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 7C5CE3858417 for ; Mon, 11 Sep 2023 13:43:40 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 7C5CE3858417 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qfhCU-0000wK-8r; Mon, 11 Sep 2023 09:43:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=8z/9wew1kHKKLqmTjPeugpyzlUA7YZHI4FS99XoKthA=; b=GYBU0zkpAyKs Z2MbP248fN/UsJFR7/b7g1M8xyFuH6EBRRK3tto/ax2ehYPxj1nSPNp16a4K9K6WF8fyleGs+q239 yh+pzr6Kf4YpIpWL+58gAQaf2BdwswCi1Eve5i/oHD6a0twH+f5tqgHZagBJwGqWLOYpKyHG/aatS W0SG9l3ughh6CFn5uCQyMDaRD/wGw9o6nrB+6Nkf1h98s/zgAkcks6WwVyOLCgo8TUVIE4/95xngY vmixPnvFv4sGfUm6B2nWETRMMKQaL10QT5kyDxMh1nVNnVT9waBRijpfzCuvSLXgGED9iQEJoURNI 3iUV9quxNqs/hB4C3E4Bqw==; Date: Mon, 11 Sep 2023 16:43:21 +0300 Message-Id: <83bke8rfk6.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org, gdb-patches@sourceware.org, jan.vrany@labware.com In-Reply-To: <87cyyolw49.fsf@redhat.com> (message from Andrew Burgess on Mon, 11 Sep 2023 13:42:14 +0100) Subject: Re: [PATCH 2/2] gdb/python: implement support for sending custom MI async notifications References: <20230908210504.89194-1-jan.vrany@labware.com> <20230908210504.89194-2-jan.vrany@labware.com> <87cyyolw49.fsf@redhat.com> X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: > From: Andrew Burgess > Cc: Jan Vrany , Eli Zaretskii > Date: Mon, 11 Sep 2023 13:42:14 +0100 > > > +@subsubsection @sc{gdb/mi} Notifications In Python > > + > > +@cindex MI notifications in python > > +@cindex notifications in python, GDB/MI > > +@cindex python notifications, GDB/MI > > I think these @cindex entries are supposed to appear at least before the > @subsubsection heading, that way, when following the link from the index > you'll be taken to the relevant heading rather than the body text - > though I could be wrong about this, Eli might have some thoughts. No, what you say is correct for @item, but not for sectioning commands. In the latter case, we want to index entry to land the reader on the text, not on the section name.