From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20697 invoked by alias); 8 Jan 2010 19:54:03 -0000 Received: (qmail 20689 invoked by uid 22791); 8 Jan 2010 19:54:02 -0000 X-SWARE-Spam-Status: No, hits=-1.1 required=5.0 tests=AWL,BAYES_00,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout20.012.net.il (HELO mtaout20.012.net.il) (80.179.55.166) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 08 Jan 2010 19:53:56 +0000 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0KVY006001TH3U00@a-mtaout20.012.net.il> for gdb@sources.redhat.com; Fri, 08 Jan 2010 21:53:54 +0200 (IST) Received: from HOME-C4E4A596F7 ([77.127.222.44]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KVY0035J1XSUJR0@a-mtaout20.012.net.il>; Fri, 08 Jan 2010 21:53:54 +0200 (IST) Date: Fri, 08 Jan 2010 19:54:00 -0000 From: Eli Zaretskii Subject: Re: [docs] Naming on GDB/MI sections in docs In-reply-to: <201001081840.44197.vladimir@codesourcery.com> To: Vladimir Prus Cc: gdb@sources.redhat.com Reply-to: Eli Zaretskii Message-id: <83hbqw9xus.fsf@gnu.org> References: <201001081840.44197.vladimir@codesourcery.com> X-IsSubscribed: yes Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org X-SW-Source: 2010-01/txt/msg00080.txt.bz2 > From: Vladimir Prus > Date: Fri, 8 Jan 2010 18:40:44 +0300 > > > At present, the toc of documentation PDF looks like this: > > gdb > 27 The gdb/mi Interface > Function and Purpose > Notation and Terminology > 27.3 gdb/mi General Design > 27.3.1 Context management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . > 27.3.2 Asynchronous command execution and non-stop mode . . > 27.3.3 Thread groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . > 27.4 gdb/mi Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . > 27.4.1 gdb/mi Input Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ouch! > 1. Why some section titles are started by "gdb/mi"? We're already > inside "The gdb/mi Interface" section, so it's reasonable to assume > subsections talk about gdb/mi. When you look at the entire TOC, yes. But what if you land in that section in Info, by following some cross-reference or index search? > Can we remove those prefixes? If others don't mind (and if the consideration I mention above doesn't make you change your mind), then I won't object. Just make sure we don't already have other sections by the same name. > 2. Why is "Function and Purpose" subsection lacks section number in > the TOC? I would have expected "27.1". Because it's an @unnumberedsec for some reason. Change it to @section, and you will have the number. The same goes for "Notation and Terminology". Thanks for spotting these blunders.