From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 28375 invoked by alias); 23 Dec 2013 17:28:15 -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 28366 invoked by uid 89); 23 Dec 2013 17:28:15 -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: mtaout23.012.net.il Received: from mtaout23.012.net.il (HELO mtaout23.012.net.il) (80.179.55.175) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 23 Dec 2013 17:28:12 +0000 Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0MY900800SEG0900@a-mtaout23.012.net.il> for gdb-patches@sourceware.org; Mon, 23 Dec 2013 19:28:09 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MY900714SIXXW60@a-mtaout23.012.net.il>; Mon, 23 Dec 2013 19:28:09 +0200 (IST) Date: Mon, 23 Dec 2013 17:28:00 -0000 From: Eli Zaretskii Subject: Re: [doc RFA] Move docs on auto-loading extensions to Extending GDB section In-reply-to: To: Doug Evans Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83wqiv79zw.fsf@gnu.org> References: X-IsSubscribed: yes X-SW-Source: 2013-12/txt/msg00888.txt.bz2 > From: Doug Evans > Date: Mon, 23 Dec 2013 09:12:09 -0800 > > This patch is in part a cleanup, and in part sets things up so that > it's easier to add the corresponding docs for Guile scripting. If it just moves stuff around without changing any actual content (menus don't count), then it doesn't need to be reviewed, once we agree on the restructuring itself (which is fine with me). I have a couple of comments, which are probably to the text that was already in the manual (so it is up to you whether to fix them): > +@file{@var{OBJFILE}-gdb.@var{EXT}} and the @code{.debug_gdb_scripts} Please don't use upper case in @var, it looks ugly in print. > +section of modern file formats like @samp{ELF}. "ELF" is not a programming language symbol, so doesn't need @samp. Use either @acronym{ELF} or @sc{elf} or just ELF with no markup. > +@menu > +* objfile-gdb.ext file:: The @file{@var{objfile}-gdb.@var{ext}} file Node names cannot contain periods, this confuses some Info readers. > +For @value{GDBN} command files @xref{Auto-loading sequences}. > +For Python files @xref{Python Auto-loading}. @xref is inappropriate in the middle of a sentence, because it produces a capitalized "Note". Use @pxref or "see @ref" instead. > +For systems using file formats like ELF and COFF, > +when @value{GDBN} loads a new object file > +it will look for a special section named @code{.debug_gdb_scripts}. > +If this section exists, its contents is a list of NUL-terminated names ^^^ "NULL", right? Thanks.