diff man/internals/internals.texi @ 359:8e84bee8ddd0 r21-1-9

Import from CVS: tag r21-1-9
author cvs
date Mon, 13 Aug 2007 10:57:55 +0200
parents 182f72e8cd0d
children 972bbb6d6ca2
line wrap: on
line diff
--- a/man/internals/internals.texi	Mon Aug 13 10:57:07 2007 +0200
+++ b/man/internals/internals.texi	Mon Aug 13 10:57:55 2007 +0200
@@ -1690,6 +1690,15 @@
 system header files) to ensure that certain tricks played by various
 @file{s/} and @file{m/} files work out correctly.
 
+When including header files, always use angle brackets, not double
+quotes, except when the file to be included is in the same directory as
+the including file.  If either file is a generated file, then that is
+not likely to be the case.  In order to understand why we have this
+rule, imagine what happens when you do a build in the source directory
+using @samp{./configure} and another build in another directory using
+@samp{../work/configure}.  There will be two different @file{config.h}
+files.  Which one will be used if you @samp{#include "config.h"}?
+
   @strong{All global and static variables that are to be modifiable must
 be declared uninitialized.}  This means that you may not use the ``declare
 with initializer'' form for these variables, such as @code{int