*-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).

3 files changed, 30 insertions, 3 deletions

diff --git a/gdb/doc/all-config.texi b/gdb/doc/all-config.texi
index 83c9ba1..c1ccb05 100644
--- 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 ae576b3..47d8cfc 100644
--- 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 83c9ba1..fb18ede 100644
--- 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