changeset 10468:76082cdf54ba

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 <ebb9@byu.net>
author Eric Blake <ebb9@byu.net>
date Tue, 23 Sep 2008 06:48:07 -0600
parents f96117307f4a
children cc79b4b4da2c
files ChangeLog doc/posix-functions/fopen.texi
diffstat 2 files changed, 13 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-09-23  Eric Blake  <ebb9@byu.net>
+
+	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  <bonzini@gnu.org>
 
 	* lib/poll.c: Rewrite.
--- a/doc/posix-functions/fopen.texi
+++ b/doc/posix-functions/fopen.texi
@@ -26,4 +26,10 @@
 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