From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20947 invoked by alias); 8 Jan 2010 15:40:52 -0000 Received: (qmail 20937 invoked by uid 22791); 8 Jan 2010 15:40:52 -0000 X-SWARE-Spam-Status: No, hits=-2.4 required=5.0 tests=AWL,BAYES_00,SPF_PASS X-Spam-Check-By: sourceware.org Received: from mail.codesourcery.com (HELO mail.codesourcery.com) (38.113.113.100) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 08 Jan 2010 15:40:48 +0000 Received: (qmail 7058 invoked from network); 8 Jan 2010 15:40:46 -0000 Received: from unknown (HELO wind.localnet) (vladimir@127.0.0.2) by mail.codesourcery.com with ESMTPA; 8 Jan 2010 15:40:46 -0000 From: Vladimir Prus To: gdb@sources.redhat.com Subject: [docs] Naming on GDB/MI sections in docs Date: Fri, 08 Jan 2010 15:40:00 -0000 User-Agent: KMail/1.12.2 (Linux/2.6.31-14-generic-pae; KDE/4.3.2; i686; ; ) MIME-Version: 1.0 Content-Type: Text/Plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Message-Id: <201001081840.44197.vladimir@codesourcery.com> 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/msg00071.txt.bz2 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I have two concerns about it: 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. Can we remove those prefixes? 2. Why is "Function and Purpose" subsection lacks section number in the TOC? I would have expected "27.1". Thanks, Volodya