* gdbint.texinfo: Removed mentions of many incorrectly placed and

	obsolete conditionals, described some others.

2 files changed, 137 insertions, 222 deletions

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 36eb7c8..afa86ad 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+Thu Jul 14 18:43:17 1994  Stan Shebs  (shebs@andros.cygnus.com)
+
+	* gdbint.texinfo: Removed mentions of many incorrectly placed and
+	obsolete conditionals, described some others.
+
 Tue Jul 12 12:23:15 1994  Peter Schauer  (pes@regent.e-technik.tu-muenchen.de)
 
 	* gdb.texinfo (help targets):  Changed to `help target', which
diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index edd1d0b..929ee93 100644
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -347,7 +347,7 @@ Then edit @file{bfd/configure.host}.  Add a line to recognize your
 @code{my_host} to @var{xxx} when you recognize it.  This will cause your
 file @file{h-@var{xxx}.h} to be linked to @file{sysdep.h} at configuration
 time.  When creating the line that recognizes your configuration,
-only match the fields that you really need to match; e.g. don't match
+only match the fields that you really need to match; e.g. don't
 match the architecture or manufacturer if the OS is sufficient
 to distinguish the configuration that your @file{h-@var{xxx}.h} file supports.
 Don't match the manufacturer name unless you really need to.
@@ -452,7 +452,7 @@ Now, you are now ready to try configuring GDB to compile using your system
 as its host.  From the top level (above @file{bfd}, @file{gdb}, etc), do:
 
 @example
-./configure @var{xxx} +target=vxworks960
+./configure @var{xxx} --target=vxworks960
 @end example
 
 This will configure your system to cross-compile for VxWorks on
@@ -1490,47 +1490,36 @@ available somehow (e.g. anonymous FTP), and announce it on
 
 When GDB is configured and compiled, various macros are defined or left
 undefined, to control compilation based on the attributes of the host
-system.  These macros and their meanings are:
+system.  These macros and their meanings (or if the meaning is not
+documented here, then one of the source files where they are used is
+indicated) are:
 
 @emph{NOTE:  For now, both host and target conditionals are here.
 Eliminate target conditionals from this list as they are identified.}
 
 @table @code
-@item ALIGN_SIZE
-alloca.c
+
 @item BLOCK_ADDRESS_FUNCTION_RELATIVE
 dbxread.c
+
 @item GDBINIT_FILENAME
-main.c
+The default name of GDB's initialization file (normally @file{.gdbinit}).
+
 @item KERNELDEBUG
 tm-hppa.h
+
 @item MEM_FNS_DECLARED
 Your host config file defines this if it includes 
 declarations of @code{memcpy} and @code{memset}.  Define this
 to avoid conflicts between the native include
 files and the declarations in @file{defs.h}.
+
 @item NO_SYS_FILE
 dbxread.c
 @item PYRAMID_CONTROL_FRAME_DEBUGGING
 pyr-xdep.c
 @item SIGWINCH_HANDLER_BODY
 utils.c
-@item 1
-buildsym.c
-@item 1
-dbxread.c
-@item 1
-dbxread.c
-@item 1
-buildsym.c
-@item 1
-dwarfread.c
-@item 1
-valops.c
-@item 1
-valops.c
-@item 1
-pyr-xdep.c
 @item ADDITIONAL_OPTIONS
 main.c
 @item ADDITIONAL_OPTION_CASES
@@ -1551,8 +1540,6 @@ altos-xdep.c
 xm-altos.h
 @item ASCII_COFF
 remote-adapt.c
-@item BADMAG
-coffread.c
 @item BCS
 tm-delta88.h
 @item BEFORE_MAIN_LOOP_HOOK
@@ -1561,8 +1548,6 @@ main.c
 coffread.c
 @item BELIEVE_PCC_PROMOTION_TYPE
 stabsread.c
-@item BIG_ENDIAN
-defs.h
 @item BITS_BIG_ENDIAN
 defs.h
 @item BKPT_AT_MAIN
@@ -1571,18 +1556,14 @@ solib.c
 dbxread.c
 @item BPT_VECTOR
 tm-m68k.h
-@item BREAKPOINT
-tm-m68k.h
-@item BREAKPOINT_DEBUG
-breakpoint.c
+
 @item BROKEN_LARGE_ALLOCA
 Avoid large @code{alloca}'s.  For example, on sun's, Large alloca's fail
 because the attempt to increase the stack limit in main() fails because
 shared libraries are allocated just below the initial stack limit.  The
 SunOS kernel will not allow the stack to grow into the area occupied by
 the shared libraries.
-@item BSTRING
-regex.c
+
 @item CALL_DUMMY
 valops.c
 @item CALL_DUMMY_LOCATION
@@ -1609,8 +1590,6 @@ symm-tdep.c
 stack.c
 @item CPLUS_MARKER
 cplus-dem.c
-@item CREATE_INFERIOR_HOOK
-infrun.c
 @item C_ALLOCA
 regex.c
 @item C_GLBLREG
@@ -1627,8 +1606,10 @@ partial-stab.h
 hppabsd-xdep.c
 @item DECR_PC_AFTER_BREAK
 breakpoint.c
+
 @item DEFAULT_PROMPT
-main.c
+The default value of the prompt string (normally @code{"(gdb) "}).
+
 @item DELTA88
 m88k-xdep.c
 @item DEV_TTY
@@ -1643,10 +1624,6 @@ remote.c
 infrun.c
 @item DO_REGISTERS_INFO
 infcmd.c
-@item END_OF_TEXT_DEFAULT
-dbxread.c
-@item EXTERN
-buildsym.h
 @item EXTRACT_RETURN_VALUE
 tm-m68k.h
 @item EXTRACT_STRUCT_VALUE_ADDRESS
@@ -1657,36 +1634,10 @@ frame.h
 symtab.h
 @item FILES_INFO_HOOK
 target.c
-@item FIXME
-coffread.c
 @item FLOAT_INFO
 infcmd.c
 @item FOPEN_RB
 defs.h
-@item FP0_REGNUM
-a68v-xdep.c
-@item FPC_REGNUM
-mach386-xdep.c
-@item FP_REGNUM
-parse.c
-@item FRAMELESS_FUNCTION_INVOCATION
-blockframe.c
-@item FRAME_ARGS_ADDRESS_CORRECT
-stack.c
-@item FRAME_CHAIN_COMBINE
-blockframe.c
-@item FRAME_CHAIN_VALID
-frame.h
-@item FRAME_CHAIN_VALID_ALTERNATE
-frame.h
-@item FRAME_FIND_SAVED_REGS
-stack.c
-@item FRAME_GET_BASEREG_VALUE
-frame.h
-@item FRAME_NUM_ARGS
-tm-m68k.h
-@item FRAME_SPECIFICATION_DYADIC
-stack.c
 @item FUNCTION_EPILOGUE_SIZE
 coffread.c
 @item F_OK
@@ -1703,17 +1654,13 @@ dwarfread.c
 findvar.c
 @item GPLUS_PRODUCER
 dwarfread.c
-@item GR64_REGNUM
-remote-adapt.c
-@item GR64_REGNUM
-remote-mm.c
 @item HANDLE_RBRAC
 partial-stab.h
-@item HAVE_68881
-m68k-tdep.c
+
 @item HAVE_MMAP
 In some cases, use the system call @code{mmap} for reading symbol
 tables.  For some machines this allows for sharing and quick updates.
+
 @item HAVE_REGISTER_WINDOWS
 findvar.c
 @item HAVE_SIGSETMASK
@@ -1725,7 +1672,7 @@ arm-tdep.c
 @item HOSTING_ONLY
 xm-rtbsd.h
 @item HOST_BYTE_ORDER
-ieee-float.c
+findvar.c
 @item HPUX_ASM
 xm-hp300hpux.h
 @item HPUX_VERSION_5
@@ -1734,8 +1681,6 @@ hp300ux-xdep.c
 infrun.c
 @item I80960
 remote-vx.c
-@item IEEE_DEBUG
-ieee-float.c
 @item IEEE_FLOAT
 valprint.c
 @item IGNORE_SYMBOL
@@ -1766,24 +1711,26 @@ values.c
 dbxread.c
 @item KERNEL_DEBUGGING
 tm-ultra3.h
+
 @item KERNEL_U_ADDR
 Define this to the address of the @code{u} structure (the ``user struct'',
 also known as the ``u-page'') in kernel virtual memory.  GDB needs to know
 this so that it can subtract this address from absolute addresses in
 the upage, that are obtained via ptrace or from core files.  On systems
 that don't need this value, set it to zero.
+
 @item KERNEL_U_ADDR_BSD
 Define this to cause GDB to determine the address of @code{u} at runtime,
 by using Berkeley-style @code{nlist} on the kernel's image in the root
 directory.
+
 @item KERNEL_U_ADDR_HPUX
 Define this to cause GDB to determine the address of @code{u} at runtime,
 by using HP-style @code{nlist} on the kernel's image in the root
 directory.
+
 @item LCC_PRODUCER
 dwarfread.c
-@item LITTLE_ENDIAN
-defs.h
 @item LOG_FILE
 remote-adapt.c
 @item LONGERNAMES
@@ -1800,28 +1747,33 @@ defs.h
 source.c
 @item L_LNNO32
 coffread.c
+
 @item L_SET
 This macro is used as the argument to lseek (or, most commonly, bfd_seek).
-FIXME, it should be replaced by SEEK_SET instead, which is the POSIX equivalent.
+FIXME, should be replaced by SEEK_SET instead, which is the POSIX equivalent.
+
 @item MACHKERNELDEBUG
 hppabsd-tdep.c
-@item MAIN
-cplus-dem.c
 @item MAINTENANCE
 dwarfread.c
+
 @item MAINTENANCE_CMDS
-breakpoint.c
-@item MAINTENANCE_CMDS
-maint.c
+If the value of this is 1, then a number of optional maintenance commands
+are compiled in.
+
 @item MALLOC_INCOMPATIBLE
 Define this if the system's prototype for @code{malloc} differs from the
 @sc{ANSI} definition.
+
 @item MIPSEL
 mips-tdep.c
+
 @item MMAP_BASE_ADDRESS
 When using HAVE_MMAP, the first mapping should go at this address.
+
 @item MMAP_INCREMENT
 when using HAVE_MMAP, this is the increment between mappings.
+
 @item MONO
 ser-go32.c
 @item MOTOROLA
@@ -1834,10 +1786,10 @@ infrun.c
 exec.c
 @item NFAILURES
 regex.c
-@item NNPC_REGNUM
-infrun.c
+
 @item NORETURN
-defs.h
+(in defs.h - is this really useful to define/undefine?)
+
 @item NOTDEF
 regex.c
 @item NOTDEF
@@ -1850,6 +1802,7 @@ infrun.c
 remote-mm.c
 @item NO_JOB_CONTROL
 signals.h
+
 @item NO_MMALLOC
 GDB will use the @code{mmalloc} library for memory allocation for symbol
 reading, unless this symbol is defined.  Define it on systems 
@@ -1861,15 +1814,15 @@ to override the setting of @code{MMALLOC_LIB} to empty, in the Makefile.
 Therefore, this define is usually set on the command line by overriding
 @code{MMALLOC_DISABLE} in @file{config/*/*.mh}, rather than by defining
 it in @file{xm-*.h}.
+
 @item NO_MMALLOC_CHECK
 Define this if you are using @code{mmalloc}, but don't want the overhead
 of checking the heap with @code{mmcheck}.
+
 @item NO_SIGINTERRUPT
 remote-adapt.c
 @item NO_SINGLE_STEP
 infptrace.c
-@item NPC_REGNUM
-infcmd.c
 @item NS32K_SVC_IMMED_OPERANDS
 ns32k-opcode.h
 @item NUMERIC_REG_NAMES
@@ -1894,8 +1847,6 @@ dbxread.c
 inferior.h
 @item PC_LOAD_SEGMENT
 stack.c
-@item PC_REGNUM
-parse.c
 @item PRINT_RANDOM_SIGNAL
 infcmd.c
 @item PRINT_REGISTER_HOOK
@@ -1908,8 +1859,6 @@ buildsym.c
 infrun.c
 @item PSIGNAL_IN_SIGNAL_H
 defs.h
-@item PS_REGNUM
-parse.c
 @item PUSH_ARGUMENTS
 valops.c
 @item PYRAMID_CONTROL_FRAME_DEBUGGING
@@ -1932,14 +1881,13 @@ regex.h
 dwarfread.c
 @item R_OK
 xm-altos.h
-@item SDB_REG_TO_REGNUM
-coffread.c
 @item SEEK_END
 state.c
 @item SEEK_SET
 state.c
 @item SEM
 coffread.c
+
 @item SET_STACK_LIMIT_HUGE
 When defined, stack limits will be raised to their maximum.  Use this
 if your host supports @code{setrlimit} and you have trouble with
@@ -1947,6 +1895,7 @@ if your host supports @code{setrlimit} and you have trouble with
 
 Also used in @file{fork-child.c} to return stack limits before child
 processes are forked.
+
 @item SHELL_COMMAND_CONCAT
 infrun.c
 @item SHELL_FILE
@@ -1957,30 +1906,16 @@ breakpoint.c
 regex.c
 @item SIGTRAP_STOP_AFTER_LOAD
 infrun.c
-@item SKIP_PROLOGUE
-tm-m68k.h
-@item SKIP_PROLOGUE_FRAMELESS_P
-blockframe.c
 @item SKIP_TRAMPOLINE_CODE
 infrun.c
 @item SOLIB_ADD
 core.c
-@item SOLIB_CREATE_INFERIOR_HOOK
-infrun.c
-@item SP_REGNUM
-parse.c
-@item STAB_REG_TO_REGNUM
-stabsread.h
 @item STACK_ALIGN
 valops.c
-@item STACK_DIRECTION
-alloca.c
 @item START_INFERIOR_TRAPS_EXPECTED
 infrun.c
 @item STOP_SIGNAL
 main.c
-@item STORE_RETURN_VALUE
-tm-m68k.h
 @item SUN4_COMPILER_FEATURE
 infrun.c
 @item SUN_FIXED_LBRAC_BUG
@@ -1997,8 +1932,6 @@ symfile.c
 regex.c
 @item Sword
 regex.c
-@item TDESC
-infrun.c
 @item TIOCGETC
 inflow.c
 @item TIOCGLTC
@@ -2027,10 +1960,12 @@ xm-news.h
 inflow.c
 @item USE_STRUCT_CONVENTION
 values.c
+
 @item USG
 Means that System V (prior to SVR4) include files are in use.
 (FIXME:  This symbol is abused in @file{infrun.c}, @file{regex.c},
 @file{remote-nindy.c}, and @file{utils.c} for other things, at the moment.)
+
 @item USIZE
 xm-m88k.h
 @item U_FPSTATE
@@ -2039,16 +1974,10 @@ i386-xdep.c
 dbxread.c
 @item WRS_ORIG
 remote-vx.c
-@item _LANG_c
-language.c
-@item _LANG_m2
-language.c
 @item __GNUC__
 news-xdep.c
 @item __GO32__
 inflow.c
-@item __HAVE_68881__
-m68k-stub.c
 @item __HPUX_ASM__
 xm-hp300hpux.h
 @item __INT_VARARGS_H
@@ -2061,8 +1990,6 @@ defs.h
 defs.h
 @item GOULD_PN
 gould-pinsn.c
-@item emacs
-alloca.c
 @item hp800
 xm-hppabsd.h
 @item hpux
@@ -2081,8 +2008,6 @@ ns32k-opcode.h
 mips-tdep.c
 @item sparc
 regex.c
-@item static
-alloca.c
 @item sun
 m68k-tdep.c
 @item sun386
@@ -2093,10 +2018,6 @@ regex.c
 xm-mips.h
 @item volatile
 defs.h
-@item x_name
-coffread.c
-@item x_zeroes
-coffread.c
 @end table
 
 @node Target Conditionals
@@ -2110,16 +2031,15 @@ system.  These macros and their meanings are:
 Eliminate host conditionals from this list as they are identified.}
 
 @table @code
+
 @item PUSH_DUMMY_FRAME
 Used in @samp{call_function_by_hand} to create an artificial stack frame.
+
 @item POP_FRAME
 Used in @samp{call_function_by_hand} to remove an artificial stack frame.
-@item ALIGN_SIZE
-alloca.c
+
 @item BLOCK_ADDRESS_FUNCTION_RELATIVE
 dbxread.c
-@item GDBINIT_FILENAME
-main.c
 @item KERNELDEBUG
 tm-hppa.h
 @item NO_SYS_FILE
@@ -2146,18 +2066,12 @@ altos-xdep.c
 xm-altos.h
 @item ASCII_COFF
 remote-adapt.c
-@item BADMAG
-coffread.c
 @item BCS
 tm-delta88.h
-@item BEFORE_MAIN_LOOP_HOOK
-main.c
 @item BELIEVE_PCC_PROMOTION
 coffread.c
 @item BELIEVE_PCC_PROMOTION_TYPE
 stabsread.c
-@item BIG_ENDIAN
-defs.h
 @item BITS_BIG_ENDIAN
 defs.h
 @item BKPT_AT_MAIN
@@ -2168,10 +2082,6 @@ dbxread.c
 tm-m68k.h
 @item BREAKPOINT
 tm-m68k.h
-@item BREAKPOINT_DEBUG
-breakpoint.c
-@item BSTRING
-regex.c
 @item CALL_DUMMY
 valops.c
 @item CALL_DUMMY_LOCATION
@@ -2198,10 +2108,6 @@ symm-tdep.c
 stack.c
 @item CPLUS_MARKER
 cplus-dem.c
-@item CREATE_INFERIOR_HOOK
-infrun.c
-@item C_ALLOCA
-regex.c
 @item C_GLBLREG
 coffread.c
 @item DBXREAD_ONLY
@@ -2216,8 +2122,6 @@ partial-stab.h
 hppabsd-xdep.c
 @item DECR_PC_AFTER_BREAK
 breakpoint.c
-@item DEFAULT_PROMPT
-main.c
 @item DELTA88
 m88k-xdep.c
 @item DEV_TTY
@@ -2232,10 +2136,11 @@ remote.c
 infrun.c
 @item DO_REGISTERS_INFO
 infcmd.c
+
 @item END_OF_TEXT_DEFAULT
-dbxread.c
-@item EXTERN
-buildsym.h
+This is an expression that should designate the end of the text section
+(? FIXME ?)
+
 @item EXTRACT_RETURN_VALUE
 tm-m68k.h
 @item EXTRACT_STRUCT_VALUE_ADDRESS
@@ -2246,8 +2151,6 @@ frame.h
 symtab.h
 @item FILES_INFO_HOOK
 target.c
-@item FIXME
-coffread.c
 @item FLOAT_INFO
 infcmd.c
 @item FOPEN_RB
@@ -2258,14 +2161,14 @@ a68v-xdep.c
 mach386-xdep.c
 @item FP_REGNUM
 parse.c
-@item FPU
-Unused?  6-oct-92 rich@@cygnus.com.  FIXME.
 @item FRAMELESS_FUNCTION_INVOCATION
 blockframe.c
 @item FRAME_ARGS_ADDRESS_CORRECT
 stack.c
+
 @item FRAME_CHAIN
 Given FRAME, return a pointer to the calling frame.
+
 @item FRAME_CHAIN_COMBINE
 blockframe.c
 @item FRAME_CHAIN_VALID
@@ -2276,12 +2179,17 @@ frame.h
 stack.c
 @item FRAME_GET_BASEREG_VALUE
 frame.h
-@item FRAME_NUM_ARGS
-tm-m68k.h
+
+@item FRAME_NUM_ARGS (val, fi)
+For the frame described by fi, set val to the number of arguments
+that are being passed.
+
 @item FRAME_SPECIFICATION_DYADIC
 stack.c
+
 @item FRAME_SAVED_PC
 Given FRAME, return the pc saved there.  That is, the return address.
+
 @item FUNCTION_EPILOGUE_SIZE
 coffread.c
 @item F_OK
@@ -2294,16 +2202,19 @@ dbxread.c
 symtab.c
 @item GCC_PRODUCER
 dwarfread.c
+
 @item GDB_TARGET_IS_HPPA
 This determines whether horrible kludge code in dbxread.c and partial-stab.h
 is used to mangle multiple-symbol-table files from HPPA's.  This should all
 be ripped out, and a scheme like elfread.c used.
+
 @item GDB_TARGET_IS_MACH386
 mach386-xdep.c
 @item GDB_TARGET_IS_SUN3
 a68v-xdep.c
 @item GDB_TARGET_IS_SUN386
 sun386-xdep.c
+
 @item GET_LONGJMP_TARGET
 For most machines, this is a target-dependent parameter.  On the DECstation
 and the Iris, this is a native-dependent parameter, since <setjmp.h> is
@@ -2313,6 +2224,7 @@ This macro determines the target PC address that longjmp() will jump
 to, assuming that we have just stopped at a longjmp breakpoint.  It
 takes a CORE_ADDR * as argument, and stores the target PC value through
 this pointer.  It examines the current state of the machine as needed.
+
 @item GET_SAVED_REGISTER
 findvar.c
 @item GPLUS_PRODUCER
@@ -2335,8 +2247,6 @@ inflow.c
 arm-tdep.c
 @item HOSTING_ONLY
 xm-rtbsd.h
-@item HOST_BYTE_ORDER
-ieee-float.c
 @item HPUX_ASM
 xm-hp300hpux.h
 @item HPUX_VERSION_5
@@ -2345,12 +2255,12 @@ hp300ux-xdep.c
 infrun.c
 @item I80960
 remote-vx.c
+
 @item IBM6000_TARGET
 Shows that we are configured for an IBM RS/6000 target.  This conditional
 should be eliminated (FIXME) and replaced by feature-specific macros.
 It was introduced in haste and we are repenting at leisure.
-@item IEEE_DEBUG
-ieee-float.c
+
 @item IEEE_FLOAT
 valprint.c
 @item IGNORE_SYMBOL
@@ -2383,8 +2293,6 @@ dbxread.c
 tm-ultra3.h
 @item LCC_PRODUCER
 dwarfread.c
-@item LITTLE_ENDIAN
-defs.h
 @item LOG_FILE
 remote-adapt.c
 @item LONGERNAMES
@@ -2401,14 +2309,8 @@ defs.h
 coffread.c
 @item MACHKERNELDEBUG
 hppabsd-tdep.c
-@item MAIN
-cplus-dem.c
 @item MAINTENANCE
 dwarfread.c
-@item MAINTENANCE_CMDS
-breakpoint.c
-@item MAINTENANCE_CMDS
-maint.c
 @item MIPSEL
 mips-tdep.c
 @item MOTOROLA
@@ -2419,14 +2321,8 @@ altos-xdep.c
 infrun.c
 @item NEED_TEXT_START_END
 exec.c
-@item NFAILURES
-regex.c
 @item NNPC_REGNUM
 infrun.c
-@item NORETURN
-defs.h
-@item NOTDEF
-regex.c
 @item NOTDEF
 remote-adapt.c
 @item NOTDEF
@@ -2487,14 +2383,15 @@ tm-a29k.h
 exec.c
 @item REG_STRUCT_HAS_ADDR
 findvar.c
-@item RE_NREGS
-regex.h
 @item R_FP
 dwarfread.c
 @item R_OK
 xm-altos.h
+
 @item SDB_REG_TO_REGNUM
-coffread.c
+Define this to convert sdb register numbers
+into gdb regnums.  If not defined, no conversion will be done.
+
 @item SEEK_END
 state.c
 @item SEEK_SET
@@ -2507,72 +2404,89 @@ infrun.c
 infrun.c
 @item SHIFT_INST_REGS
 breakpoint.c
-@item SIGN_EXTEND_CHAR
-regex.c
 @item SIGTRAP_STOP_AFTER_LOAD
 infrun.c
+
 @item SKIP_PROLOGUE
-tm-m68k.h
+A C statement that advances the PC across any function entry
+prologue instructions so as to reach ``real'' code.
+
 @item SKIP_PROLOGUE_FRAMELESS_P
-blockframe.c
+A C statement that should behave similarly, but that can stop
+as soon as the function is known to have a frame.
+If not defined, @code{SKIP_PROLOGUE} will be used instead.
+
 @item SKIP_TRAMPOLINE_CODE
 infrun.c
 @item SOLIB_ADD
 core.c
-@item SOLIB_CREATE_INFERIOR_HOOK
-infrun.c
 @item SP_REGNUM
 parse.c
+
 @item STAB_REG_TO_REGNUM
-stabsread.h
+Define this to convert stab register numbers (as gotten from `r' declarations)
+into gdb regnums.  If not defined, no conversion will be done.
+
 @item STACK_ALIGN
 valops.c
