diff options
| -rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
| -rw-r--r-- | gdb/doc/gdb.texinfo | 186 |
2 files changed, 68 insertions, 123 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 6ed591c..a98ffe0 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2004-07-09 Eli Zaretskii <eliz@gnu.org> + + * gdb.texinfo: Fix @kindex entries so that multiple commands that + have the same prefix have only their prefix in the index. + 2004-07-03 Mark Kettenis <kettenis@gnu.org> * gdb.texinfo (BSD libkvm Interface): New node (section) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index da67e88..329971f 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -2198,8 +2198,8 @@ For example, On HP-UX systems: -@cindex thread number -@cindex thread identifier (GDB) +@cindex debugging multithreaded programs (on HP-UX) +@cindex thread identifier (GDB), on HP-UX For debugging purposes, @value{GDBN} associates its own thread number---a small integer assigned in thread-creation order---with each thread in your program. @@ -2223,7 +2223,7 @@ HP-UX, you see when @value{GDBN} notices a new thread. @table @code -@kindex info threads +@kindex info threads (HP-UX) @item info threads Display a summary of all threads currently in your program. @value{GDBN} displays for each thread (in this order): @@ -2275,7 +2275,6 @@ As with the @samp{[New @dots{}]} message, the form of the text after @samp{Switching to} depends on your system's conventions for identifying threads. -@kindex thread apply @item thread apply [@var{threadno}] [@var{all}] @var{args} The @code{thread apply} command allows you to apply a command to one or more threads. Specify the numbers of the threads that you want affected @@ -2898,34 +2897,30 @@ shared library. Use the @code{catch} command to set a catchpoint. Stop when @var{event} occurs. @var{event} can be any of the following: @table @code @item throw -@kindex catch throw +@cindex stop on C@t{++} exceptions The throwing of a C@t{++} exception. @item catch -@kindex catch catch The catching of a C@t{++} exception. @item exec -@kindex catch exec +@cindex break on fork/exec A call to @code{exec}. This is currently only available for HP-UX. @item fork -@kindex catch fork A call to @code{fork}. This is currently only available for HP-UX. @item vfork -@kindex catch vfork A call to @code{vfork}. This is currently only available for HP-UX. @item load @itemx load @var{libname} -@kindex catch load +@cindex break on load/unload of shared library The dynamic loading of any shared library, or the loading of the library @var{libname}. This is currently only available for HP-UX. @item unload @itemx unload @var{libname} -@kindex catch unload The unloading of any dynamically loaded shared library, or the unloading of the library @var{libname}. This is currently only available for HP-UX. @end table @@ -3038,8 +3033,7 @@ confirm off}). You can abbreviate this command as @code{d}. @node Disabling @subsection Disabling breakpoints -@kindex disable breakpoints -@kindex enable breakpoints +@cindex enable/disable a breakpoint Rather than deleting a breakpoint, watchpoint, or catchpoint, you might prefer to @dfn{disable} it. This makes the breakpoint inoperative as if it had been deleted, but remembers the information on the breakpoint so @@ -3073,7 +3067,6 @@ You can use the following commands to enable or disable breakpoints, watchpoints, and catchpoints: @table @code -@kindex disable breakpoints @kindex disable @kindex dis @r{(@code{disable})} @item disable @r{[}breakpoints@r{]} @r{[}@var{range}@dots{}@r{]} @@ -3083,7 +3076,6 @@ options such as ignore-counts, conditions and commands are remembered in case the breakpoint is enabled again later. You may abbreviate @code{disable} as @code{dis}. -@kindex enable breakpoints @kindex enable @item enable @r{[}breakpoints@r{]} @r{[}@var{range}@dots{}@r{]} Enable the specified breakpoints (or all defined breakpoints). They @@ -4082,7 +4074,6 @@ Similar, but print only the outermost @var{n} frames. @kindex where @kindex info stack -@kindex info s @r{(@code{info stack})} The names @code{where} and @code{info stack} (abbreviated @code{info s}) are additional aliases for @code{backtrace}. @@ -4112,11 +4103,6 @@ The display for frame zero does not begin with a program counter value, indicating that your program has stopped at the beginning of the code for line @code{993} of @code{builtin.c}. -@kindex set backtrace past-main -@kindex show backtrace past-main -@kindex set backtrace limit -@kindex show backtrace limit - Most programs have a standard user entry point---a place where system libraries and startup code transition into user code. For C this is @code{main}. When @value{GDBN} finds the entry function in a backtrace @@ -4129,6 +4115,7 @@ in a backtrace, you can change this behavior: @table @code @item set backtrace past-main @itemx set backtrace past-main on +@kindex set backtrace Backtraces will continue past the user entry point. @item set backtrace past-main off @@ -4136,6 +4123,7 @@ Backtraces will stop when they encounter the user entry point. This is the default. @item show backtrace past-main +@kindex show backtrace Display the current user entry point backtrace policy. @item set backtrace limit @var{n} @@ -5320,9 +5308,10 @@ and symbols are printed. These settings are useful for debugging programs in any language: @table @code -@kindex set print address +@kindex set print @item set print address @itemx set print address on +@cindex print/don't print memory addresses @value{GDBN} prints memory addresses showing the location of stack traces, structure values, pointer values, breakpoints, and so forth, even when it also displays the contents of those addresses. The default @@ -5356,7 +5345,7 @@ dependent displays from the @value{GDBN} interface. For example, with @code{print address off}, you should get the same text for backtraces on all machines---whether or not they involve pointer arguments. -@kindex show print address +@kindex show print @item show print address Show whether or not addresses are to be printed. @end table @@ -5370,8 +5359,8 @@ you can set @value{GDBN} to print the source file and line number when it prints a symbolic address: @table @code -@kindex set print symbol-filename @item set print symbol-filename on +@cindex closest symbol and offset for an address Tell @value{GDBN} to print the source file name and line number of a symbol in the symbolic form of an address. @@ -5379,7 +5368,6 @@ symbol in the symbolic form of an address. Do not print source file name and line number of a symbol. This is the default. -@kindex show print symbol-filename @item show print symbol-filename 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. @@ -5393,14 +5381,13 @@ Also, you may wish to see the symbolic form only if the address being printed is reasonably close to the closest earlier symbol: @table @code -@kindex set print max-symbolic-offset @item set print max-symbolic-offset @var{max-offset} +@cindex maximum value for offset of closest symbol Tell @value{GDBN} to only display the symbolic form of an address if the offset between the closest earlier symbol and the address is less than @var{max-offset}. The default is 0, which tells @value{GDBN} to always print the symbolic form of an address if any symbol precedes it. -@kindex show print max-symbolic-offset @item show print max-symbolic-offset Ask how large the maximum offset is that @value{GDBN} prints in a symbolic address. @@ -5430,22 +5417,21 @@ the appropriate @code{set print} options turned on. Other settings control how different kinds of objects are printed: @table @code -@kindex set print array @item set print array @itemx set print array on +@cindex pretty print arrays Pretty print arrays. This format is more convenient to read, but uses more space. The default is off. @item set print array off Return to compressed format for arrays. -@kindex show print array @item show print array Show whether compressed or pretty format is selected for displaying arrays. -@kindex set print elements @item set print elements @var{number-of-elements} +@cindex number of array elements to print Set a limit on how many elements of an array @value{GDBN} will print. If @value{GDBN} is printing a large array, it stops printing after it has printed the number of elements set by the @code{set print elements} command. @@ -5453,19 +5439,17 @@ This limit also applies to the display of strings. When @value{GDBN} starts, this limit is set to 200. Setting @var{number-of-elements} to zero means that the printing is unlimited. -@kindex show print elements @item show print elements Display the number of elements of a large array that @value{GDBN} will print. If the number is 0, then the printing is unlimited. -@kindex set print null-stop @item set print null-stop +@cindex @sc{null} elements in arrays Cause @value{GDBN} to stop printing the characters of an array when the first @sc{null} is encountered. This is useful when large arrays actually contain only short strings. The default is off. -@kindex set print pretty @item set print pretty on Cause @value{GDBN} to print structures in an indented format with one member per line, like this: @@ -5496,12 +5480,12 @@ meat = 0x54 "Pork"@} @noindent This is the default format. -@kindex show print pretty @item show print pretty Show which format @value{GDBN} is using to print structures. -@kindex set print sevenbit-strings @item set print sevenbit-strings on +@cindex eight-bit characters in strings +@cindex octal escapes in strings Print using only seven-bit characters; if this option is set, @value{GDBN} displays any eight-bit characters (in strings or character values) using the notation @code{\}@var{nnn}. This setting is @@ -5512,19 +5496,17 @@ high-order bit of characters as a marker or ``meta'' bit. Print full eight-bit characters. This allows the use of more international character sets, and is the default. -@kindex show print sevenbit-strings @item show print sevenbit-strings Show whether or not @value{GDBN} is printing only seven-bit characters. -@kindex set print union @item set print union on +@cindex unions in structures, printing Tell @value{GDBN} to print unions which are contained in structures. This is the default setting. @item set print union off Tell @value{GDBN} not to print unions which are contained in structures. -@kindex show print union @item show print union Ask @value{GDBN} whether or not it will print unions which are contained in structures. @@ -5568,31 +5550,26 @@ $1 = @{it = Tree, form = @{...@}@} These settings are of interest when debugging C@t{++} programs: @table @code -@cindex demangling -@kindex set print demangle +@cindex demangling C@t{++} names @item set print demangle @itemx set print demangle on Print C@t{++} names in their source form rather than in the encoded (``mangled'') form passed to the assembler and linker for type-safe linkage. The default is on. -@kindex show print demangle @item show print demangle Show whether C@t{++} names are printed in mangled or demangled form. -@kindex set print asm-demangle @item set print asm-demangle @itemx set print asm-demangle on Print C@t{++} names in their source form rather than their mangled form, even in assembler code printouts such as instruction disassemblies. The default is off. -@kindex show print asm-demangle @item show print asm-demangle Show whether C@t{++} names in assembly listings are printed in mangled or demangled form. -@kindex set demangle-style @cindex C@t{++} symbol decoding style @cindex symbol decoding style, C@t{++} @item set demangle-style @var{style} @@ -5622,13 +5599,12 @@ require further enhancement to permit that. @end table If you omit @var{style}, you will see a list of possible formats. -@kindex show demangle-style @item show demangle-style Display the encoding style currently in use for decoding C@t{++} symbols. -@kindex set print object @item set print object @itemx set print object on +@cindex derived type of an object, printing When displaying a pointer to an object, identify the @emph{actual} (derived) type of the object rather than the @emph{declared} type, using the virtual function table. @@ -5637,26 +5613,24 @@ the virtual function table. Display only the declared type of objects, without reference to the virtual function table. This is the default setting. -@kindex show print object @item show print object Show whether actual, or declared, object types are displayed. -@kindex set print static-members @item set print static-members @itemx set print static-members on +@cindex static members of C@t{++} objects Print static members when displaying a C@t{++} object. The default is on. @item set print static-members off Do not print static members when displaying a C@t{++} object. -@kindex show print static-members @item show print static-members Show whether C@t{++} static members are printed, or not. @c These don't work with HP ANSI C++ yet. -@kindex set print vtbl @item set print vtbl @itemx set print vtbl on +@cindex pretty print C@t{++} virtual function tables Pretty print C@t{++} virtual function tables. The default is off. (The @code{vtbl} commands do not work on programs compiled with the HP ANSI C@t{++} compiler (@code{aCC}).) @@ -5664,7 +5638,6 @@ ANSI C@t{++} compiler (@code{aCC}).) @item set print vtbl off Do not pretty print C@t{++} virtual function tables. -@kindex show print vtbl @item show print vtbl Show whether C@t{++} virtual function tables are pretty printed, or not. @end table @@ -6475,9 +6448,9 @@ Show the results of expanding all preprocessor macro invocations in not parse the result, @var{expression} need not be a valid expression; it can be any string of tokens. -@kindex macro expand-once @item macro expand-once @var{expression} @itemx macro exp1 @var{expression} +@cindex expand macro once @i{(This command is not yet implemented.)} Show the results of expanding those preprocessor macro invocations that appear explicitly in @var{expression}. Macro invocations appearing in that expansion are @@ -7450,14 +7423,13 @@ you can abbreviate this as @code{ov} or @code{ovly}. The commands are: @table @code @item overlay off -@kindex overlay off +@kindex overlay Disable @value{GDBN}'s overlay support. When overlay support is disabled, @value{GDBN} assumes that all functions and variables are always present at their mapped addresses. By default, @value{GDBN}'s overlay support is disabled. @item overlay manual -@kindex overlay manual @cindex manual overlay debugging Enable @dfn{manual} overlay debugging. In this mode, @value{GDBN} relies on you to tell it which overlays are mapped, and which are not, @@ -7466,7 +7438,6 @@ commands described below. @item overlay map-overlay @var{overlay} @itemx overlay map @var{overlay} -@kindex overlay map-overlay @cindex map an overlay Tell @value{GDBN} that @var{overlay} is now mapped; @var{overlay} must be the name of the object file section containing the overlay. When an @@ -7477,7 +7448,6 @@ that any other overlays whose mapped ranges overlap that of @item overlay unmap-overlay @var{overlay} @itemx overlay unmap @var{overlay} -@kindex overlay unmap-overlay @cindex unmap an overlay Tell @value{GDBN} that @var{overlay} is no longer mapped; @var{overlay} must be the name of the object file section containing the overlay. @@ -7485,7 +7455,6 @@ When an overlay is unmapped, @value{GDBN} assumes it can find the overlay's functions and variables at their load addresses. @item overlay auto -@kindex overlay auto Enable @dfn{automatic} overlay debugging. In this mode, @value{GDBN} consults a data structure the overlay manager maintains in the inferior to see which overlays are mapped. For details, see @ref{Automatic @@ -7493,7 +7462,6 @@ Overlay Debugging}. @item overlay load-target @itemx overlay load -@kindex overlay load-target @cindex reloading the overlay table Re-read the overlay table from the inferior. Normally, @value{GDBN} re-reads the table @value{GDBN} automatically each time the inferior @@ -7830,8 +7798,6 @@ The following commands help you find out which language is the working language, and also what language source files were written in. @kindex show language -@kindex info frame@r{, show the source language} -@kindex info source@r{, show the source language} @table @code @item show language Display the current working language. This is the @@ -7839,12 +7805,14 @@ language you can use with commands such as @code{print} to build and compute expressions that may involve variables in your program. @item info frame +@kindex info frame@r{, show the source language} Display the source language for this frame. This language becomes the working language if you use an identifier from this frame. @xref{Frame Info, ,Information about a frame}, to identify the other information listed here. @item info source +@kindex info source@r{, show the source language} Display the source language of this source file. @xref{Symbols, ,Examining the Symbol Table}, to identify the other information listed here. @@ -7939,7 +7907,6 @@ details on specific languages. @value{GDBN} provides some additional commands for controlling the type checker: -@kindex set check@r{, type} @kindex set check type @kindex show check type @table @code @@ -8000,7 +7967,6 @@ Supported languages}, for further details on specific languages. @value{GDBN} provides some additional commands for controlling the range checker: -@kindex set check@r{, range} @kindex set check range @kindex show check range @table @code @@ -9924,9 +9890,9 @@ symbol table. It cannot be shared across multiple host platforms. @c (eg rooted in val of env var GDBSYMS) could exist for mappable symbol @c files. -@kindex core @kindex core-file @item core-file @r{[} @var{filename} @r{]} +@itemx core Specify the whereabouts of a core dump file to be used as the ``contents of memory''. Traditionally, core files contain only some parts of the address space of the process that generated them; @value{GDBN} can access the @@ -10344,7 +10310,7 @@ polynomials, reversals, byte ordering, etc.), the simplest way to describe the CRC used in @code{.gnu_debuglink} sections is to give the complete code for a function that computes it: -@kindex @code{gnu_debuglink_crc32} +@kindex gnu_debuglink_crc32 @smallexample unsigned long gnu_debuglink_crc32 (unsigned long crc, @@ -10616,22 +10582,24 @@ Use the @code{show gnutarget} command to display what file format and @code{show gnutarget} displays @samp{The current BDF target is "auto"}. @end table +@cindex common targets Here are some common targets (available, or not, depending on the GDB configuration): @table @code -@kindex target exec +@kindex target @item target exec @var{program} +@cindex executable file target An executable file. @samp{target exec @var{program}} is the same as @samp{exec-file @var{program}}. -@kindex target core @item target core @var{filename} +@cindex core dump file target A core dump file. @samp{target core @var{filename}} is the same as @samp{core-file @var{filename}}. -@kindex target remote @item target remote @var{dev} +@cindex remote target Remote serial target in GDB-specific protocol. The argument @var{dev} specifies what serial device to use for the connection (e.g. @file{/dev/ttya}). @xref{Remote, ,Remote debugging}. @code{target remote} @@ -10639,8 +10607,8 @@ supports the @code{load} command. This is only useful if you have some other way of getting the stub to the target system, and you can put it somewhere in memory where it won't get clobbered by the download. -@kindex target sim @item target sim +@cindex built-in simulator target Builtin CPU simulator. @value{GDBN} includes simulators for most architectures. In general, @smallexample @@ -10661,8 +10629,8 @@ Some configurations may include these targets as well: @table @code -@kindex target nrom @item target nrom @var{dev} +@cindex NetROM ROM emulator target NetROM ROM emulator. This target only supports downloading. @end table @@ -10711,15 +10679,13 @@ which to use. However, you may still find it useful to adjust @value{GDBN}'s idea of processor endian-ness manually. @table @code -@kindex set endian big +@kindex set endian @item set endian big Instruct @value{GDBN} to assume the target is big-endian. -@kindex set endian little @item set endian little Instruct @value{GDBN} to assume the target is little-endian. -@kindex set endian auto @item set endian auto Instruct @value{GDBN} to use the byte order associated with the executable. @@ -11192,14 +11158,14 @@ subroutines: @table @code @item set_debug_traps -@kindex set_debug_traps +@findex set_debug_traps @cindex remote serial stub, initialization This routine arranges for @code{handle_exception} to run when your program stops. You must call this subroutine explicitly near the beginning of your program. @item handle_exception -@kindex handle_exception +@findex handle_exception @cindex remote serial stub, main routine This is the central workhorse, but your program never calls it explicitly---the setup code arranges for @code{handle_exception} to @@ -11247,13 +11213,13 @@ serial port. @table @code @item int getDebugChar() -@kindex getDebugChar +@findex getDebugChar Write this subroutine to read a single character from the serial port. It may be identical to @code{getchar} for your target system; a different name is used to allow you to distinguish the two if you wish. @item void putDebugChar(int) -@kindex putDebugChar +@findex putDebugChar Write this subroutine to write a single character to the serial port. It may be identical to @code{putchar} for your target system; a different name is used to allow you to distinguish the two if you wish. @@ -11276,7 +11242,7 @@ Other routines you need to supply are: @table @code @item void exceptionHandler (int @var{exception_number}, void *@var{exception_address}) -@kindex exceptionHandler +@findex exceptionHandler Write this function to install @var{exception_address} in the exception handling tables. You need to do this because the stub does not have any way of knowing what the exception handling tables on your target system @@ -11298,7 +11264,7 @@ should be at privilege level 0 (the most privileged level). The help from @code{exceptionHandler}. @item void flush_i_cache() -@kindex flush_i_cache +@findex flush_i_cache On @sc{sparc} and @sc{sparclite} only, write this subroutine to flush the instruction cache, if any, on your target machine. If there is no instruction cache, this subroutine may be a no-op. @@ -11312,7 +11278,7 @@ You must also make sure this library routine is available: @table @code @item void *memset(void *, int, int) -@kindex memset +@findex memset This is the standard library function @code{memset} that sets an area of memory to a known value. If you have one of the free versions of @code{libc.a}, @code{memset} can be found there; otherwise, you must @@ -11920,7 +11886,7 @@ The following information on connecting to VxWorks was current when this manual was produced; newer releases of VxWorks may use revised procedures. -@kindex INCLUDE_RDB +@findex INCLUDE_RDB To use @value{GDBN} with VxWorks, you must rebuild your VxWorks kernel to include the remote debugging interface routines in the VxWorks library @file{rdb.a}. To do this, define @code{INCLUDE_RDB} in the @@ -12580,49 +12546,39 @@ or Data. For example: @code{hwatch ($LEA == my_var) && ($LDATA < 50) || ($SEA == my_var) && ($SDATA >= 50)} -@kindex htrace info +@kindex htrace @item htrace info Display information about current HW trace configuration. -@kindex htrace trigger @item htrace trigger @var{conditional} Set starting criteria for HW trace. -@kindex htrace qualifier @item htrace qualifier @var{conditional} Set acquisition qualifier for HW trace. -@kindex htrace stop @item htrace stop @var{conditional} Set HW trace stopping criteria. -@kindex htrace record @item htrace record [@var{data}]* Selects the data to be recorded, when qualifier is met and HW trace was triggered. -@kindex htrace enable @item htrace enable -@kindex htrace disable @itemx htrace disable Enables/disables the HW trace. -@kindex htrace rewind @item htrace rewind [@var{filename}] Clears currently recorded trace data. If filename is specified, new trace file is made and any newly collected data will be written there. -@kindex htrace print @item htrace print [@var{start} [@var{len}]] Prints trace buffer, using current record configuration. -@kindex htrace mode continuous @item htrace mode continuous Set continuous trace mode. -@kindex htrace mode suspend @item htrace mode suspend Set suspend trace mode. @@ -13115,7 +13071,7 @@ history facility. @cindex history substitution @cindex history file @kindex set history filename -@kindex GDBHISTFILE +@cindex @env{GDBHISTFILE}, environment variable @item set history filename @var{fname} Set the name of the @value{GDBN} command history file to @var{fname}. This is the file where @value{GDBN} reads an initial command history @@ -13127,7 +13083,7 @@ to the value of the environment variable @code{GDBHISTFILE}, or to is not set. @cindex history save -@kindex set history save +@kindex set history @item set history save @itemx set history save on Record command history in a file, whose name may be specified with the @@ -13137,7 +13093,6 @@ Record command history in a file, whose name may be specified with the Stop recording command history in a file. @cindex history size -@kindex set history size @item set history size @var{size} Set the number of commands which @value{GDBN} keeps in its history list. This defaults to the value of the environment variable @@ -13161,9 +13116,9 @@ history facilities do not attempt substitution on the strings The commands to control history expansion are: @table @code -@kindex set history expansion @item set history expansion on @itemx set history expansion +@cindex history expansion Enable history expansion. History expansion is off by default. @item set history expansion off @@ -13450,87 +13405,79 @@ Displays state of confirmation requests. @node Debugging Output @section Optional messages about internal happenings +@cindex optional debugging messages + @table @code -@kindex set debug arch +@kindex set debug +@cindex gdbarch debugging info @item set debug arch Turns on or off display of gdbarch debugging info. The default is off -@kindex show debug arch +@kindex show debug @item show debug arch Displays the current state of displaying gdbarch debugging info. -@kindex set debug event @item set debug event +@cindex event debugging info Turns on or off display of @value{GDBN} event debugging info. The default is off. -@kindex show debug event @item show debug event Displays the current state of displaying @value{GDBN} event debugging info. -@kindex set debug expression @item set debug expression +@cindex expression debugging info Turns on or off display of @value{GDBN} expression debugging info. The default is off. -@kindex show debug expression @item show debug expression Displays the current state of displaying @value{GDBN} expression debugging info. -@kindex set debug frame @item set debug frame +@cindex frame debugging info Turns on or off display of @value{GDBN} frame debugging info. The default is off. -@kindex show debug frame @item show debug frame Displays the current state of displaying @value{GDBN} frame debugging info. -@kindex set debug observer @item set debug observer +@cindex observer debugging info Turns on or off display of @value{GDBN} observer debugging. This includes info such as the notification of observable events. -@kindex show debug observer @item show debug observer Displays the current state of observer debugging. -@kindex set debug overload @item set debug overload +@cindex C@t{++} overload debugging info Turns on or off display of @value{GDBN} C@t{++} overload debugging info. This includes info such as ranking of functions, etc. The default is off. -@kindex show debug overload @item show debug overload Displays the current state of displaying @value{GDBN} C@t{++} overload debugging info. -@kindex set debug remote @cindex packets, reporting on stdout @cindex serial connections, debugging @item set debug remote Turns on or off display of reports on all packets sent back and forth across the serial line to the remote machine. The info is printed on the @value{GDBN} standard output stream. The default is off. -@kindex show debug remote @item show debug remote Displays the state of display of remote packets. -@kindex set debug serial @item set debug serial Turns on or off display of @value{GDBN} serial debugging info. The default is off. -@kindex show debug serial @item show debug serial Displays the current state of displaying @value{GDBN} serial debugging info. -@kindex set debug target @item set debug target +@cindex target debugging info Turns on or off display of @value{GDBN} target debugging info. This info includes what is going on at the target level of GDB, as it happens. The default is 0. Set it to 1 to track events, and to 2 to also track the value of large memory transfers. Changes to this flag do not take effect until the next time you connect to a target or use the @code{run} command. -@kindex show debug target @item show debug target Displays the current state of displaying @value{GDBN} target debugging info. -@kindex set debug varobj @item set debug varobj +@cindex variable object debugging info Turns on or off display of @value{GDBN} variable object debugging info. The default is off. -@kindex show debug varobj @item show debug varobj Displays the current state of displaying @value{GDBN} variable object debugging info. @@ -13659,7 +13606,6 @@ messages when used in a user-defined command. @cindex hooks, pre-command @kindex hook -@kindex hook- You may define @dfn{hooks}, which are a special kind of user-defined command. Whenever you run the command @samp{foo}, if the user-defined command @samp{hook-foo} exists, it is executed (with no arguments) @@ -13667,7 +13613,6 @@ before that command. @cindex hooks, post-command @kindex hookpost -@kindex hookpost- A hook may also be defined which is run after the command you executed. Whenever you run the command @samp{foo}, if the user-defined command @samp{hookpost-foo} exists, it is executed (with no arguments) after @@ -14288,27 +14233,22 @@ in the TUI mode. List and give the size of all displayed windows. @item layout next -@kindex layout next +@kindex layout Display the next layout. @item layout prev -@kindex layout prev Display the previous layout. @item layout src -@kindex layout src Display the source window only. @item layout asm -@kindex layout asm Display the assembly window only. @item layout split -@kindex layout split Display the source and assembly window. @item layout regs -@kindex layout regs Display the register window together with the source or assembly window. @item focus next | prev | src | asm | regs | split |