New module: mreadlink-with-size.

[gnulib.git] / doc / functions / ftell.texi

diff --git a/doc/functions/ftell.texi b/doc/functions/ftell.texi
index 45a0d0f..00b5402 100644 (file)
--- a/doc/functions/ftell.texi
+++ b/doc/functions/ftell.texi
@@ -4,10 +4,12 @@
 
 POSIX specification: @url{http://www.opengroup.org/susv3xsh/ftell.html}
 
-Gnulib module: ---
+Gnulib module: ftell
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+This function mistakenly succeeds on pipes on some platforms: mingw.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -16,4 +18,8 @@ Portability problems not fixed by Gnulib:
 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
 on input streams that are opened in @code{O_TEXT} mode and whose contents
 contains Unix line terminators (LF), on some platforms: mingw.
+@item
+On platforms where @code{long} is a 32-bit type, @code{ftell} does not work
+correctly with files larger than 2 GB.  The fix is to use @code{ftello}
+instead and to invoke the @code{AC_SYS_LARGEFILE} macro.
 @end itemize