-@item STACK_DIRECTION
-alloca.c
 @item START_INFERIOR_TRAPS_EXPECTED
 infrun.c
 @item STOP_SIGNAL
 main.c
-@item STORE_RETURN_VALUE
-tm-m68k.h
+
+@item STORE_RETURN_VALUE (type, valbuf)
+A C expression that stores a function return value of type @var{type},
+where @var{valbuf} is the address of the value to be stored.
+
 @item SUN4_COMPILER_FEATURE
 infrun.c
 @item SUN_FIXED_LBRAC_BUG
 dbxread.c
 @item SVR4_SHARED_LIBS
 solib.c
-@item SWITCH_ENUM_BUG
-regex.c
 @item SYM1
 tm-ultra3.h
 @item SYMBOL_RELOADING_DEFAULT
 symfile.c
-@item SYNTAX_TABLE
-regex.c
-@item Sword
-regex.c
+
 @item TARGET_BYTE_ORDER
-defs.h
+The ordering of bytes in the target.
+This must be defined to be either @code{BIG_ENDIAN} or @code{LITTLE_ENDIAN}.
+
 @item TARGET_CHAR_BIT
-defs.h
+Number of bits in a char; defaults to 8.
+
 @item TARGET_COMPLEX_BIT
-defs.h
+Number of bits in a complex number; defaults to @code{2 * TARGET_FLOAT_BIT}.
+
 @item TARGET_DOUBLE_BIT
-defs.h
+Number of bits in a double float; defaults to @code{8 * TARGET_CHAR_BIT}.
+
 @item TARGET_DOUBLE_COMPLEX_BIT
-defs.h
+Number of bits in a double complex; defaults to @code{2 * TARGET_DOUBLE_BIT}.
+
 @item TARGET_FLOAT_BIT
-defs.h
+Number of bits in a float; defaults to @code{4 * TARGET_CHAR_BIT}.
+
 @item TARGET_INT_BIT
-defs.h
+Number of bits in an integer; defaults to @code{4 * TARGET_CHAR_BIT}.
+
 @item TARGET_LONG_BIT
-defs.h
+Number of bits in a long integer; defaults to @code{4 * TARGET_CHAR_BIT}.
+
 @item TARGET_LONG_DOUBLE_BIT
-defs.h
+Number of bits in a long double float;
+defaults to @code{2 * TARGET_DOUBLE_BIT}.
+
 @item TARGET_LONG_LONG_BIT
-defs.h
+Number of bits in a long long integer; defaults to @code{2 * TARGET_LONG_BIT}.
+
 @item TARGET_PTR_BIT
-defs.h
+Number of bits in a pointer; defaults to @code{TARGET_INT_BIT}.
+
+@item TARGET_SHORT_BIT
+Number of bits in a short integer; defaults to @code{2 * TARGET_CHAR_BIT}.
+
 @item TARGET_READ_PC
 @item TARGET_WRITE_PC
 @item TARGET_READ_SP
