From: Eric Blake Date: Tue, 23 Sep 2008 12:48:07 +0000 (-0600) Subject: fopen: document mingw bug on directories X-Git-Tag: v0.1~7014 X-Git-Url: http://erislabs.org.uk/gitweb/?a=commitdiff_plain;h=09d1d202eabd3ca07faea5c3153cfcf5b93cb76c;p=gnulib.git fopen: document mingw bug on directories * doc/posix-functions/fopen.texi (fopen): Mention mingw bug for not allowing a stream visiting a directory, even though reading from such a stream is not portable. Signed-off-by: Eric Blake --- diff --git a/ChangeLog b/ChangeLog index 3dfc1c44b..38dd15e83 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2008-09-23 Eric Blake + + fopen: document mingw bug on directories + * doc/posix-functions/fopen.texi (fopen): Mention mingw bug for + not allowing a stream visiting a directory, even though reading + from such a stream is not portable. + 2008-09-23 Paolo Bonzini * lib/poll.c: Rewrite. diff --git a/doc/posix-functions/fopen.texi b/doc/posix-functions/fopen.texi index da6acde58..442d1b665 100644 --- a/doc/posix-functions/fopen.texi +++ b/doc/posix-functions/fopen.texi @@ -26,4 +26,10 @@ upon failure. On Windows, this function returns a file stream in ``text'' mode by default; this means that it translates @code{'\n'} to CR/LF by default. Use the @code{"b"} flag if you need reliable binary I/O. +@item +On Windows platforms (excluding Cygwin), this function fails to open +directories for reading. Such streams have implementation-defined +semantics on other platforms. To avoid directory streams with a +consistent error message, use @code{fstat} after @code{open} and +@code{fdopen}, rather than @code{fopen} and @code{fileno}. @end itemize