avoid some overlong lines from posix urls, etc.
[gnulib.git] / doc / posix-functions / fflush.texi
1 @node fflush
2 @section @code{fflush}
3 @findex fflush
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/fflush.html}
6
7 Gnulib module: fflush
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 @code{fflush} followed by @code{fseek} or @code{fseeko}, applied to an input
13 stream, should have the effect of positioning the underlying file descriptor.
14 It doesn't do this on some platforms.
15 @item
16 @code{fflush} on an input stream changes the position of the stream to the
17 end of the previous buffer, on some platforms: mingw.
18 @item
19 @code{fflush} on an input stream right after @code{ungetc} does not discard
20 the @code{ungetc} buffer, on some platforms:
21 MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, Cygwin 1.5.25-10.
22 @end itemize
23
24 Portability problems not fixed by Gnulib:
25 @itemize
26 @item
27 @code{fflush}, @code{ftell}, @code{ftello}, @code{fgetpos} behave incorrectly
28 on input streams that are opened in @code{O_TEXT} mode and whose contents
29 contains Unix line terminators (LF), on some platforms: mingw.
30 @item
31 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
32 upon failure.
33 @item
34 @code{fflush} on an input stream right after @code{ungetc} does not discard
35 the @code{ungetc} buffer, on some platforms:
36 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, mingw.
37 @end itemize