*-config.texi: introduce new switch GENERIC to describe text *only* for

(the usual) non-specialized versions of the manual.

gdb.texinfo: list of nonstandard init file names, with brief descriptions
             (permits closing PRMS gdb/2296).

diff --git a/gdb/doc/all-config.texi b/gdb/doc/all-config.texi
index 83c9ba135e3931f92013229a5fb2f919e3e6a67e..c1ccb051880061034f705300d91daccf06cd12a6 100644 (file)
--- a/gdb/doc/all-config.texi
+++ b/gdb/doc/all-config.texi
@@ -7,6 +7,7 @@
 @set   CONLY
 @set   DOSHOST
 @clear FSFDOC
+@set   GENERIC
 @set   Hviii
 @set   HviiiEXCLUSIVE
 @clear Icmlx

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index ae576b3a759ec231392014f557573a305f6df475..47d8cfca87ec40dca6a7f55be40424dde4b35666 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -18,7 +18,7 @@
 @c %**end of header
 
 @iftex
-@smallbook
+@c @smallbook
 @c @cropmarks
 @end iftex
 
@@ -7384,8 +7384,33 @@ When you start @value{GDBN}, it automatically executes commands from its
 the init file (if any) in your home directory and then the init file
 (if any) in the current working directory.  (The init files are not
 executed if you use the @samp{-nx} option; @pxref{Mode Options,
-,Choosing modes}.)  You can also request the execution of a command
-file with the @code{source} command:
+,Choosing modes}.)
+
+@ifset GENERIC
+@cindex init file name
+On some configurations of @value{GDBN}, the init file is known by a
+different name (these are typically environments where a specialized
+form of GDB may need to coexist with other forms, hence a different name
+for the specialized version's init file).  These are the environments
+with special init file names:
+
+@itemize @bullet
+@kindex .vxgdbinit
+@item
+VxWorks (Wind River Systems real-time OS): @samp{.vxgdbinit}
+
+@kindex .os68gdbinit
+@item
+OS68K (Enea Data Systems real-time OS): @samp{.os68gdbinit}
+
+@kindex .esgdbinit
+@item
+ES-1800 (Ericsson Telecom AB M68000 emulator): @samp{.esgdbinit}
+@end itemize
+@end ifset
+
+You can also request the execution of a command file with the
+@code{source} command:
 
 @table @code
 @item source @var{filename}

diff --git a/gdb/doc/h8-config.texi b/gdb/doc/h8-config.texi
index 83c9ba135e3931f92013229a5fb2f919e3e6a67e..fb18ede02baa00819b8b126939c9ebaa6b5a95c6 100644 (file)
--- a/gdb/doc/h8-config.texi
+++ b/gdb/doc/h8-config.texi
@@ -7,6 +7,7 @@
 @set   CONLY
 @set   DOSHOST
 @clear FSFDOC
+@clear GENERIC
 @set   Hviii
 @set   HviiiEXCLUSIVE
 @clear Icmlx