aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorJohn Gilmore <gnu@cygnus>1994-01-13 05:35:48 +0000
committerJohn Gilmore <gnu@cygnus>1994-01-13 05:35:48 +0000
commit5986c8ea41f0b8f57d80254524964e8b4a286ad5 (patch)
tree77f116e1a137597efa7c65d632dfdc8e04cb4a4b /gdb/doc
parent314e6bf3c103a7b1789c63a696c4d3b0ed65e62d (diff)
downloadgdb-5986c8ea41f0b8f57d80254524964e8b4a286ad5.zip
gdb-5986c8ea41f0b8f57d80254524964e8b4a286ad5.tar.gz
gdb-5986c8ea41f0b8f57d80254524964e8b4a286ad5.tar.bz2
* gdb.texinfo (Print Settings): Document `set print
fast-symbolic-addr' and improve the doc for some other `set print's.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog6
-rw-r--r--gdb/doc/gdb.texinfo48
2 files changed, 49 insertions, 5 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index f07e385..8e8f8c5 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+Wed Jan 12 21:29:54 1994 John Gilmore (gnu@cygnus.com)
+
+ * gdb.texinfo (Print Settings): Document `set print
+ fast-symbolic-addr' and improve the doc for some other
+ `set print's.
+
Mon Jan 3 17:23:07 1994 Jim Kingdon (kingdon@lioth.cygnus.com)
* stabs.texinfo (String Field): Talk about defining several type
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 5585e1b..13f0c77 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -1,5 +1,5 @@
\input texinfo @c -*-texinfo-*-
-@c Copyright (c) 1988 1989 1990 1991 1992 1993 Free Software Foundation, Inc.
+@c Copyright 1988 1989 1990 1991 1992 1993 1994 Free Software Foundation, Inc.
@c
@c %**start of header
@c makeinfo ignores cmds prev to setfilename, so its arg cannot make use
@@ -4378,6 +4378,17 @@ Show whether or not @value{GDBN} will print the source file name and
line number of a symbol in the symbolic form of an address.
@end table
+Another situation where it's helpful to show symbol filenames and line
+numbers is when disassembling code; @value{GDBN} will show you the line
+number and source file that corresponds to each instruction.
+
+If you have a pointer and you aren't sure what object it points to,
+you can turn on printing of symbolic addresses and filenames, and
+determine the name and source file location of the variable which
+is being pointed to, using the @code{x/x @var{pointer}} command.
+This displays the memory location pointed to, and as a side effect,
+interprets the address in symbolic form.
+
Also, you may wish to see the symbolic form only if the address being
printed is reasonably close to the closest earlier symbol:
@@ -4395,6 +4406,32 @@ Ask how large the maximum offset is that @value{GDBN} will print in a
symbolic address.
@end table
+Sometimes @value{GDBN} can tell you more about an address if it does an
+extensive search of its symbol information. The default is to provide
+a quick symbolic display that is usually correct, but which may not give
+the most useful answer when working in some object file formats. If
+you aren't getting the information you need, try:
+
+@table @code
+@item set print fast-symbolic-addr off
+@kindex set print fast-symbolic-addr
+Search all symbolic information when displaying an address symbolically.
+This setting may display more information about static variables, for
+example, but will take longer.
+
+@item set print fast-symbolic-addr
+@item set print fast-symbolic-addr on
+Search only the ``minimal symbol information'' when displaying symbolic
+information about an address. This is the default.
+
+@item show print fast-symbolic-addr
+@kindex show print fast-symbolic-addr
+Ask whether @value{GDBN} will use a fast or slow method of printing
+symbolic address.
+@end table
+
+Other settings control how different kinds of objects are printed:
+
@table @code
@item set print array
@itemx set print array on
@@ -4461,12 +4498,13 @@ Show which format @value{GDBN} will use to print structures.
@kindex set print sevenbit-strings
Print using only seven-bit characters; if this option is set,
@value{GDBN} will display any eight-bit characters (in strings or character
-values) using the notation @code{\}@var{nnn}. For example, @kbd{M-a} is
-displayed as @code{\341}.
+values) using the notation @code{\}@var{nnn}. This setting is best when
+working in English (ASCII) and the high-order bit of characters is used
+as a marker or ``meta'' bit.
@item set print sevenbit-strings off
-Print using either seven-bit or eight-bit characters, as required. This
-is the default.
+Print full eight-bit characters. This
+allows the use of full international character sets, and is the default.
@item show print sevenbit-strings
@kindex show print sevenbit-strings