Mercurial > hg > octave-nkf > gnulib-hg
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