From af125b1638ee35edf583c6f0c17caeab419c8364 Mon Sep 17 00:00:00 2001 From: Jim Kingdon Date: Tue, 11 Apr 1995 19:08:18 +0000 Subject: [PATCH] * annotate.texi: Clarify which addresses have differing formats depending on the language and which do not. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/annotate.texi | 19 ++++++++++++++----- 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 36e4842385..bf22e38d9f 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +Tue Apr 11 11:41:49 1995 Jim Kingdon (kingdon@lioth.cygnus.com) + + * annotate.texi: Clarify which addresses have differing formats + depending on the language and which do not. + Tue Mar 28 16:56:22 1995 J.T. Conklin * remote.texi (NetWare): Changed example to use BOARD= instead of diff --git a/gdb/doc/annotate.texi b/gdb/doc/annotate.texi index 77165358c0..9d5850dbf2 100644 --- a/gdb/doc/annotate.texi +++ b/gdb/doc/annotate.texi @@ -275,7 +275,9 @@ The frame annotation begins with where @var{level} is the number of the frame (0 is the innermost frame, and other frames have positive numbers), @var{address} is the address of the code executing in that frame, and @var{level-string} is a string -designed to convey the level to the user. The frame ends with +designed to convey the level to the user. @var{address} is in the form +@samp{0x} followed by one or more lowercase hex digits (note that this +does not depend on the language). The frame ends with @findex frame-end @example @@ -325,9 +327,11 @@ interesting information for the user to see) begin with @end example where @var{address} is the address executing in the frame (the same -address as in the @code{frame-begin} annotation), and -@var{separator-string} is a string intended to separate this address -from what follows for the user's benefit. +address as in the @code{frame-begin} annotation, but printed in a form +which is intended for user consumption---in particular, the syntax varies +depending on the language), and @var{separator-string} is a string +intended to separate this address from what follows for the user's +benefit. @findex frame-function-name @findex frame-args @@ -567,6 +571,9 @@ of: @var{commands} @end example +Note that @var{address} is intended for user consumption---the syntax +varies depending on the language. + The output ends with @findex breakpoints-table-end @@ -681,7 +688,9 @@ debug formats this will necessarily point to the beginning of a line), @var{middle} is @samp{middle} if @var{addr} is in the middle of the line, or @samp{beg} if @var{addr} is at the beginning of the line, and @var{addr} is the address in the target program associated with the -source which is being displayed. +source which is being displayed. @var{addr} is in the form @samp{0x} +followed by one or more lowercase hex digits (note that this does not +depend on the language). @node TODO @chapter Annotations We Might Want in the Future