From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 27959 invoked by alias); 10 Dec 2013 17:39:03 -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 27891 invoked by uid 89); 10 Dec 2013 17:39:02 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-3.0 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout20.012.net.il Received: from Unknown (HELO mtaout20.012.net.il) (80.179.55.166) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 10 Dec 2013 17:39:00 +0000 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MXL00000Q852W00@a-mtaout20.012.net.il> for gdb-patches@sourceware.org; Tue, 10 Dec 2013 19:38:34 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MXL000LSQCA2G10@a-mtaout20.012.net.il>; Tue, 10 Dec 2013 19:38:34 +0200 (IST) Date: Tue, 10 Dec 2013 17:39:00 -0000 From: Eli Zaretskii Subject: Re: [RFA/commit+doco] GDB/MI: Document support for -exec-run --start in -list-features In-reply-to: <20131210120252.GD3238@adacore.com> To: Joel Brobecker Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83eh5ky5b8.fsf@gnu.org> References: <1386051670-28637-1-git-send-email-brobecker@adacore.com> <83wqjm4cwl.fsf@gnu.org> <20131210120252.GD3238@adacore.com> X-IsSubscribed: yes X-SW-Source: 2013-12/txt/msg00383.txt.bz2 > Date: Tue, 10 Dec 2013 13:02:52 +0100 > From: Joel Brobecker > Cc: gdb-patches@sourceware.org > > > @findex exec-run-start-option > > @cindex support for @option{--start} option in @code{-exec-run} > > I can add the @findex for each item in the list. However, can you > explain why the @cindex. ISTM that it might be better to cross-reference > this element from the part of the manual that documents the actual > feature? Otherwise, someone looking at the index on how to "start" > a program with GDB/MI might find this index entry, follow it, only > to find how to check for the feature, not how to use it. WDYT? We should do both, I think. > > I'd also add an index entry for the entire section > > > > @cindex supported @sc{gdb/mi} features, list > > Attached is a patch that does that. Thanks. > Incidentally, I've been meaning to talk about a small nit: Why are > we adding the anchors and indexing commands after the @section/node/etc? > When you click on the reference, the browser jumps to the text, but > because the anchor if after the section title, we're not seeing it. "It" being what? the section title or something else? I'm afraid I don't understand the problem. > > >From the past couple of weeks, it sounds like this section will grow > > very fast (so maybe it should become a full-fledged @node). > > After further consideration, and despite the fact that I said that > the list might not grow that fast, I still tend to agree with you. > I'll do that next. I think we should extract the text out of the > "misc[...]" node, and move it up to its own node. Thanks.