@@ -2588,10 +2502,6 @@ These macros are useful when a target keeps one of these registers in a
 hard to get at place;  for example, part in a segment register and part
 in an ordinary register.
 
-@item TARGET_SHORT_BIT
-defs.h
-@item TDESC
-infrun.c
 @item T_ARG
 coffread.c
 @item T_VOID
@@ -2612,14 +2522,8 @@ i386-xdep.c
 dbxread.c
 @item WRS_ORIG
 remote-vx.c
-@item _LANG_c
-language.c
-@item _LANG_m2
-language.c
 @item __GO32__
 inflow.c
-@item __HAVE_68881__
-m68k-stub.c
 @item __HPUX_ASM__
 xm-hp300hpux.h
 @item __INT_VARARGS_H
@@ -2628,8 +2532,6 @@ printcmd.c
 pyr-xdep.c
 @item GOULD_PN
 gould-pinsn.c
-@item emacs
-alloca.c
 @item hp800
 xm-hppabsd.h
 @item hpux
@@ -2642,20 +2544,14 @@ m68k-stub.c
 ns32k-opcode.h
 @item sgi
 mips-tdep.c
-@item sparc
-regex.c
-@item static
-alloca.c
 @item sun
 m68k-tdep.c
 @item sun386
 tm-sun386.h
