From: Akim Demaille <akim@epita.fr>
Date: Wed, 27 Aug 2003 07:29:30 +0000 (+0000)
Subject: * doc/autoconf.texi (AC_FUNC_FSEEKO, AC_SYS_LARGEFILE): More
X-Git-Tag: AUTOCONF-2.57c~21
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4a7536e3704e2c95ca600d3e080ad992e9493482;p=thirdparty%2Fautoconf.git

* doc/autoconf.texi (AC_FUNC_FSEEKO, AC_SYS_LARGEFILE): More
documentation.
From Guido Draheim.
---

diff --git a/ChangeLog b/ChangeLog
index 6f80eaf5..5ca29ede 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2003-08-27  Akim Demaille  <akim@epita.fr>
+
+	* doc/autoconf.texi (AC_FUNC_FSEEKO, AC_SYS_LARGEFILE): More
+	documentation.
+	From Guido Draheim.
+
 2003-08-26  Akim Demaille  <akim@epita.fr>
 
 	* doc/autoconf.texi (Output): Make clear that one can run code
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index a3c97661..cf5be8ec 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -3773,7 +3773,11 @@ yourself in new code:
 @c @fuindex fseeko
 @prindex @code{fseeko}
 If the @code{fseeko} function is available, define @code{HAVE_FSEEKO}.
-Define @code{_LARGEFILE_SOURCE} if necessary.
+Define @code{_LARGEFILE_SOURCE} if necessary to make the prototype
+visible on some systems (e.g. glibc 2.2). Otherwise linkage problems
+may occur when compiling with @code{AC_SYS_LARGEFILE} on
+largefile-sensitive systems where @code{off_t} does not default to a
+64bit entity.
 @end defmac
 
 @defmac AC_FUNC_GETGROUPS
@@ -5816,6 +5820,12 @@ If you use this macro, check that your program works even when
 large-file support is enabled.  For example, it is not correct to print
 an arbitrary @code{off_t} value @code{X} with @code{printf ("%ld",
 (long) X)}.
+
+The LFS introduced the @code{fseeko} and @code{ftello} functions to
+replace their C counterparts @code{fseek} and @code{ftell} that do not
+use @code{off_t}. Take care to use @code{AC_FUNC_FSEEKO} to make their
+prototypes available when using them and large-file support is
+enabled.
 @end defmac
 
 @defmac AC_SYS_LONG_FILE_NAMES