doc: document sticky-EOF issue

[gnulib.git] / doc / posix-functions / lseek.texi

diff --git a/doc/posix-functions/lseek.texi b/doc/posix-functions/lseek.texi
index 3a19327..1c87759 100644 (file)
--- a/doc/posix-functions/lseek.texi
+++ b/doc/posix-functions/lseek.texi
@@ -9,7 +9,10 @@ Gnulib module: lseek
 Portability problems fixed by Gnulib:
 @itemize
 @item
-This function mistakenly succeeds on pipes on some platforms: mingw, BeOS.
+On platforms where @code{off_t} is a 32-bit type, @code{lseek} does not work
+correctly with files larger than 2 GB.  (Cf. @code{AC_SYS_LARGEFILE}.)
+@item
+This function mistakenly succeeds on pipes on some platforms: mingw, MSVC 9, BeOS.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -19,10 +22,6 @@ POSIX does not specify which file descriptors support seeking and which don't.
 In practice, regular files and block devices support seeking, and ttys, pipes,
 and most character devices don't support it.
 @item
-On platforms where @code{off_t} is a 32-bit type, @code{lseek} does not work
-correctly with files larger than 2 GB.  The fix is to use the
-@code{AC_SYS_LARGEFILE} macro.
-@item
 When the third argument is invalid, POSIX says that @code{lseek} should set
 @code{errno} to @code{EINVAL} and return -1, but in this situation a
 @code{SIGSYS} signal is raised on some platforms: