* doc/gnulib-tool.texi (Initial import): Reword description of

_FILE_OFFSET_BITS and _GNU_SOURCE, since they sometimes have a
limited effect even if defined after the first system include.

diff --git a/ChangeLog b/ChangeLog
index 4267fb65e06f736f61105a1dae70cd77dd3e9243..28ea90c2202a116a3a5093511f22df3e2af78b79 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-03-02  Paul Eggert  <eggert@cs.ucla.edu>
+
+       * doc/gnulib-tool.texi (Initial import): Reword description of
+       _FILE_OFFSET_BITS and _GNU_SOURCE, since they sometimes have a
+       limited effect even if defined after the first system include.
+
 2007-03-01  Bruno Haible  <bruno@clisp.org>
 
        * build-aux/config.libpath: Update to libtool-1.5.22.

diff --git a/doc/gnulib-tool.texi b/doc/gnulib-tool.texi
index a7f6ca7feb8e515f5bf17fd1426dfd8c61790a30..db3e223dab18163d1415880639fb5ff838824343 100644 (file)
--- a/doc/gnulib-tool.texi
+++ b/doc/gnulib-tool.texi
@@ -235,10 +235,9 @@ file.  That way, for example, if @file{config.h} defines
 @samp{restrict} to be the empty string on a pre-C99 host, or a macro
 like @samp{_FILE_OFFSET_BITS} that affects the layout of data
 structures, the definition is consistent for all include files.
-Another reason why @file{config.h} must be included before any other
-include file is that it may define macros like @samp{_GNU_SOURCE}
-or @samp{_FILE_OFFSET_BITS} which, on glibc systems, have an effect only
-if defined before the first system header file is included.
+Also, on some platforms macros like @samp{_FILE_OFFSET_BITS} and
+@samp{_GNU_SOURCE} may be ineffective, or may have only a limited
+effect, if defined after the first system header file is included.
 
 A final word of warning: Gnulib currently assumes it will be
 responsible for @emph{all} functions that end up in the Autoconf