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

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 60c1ad6e25ca60e990b2e65362a90bc95d873f57..b1b61a69b255d8902ba531e8dcd59b630c039912 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+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.

diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 76521dbe48a642af7d6c9c4da395e218d0083375..4f031e0f6b1565155cfc4f66692c52d8caad900a 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.