Mercurial > hg > octave-kai > gnulib-hg

diff doc/posix-functions/fopen.texi @ 10468:76082cdf54ba

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 (2008-09-23)
parents 8532ecccedda
children a4dc39a18d54
line wrap: on
line diff
--- 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