Re: autoconf 2.52 vs Solaris 2.6 AC_SYS_LARGEFILE problems

[Paul Eggert]

> From: Akim Demaille <address@hidden>
> Date: 29 Jan 2002 18:20:06 +0100
> 
> Paul, anything we should leave in autoconf.texi about this story?

How about something like this?

--- autoconf.texi       Wed Jan 30 15:26:34 2002
+++ /net/knick/home/eggert/junk/autoconf.texi   Wed Jan 30 15:37:52 2002
@@ -8937,6 +8937,8 @@ HP-UX @command{cc} doesn't accept @file{
 assemble.  @samp{cc -c foo.S} will appear to succeed, but in fact does
 nothing.
 
+Also please see the entry for @command{gcc} below.
+
 
 @item @command{cmp}
 @c ----------------
@@ -9158,6 +9160,22 @@ $ @kbd{find . -name foo -exec echo "@address@hidden
 while @sc{gnu} @command{find} reports @samp{./foo-./foo}.
 
 
address@hidden @command{gcc}
address@hidden ----------------
+
+Autoconf generates a simple sanity check to verify that @command{gcc}
+works on simple programs, but it cannot verify that @command{gcc}
+works on all cases.  Installers on address@hidden hosts must take
+special care to install and use @command{gcc} correctly, as it is easy
+to go wrong.  One commmon problem is incorrect specification of
+include paths or of link-time or run-time library paths.  Another
+common problem is use of a @command{gcc} on an operating system that
+it was not designed or configured for.  To take just one example,
address@hidden 2.7.x does not work on Solaris 2.6 and up (as those
+versions of Solaris were released after @command{gcc} 2.7.x), but the
+failure symptoms are subtle and occur only in some situations.
+
+
 @item @command{grep}
 @c -----------------
 @prindex @command{grep}