From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1782 invoked by alias); 17 May 2003 08:31:19 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 25332 invoked from network); 17 May 2003 08:24:56 -0000 Received: from unknown (HELO gandalf.inter.net.il) (192.114.186.22) by sources.redhat.com with SMTP; 17 May 2003 08:24:56 -0000 Received: from zaretsky (tony08-234-132.inter.net.il [80.230.234.132] (may be forged)) by gandalf.inter.net.il (Mirapoint Messaging Server MOS 3.3.3-GR) with ESMTP id APW05843; Sat, 17 May 2003 11:24:47 +0300 (IDT) Date: Sat, 17 May 2003 08:31:00 -0000 From: "Eli Zaretskii" To: ac131313@redhat.com Message-Id: <8011-Sat17May2003112039+0300-eliz@elta.co.il> CC: gdb-patches@sources.redhat.com In-reply-to: <3EC57FE4.1000704@redhat.com> (message from Andrew Cagney on Fri, 16 May 2003 20:18:44 -0400) Subject: Re: [rfa:doco] Doco problems with level two annotations Reply-to: Eli Zaretskii References: <3EC57FE4.1000704@redhat.com> X-SW-Source: 2003-05/txt/msg00306.txt.bz2 > Date: Fri, 16 May 2003 20:18:44 -0400 > From: Andrew Cagney > > The attached updates the gdb/doc/annotate.texi file (renaming it to > annotate.texinfo) so that it is a standalone document that: > > - notes the limitations of level two annotations > - points the user at gdb/mi > - mentions the mi features that have replaced level two annotation > functionality I have several comments about this. Is it really useful to have this as a separate manual? Why not move the text into an appendix instead? It would simplify the change, for starters. You didn't show the Makefile.in patch, but it would become unnecessary. The changes of @section to @chapter would also become unnecessary. Finally, when we eventually remove level-2 annotations entirely, you won't need to modify any configury, just delete the appendix and all references to it. > +Permission is granted to copy, distribute and/or modify this document > +under the terms of the GNU Free Documentation License, Version 1.1 or > +any later version published by the Free Software Foundation; with the > +Invariant Sections being ``Free Software'' and ``Free Software Needs > +Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' > +and with the Back-Cover Texts as in (a) below. This text seems to be wrong, since there are no sections named ``Free Software'' and ``Free Software Needs Free Documentation'' in annotate.texi. Did I miss something? > +In a graphical environment, where many values can be displayed > +simultaneously, a serious performance problem occures when the client ^^^^^^^ This should be "occurs".