From: Daniel Jacobowitz <drow@false.org>
Date: Sun, 22 Jun 2003 04:28:04 +0000 (+0000)
Subject: 	* gdbint.texinfo (Coding): Clarify use of gdb_XXX.h headers.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=b4177fca1357236a635e37a18c2e143e3eadbede;p=binutils-gdb.git

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

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 60c1ad6e25c..b1b61a69b25 100644
--- 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 76521dbe48a..4f031e0f6b1 100644
--- 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.