diff options
Diffstat (limited to 'gcc/doc')
-rw-r--r-- | gcc/doc/tm.texi | 19 | ||||
-rw-r--r-- | gcc/doc/tm.texi.in | 19 |
2 files changed, 18 insertions, 20 deletions
diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index 11be5d0..f8fce27 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -3785,7 +3785,7 @@ Define this macro if the target's representation for dwarf registers used in .eh_frame or .debug_frame is different from that used in other debug info sections. Given a GCC hard register number, this macro should return the .eh_frame register number. The default is -@code{DBX_REGISTER_NUMBER (@var{regno})}. +@code{DEBUGGER_REGISTER_NUMBER (@var{regno})}. @end defmac @@ -9948,21 +9948,21 @@ This describes how to specify debugging information. @c prevent bad page break with this line These macros affect all debugging formats. -@defmac DBX_REGISTER_NUMBER (@var{regno}) -A C expression that returns the DBX register number for the compiler +@defmac DEBUGGER_REGISTER_NUMBER (@var{regno}) +A C expression that returns the debugger register number for the compiler register number @var{regno}. In the default macro provided, the value of this expression will be @var{regno} itself. But sometimes there are -some registers that the compiler knows about and DBX does not, or vice +some registers that the compiler knows about and debugger does not, or vice versa. In such cases, some register may need to have one number in the -compiler and another for DBX@. +compiler and another for debugger@. If two registers have consecutive numbers inside GCC, and they can be used as a pair to hold a multiword value, then they @emph{must} have -consecutive numbers after renumbering with @code{DBX_REGISTER_NUMBER}. +consecutive numbers after renumbering with @code{DEBUGGER_REGISTER_NUMBER}. Otherwise, debuggers will be unable to access such a pair, because they expect register pairs to be consecutive in their own numbering scheme. -If you find yourself defining @code{DBX_REGISTER_NUMBER} in way that +If you find yourself defining @code{DEBUGGER_REGISTER_NUMBER} in way that does not preserve register pairs, then what you must do instead is redefine the actual register numbering scheme. @end defmac @@ -9972,7 +9972,7 @@ A C expression that returns the integer offset value for an automatic variable having address @var{x} (an RTL expression). The default computation assumes that @var{x} is based on the frame-pointer and gives the offset from the frame-pointer. This is required for targets -that produce debugging output for DBX and allow the frame-pointer to be +that produce debugging output for debugger and allow the frame-pointer to be eliminated when the @option{-g} option is used. @end defmac @@ -10002,8 +10002,7 @@ or @option{-gvms}. @defmac DEFAULT_GDB_EXTENSIONS Define this macro to control whether GCC should by default generate -GDB's extended version of DBX debugging information (assuming DBX-format -debugging information is enabled at all). If you don't define the +GDB's extended version of debugging information. If you don't define the macro, the default is 1: always generate the extended information if there is any occasion to. @end defmac diff --git a/gcc/doc/tm.texi.in b/gcc/doc/tm.texi.in index 0d8cd2e..955343a 100644 --- a/gcc/doc/tm.texi.in +++ b/gcc/doc/tm.texi.in @@ -3012,7 +3012,7 @@ Define this macro if the target's representation for dwarf registers used in .eh_frame or .debug_frame is different from that used in other debug info sections. Given a GCC hard register number, this macro should return the .eh_frame register number. The default is -@code{DBX_REGISTER_NUMBER (@var{regno})}. +@code{DEBUGGER_REGISTER_NUMBER (@var{regno})}. @end defmac @@ -6618,21 +6618,21 @@ This describes how to specify debugging information. @c prevent bad page break with this line These macros affect all debugging formats. -@defmac DBX_REGISTER_NUMBER (@var{regno}) -A C expression that returns the DBX register number for the compiler +@defmac DEBUGGER_REGISTER_NUMBER (@var{regno}) +A C expression that returns the debugger register number for the compiler register number @var{regno}. In the default macro provided, the value of this expression will be @var{regno} itself. But sometimes there are -some registers that the compiler knows about and DBX does not, or vice +some registers that the compiler knows about and debugger does not, or vice versa. In such cases, some register may need to have one number in the -compiler and another for DBX@. +compiler and another for debugger@. If two registers have consecutive numbers inside GCC, and they can be used as a pair to hold a multiword value, then they @emph{must} have -consecutive numbers after renumbering with @code{DBX_REGISTER_NUMBER}. +consecutive numbers after renumbering with @code{DEBUGGER_REGISTER_NUMBER}. Otherwise, debuggers will be unable to access such a pair, because they expect register pairs to be consecutive in their own numbering scheme. -If you find yourself defining @code{DBX_REGISTER_NUMBER} in way that +If you find yourself defining @code{DEBUGGER_REGISTER_NUMBER} in way that does not preserve register pairs, then what you must do instead is redefine the actual register numbering scheme. @end defmac @@ -6642,7 +6642,7 @@ A C expression that returns the integer offset value for an automatic variable having address @var{x} (an RTL expression). The default computation assumes that @var{x} is based on the frame-pointer and gives the offset from the frame-pointer. This is required for targets -that produce debugging output for DBX and allow the frame-pointer to be +that produce debugging output for debugger and allow the frame-pointer to be eliminated when the @option{-g} option is used. @end defmac @@ -6672,8 +6672,7 @@ or @option{-gvms}. @defmac DEFAULT_GDB_EXTENSIONS Define this macro to control whether GCC should by default generate -GDB's extended version of DBX debugging information (assuming DBX-format -debugging information is enabled at all). If you don't define the +GDB's extended version of debugging information. If you don't define the macro, the default is 1: always generate the extended information if there is any occasion to. @end defmac |