+
 @item test
-regex.c
-@item x_name
-coffread.c
-@item x_zeroes
-coffread.c
+(Define this to enable testing code in regex.c.)
+
 @end table
 
 @node Native Conditionals
@@ -2667,9 +2563,11 @@ are the same.  These macros should be defined (or left undefined)
 in @file{nm-@var{system}.h}.
 
 @table @code
+
 @item ATTACH_DETACH
 If defined, then gdb will include support for the @code{attach} and
 @code{detach} commands.
+
 @item FETCH_INFERIOR_REGISTERS
 Define this if the native-dependent code will provide its
 own routines
@@ -2678,6 +2576,7 @@ own routines
 If this symbol is @emph{not} defined, and @file{infptrace.c}
 is included in this configuration, the default routines in
 @file{infptrace.c} are used for these functions.
+
 @item GET_LONGJMP_TARGET
 For most machines, this is a target-dependent parameter.  On the DECstation
 and the Iris, this is a native-dependent parameter, since <setjmp.h> is
@@ -2687,22 +2586,32 @@ This macro determines the target PC address that longjmp() will jump
 to, assuming that we have just stopped at a longjmp breakpoint.  It
 takes a CORE_ADDR * as argument, and stores the target PC value through
 this pointer.  It examines the current state of the machine as needed.
