From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 25087 invoked by alias); 21 Oct 2006 13:20:04 -0000 Received: (qmail 25067 invoked by uid 22791); 21 Oct 2006 13:20:02 -0000 X-Spam-Check-By: sourceware.org Received: from heller.inter.net.il (HELO heller.inter.net.il) (192.114.186.73) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sat, 21 Oct 2006 13:20:00 +0000 Received: from HOME-C4E4A596F7 (IGLD-80-230-228-123.inter.net.il [80.230.228.123]) by heller.inter.net.il (MOS 3.7.3a-GA) with ESMTP id ATU38234 (AUTH halo1); Sat, 21 Oct 2006 14:19:40 +0200 (IST) Date: Sat, 21 Oct 2006 13:20:00 -0000 Message-Id: From: Eli Zaretskii To: gdb@sourceware.org, gdb-patches@sourceware.org In-reply-to: <20061020142656.GB28258@nevyn.them.org> (message from Daniel Jacobowitz on Fri, 20 Oct 2006 10:26:56 -0400) Subject: [commit] Fix annotations-related index entries (was: breakpoint for accessing memory location) Reply-to: Eli Zaretskii References: <4537DBC6.1030807@hccnet.nl> <20061019201214.GA32332@nevyn.them.org> <4537DEDC.5000008@hccnet.nl> <20061020142656.GB28258@nevyn.them.org> X-IsSubscribed: yes Mailing-List: contact gdb-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-owner@sourceware.org X-SW-Source: 2006-10/txt/msg00173.txt.bz2 While working on clarifying the watchpoints documentation, I found that the index entries for annotations are too general, and get in the way when one looks for the description of the topic, rather than the annotations for that topic. For example, the index entry "watchpoint" pointed to the description of the "^Z^Zwatchpoint N" annotation(!). It is highly unlikely that people who type "i watchpoint" in Info would expect to land in the description of watchpoint-related annotations. So I modified the index entries for annotations-related issues to include the word "annotation" explicitly; see the patch below. The general rule is: never write a general index entry for a specialized topic. Always make sure such specialized index entries are qualified with a reference to their parent feature (in this case, "annotations"). Committed. 2006-10-21 Eli Zaretskii * gdb.texinfo (Source Annotations): Fix index entries by adding "annotation" to them, to discriminate from index entries that point to the more general topic descriptions. Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.364 retrieving revision 1.365 diff -u -r1.364 -r1.365 --- gdb.texinfo 21 Oct 2006 12:54:18 -0000 1.364 +++ gdb.texinfo 21 Oct 2006 13:06:03 -0000 1.365 @@ -21529,34 +21529,34 @@ The input types are @table @code -@findex pre-prompt -@findex prompt -@findex post-prompt +@findex pre-prompt annotation +@findex prompt annotation +@findex post-prompt annotation @item prompt When @value{GDBN} is prompting for a command (the main @value{GDBN} prompt). -@findex pre-commands -@findex commands -@findex post-commands +@findex pre-commands annotation +@findex commands annotation +@findex post-commands annotation @item commands When @value{GDBN} prompts for a set of commands, like in the @code{commands} command. The annotations are repeated for each command which is input. -@findex pre-overload-choice -@findex overload-choice -@findex post-overload-choice +@findex pre-overload-choice annotation +@findex overload-choice annotation +@findex post-overload-choice annotation @item overload-choice When @value{GDBN} wants the user to select between various overloaded functions. -@findex pre-query -@findex query -@findex post-query +@findex pre-query annotation +@findex query annotation +@findex post-query annotation @item query When @value{GDBN} wants the user to confirm a potentially dangerous operation. -@findex pre-prompt-for-continue -@findex prompt-for-continue -@findex post-prompt-for-continue +@findex pre-prompt-for-continue annotation +@findex prompt-for-continue annotation +@findex post-prompt-for-continue annotation @item prompt-for-continue When @value{GDBN} is asking the user to press return to continue. Note: Don't expect this to work well; instead use @code{set height 0} to disable @@ -21568,14 +21568,14 @@ @section Errors @cindex annotations for errors, warnings and interrupts -@findex quit +@findex quit annotation @smallexample ^Z^Zquit @end smallexample This annotation occurs right before @value{GDBN} responds to an interrupt. -@findex error +@findex error annotation @smallexample ^Z^Zerror @end smallexample @@ -21590,7 +21590,7 @@ does not necessarily mean that @value{GDBN} is immediately returning all the way to the top level. -@findex error-begin +@findex error-begin annotation A quit or error annotation may be preceded by @smallexample @@ -21612,13 +21612,13 @@ changed. @table @code -@findex frames-invalid +@findex frames-invalid annotation @item ^Z^Zframes-invalid The frames (for example, output from the @code{backtrace} command) may have changed. -@findex breakpoints-invalid +@findex breakpoints-invalid annotation @item ^Z^Zbreakpoints-invalid The breakpoints may have changed. For example, the user just added or @@ -21629,8 +21629,8 @@ @section Running the Program @cindex annotations for running programs -@findex starting -@findex stopping +@findex starting annotation +@findex stopping annotation When the program starts executing due to a @value{GDBN} command such as @code{step} or @code{continue}, @@ -21648,16 +21648,16 @@ annotations describe how the program stopped. @table @code -@findex exited +@findex exited annotation @item ^Z^Zexited @var{exit-status} The program exited, and @var{exit-status} is the exit status (zero for successful exit, otherwise nonzero). -@findex signalled -@findex signal-name -@findex signal-name-end -@findex signal-string -@findex signal-string-end +@findex signalled annotation +@findex signal-name annotation +@findex signal-name-end annotation +@findex signal-string annotation +@findex signal-string-end annotation @item ^Z^Zsignalled The program exited with a signal. After the @code{^Z^Zsignalled}, the annotation continues: @@ -21681,17 +21681,17 @@ @var{intro-text}, @var{middle-text}, and @var{end-text} are for the user's benefit and have no particular format. -@findex signal +@findex signal annotation @item ^Z^Zsignal The syntax of this annotation is just like @code{signalled}, but @value{GDBN} is just saying that the program received the signal, not that it was terminated with it. -@findex breakpoint +@findex breakpoint annotation @item ^Z^Zbreakpoint @var{number} The program hit breakpoint number @var{number}. -@findex watchpoint +@findex watchpoint annotation @item ^Z^Zwatchpoint @var{number} The program hit watchpoint number @var{number}. @end table @@ -21700,7 +21700,7 @@ @section Displaying Source @cindex annotations for source display -@findex source +@findex source annotation The following annotation is used instead of displaying source code: @smallexample