* gdbint.texinfo (Coding): Clarify use of gdb_XXX.h headers.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 60c1ad6..b1b61a6 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,9 @@
 2003-06-22  Daniel Jacobowitz  <drow@mvista.com>
 
+       * gdbint.texinfo (Coding): Clarify use of gdb_XXX.h headers.
+
+2003-06-22  Daniel Jacobowitz  <drow@mvista.com>
+
        * Makefile.in (SFILES_INCLUDED): Add agentexpr.texi.
        * agentexpr.texi: Retitle section, and change it to an appendix.
        Comment out texinfo initialization.  Factor a @var{} into two

diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 76521db..4f031e0 100644 (file)
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -5191,7 +5191,11 @@ of @value{GDBN}) must be added to @file{gdb/config/djgpp/fnchange.lst}.
 
 When @value{GDBN} has a local version of a system header file (ex
 @file{string.h}) the file name based on the POSIX header prefixed with
-@file{gdb_} (@file{gdb_string.h}).
+@file{gdb_} (@file{gdb_string.h}).  These headers should be relatively
+independent: they should use only macros defined by @file{configure},
+the compiler, or the host; they should include only system headers; they
+should refer only to system types.  They may be shared between multiple
+programs, e.g.@: @value{GDBN} and @sc{gdbserver}.
 
 For other files @samp{-} is used as the separator.