+
 @item PROC_NAME_FMT
 Defines the format for the name of a @file{/proc} device.  Should be
 defined in @file{nm.h} @emph{only} in order to override the default
 definition in @file{procfs.c}.
+
 @item PTRACE_FP_BUG
 mach386-xdep.c
+
 @item PTRACE_ARG3_TYPE
 The type of the third argument to the @code{ptrace} system call, if it exists
 and is different from @code{int}.
+
 @item REGISTER_U_ADDR
 Defines the offset of the registers in the ``u area''; @pxref{Host}.
+
+@item SOLIB_CREATE_INFERIOR_HOOK
+Define this to expand into any shared-library-relocation code
+that you want to be run just after the child process has been forked.
+
 @item USE_PROC_FS
 This determines whether small routines in @file{*-tdep.c}, which
 translate register values
 between GDB's internal representation and the /proc representation,
 are compiled.
+
 @item U_REGS_OFFSET
 This is the offset of the registers in the upage.  It need only be
 defined if the generic ptrace register access routines in
@@ -2714,6 +2623,7 @@ from @file{infptrace.c} is good enough, leave it undefined.
 The default value means that u.u_ar0 @emph{points to} the location of the
 registers.  I'm guessing that @code{#define U_REGS_OFFSET 0} means that
 u.u_ar0 @emph{is} the location of the registers.
+
 @end table
 
 @node Obsolete Conditionals