From: Bruno Haible <bruno@clisp.org>
Date: Sat, 7 Feb 2009 10:39:09 +0000 (+0100)
Subject: Improve doc of dirfd module.
X-Git-Tag: v0.1~6371
X-Git-Url: http://erislabs.org.uk/gitweb/?a=commitdiff_plain;h=3c05103d06694d8bf8897a477984240074aa26df;p=gnulib.git

Improve doc of dirfd module.
---

diff --git a/ChangeLog b/ChangeLog
index 084c626fd..772d7a255 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-02-07  Bruno Haible  <bruno@clisp.org>
+
+	* doc/posix-functions/dirfd.texi: Clarify situation on mingw. Document
+	failure behaviour.
+
 2009-02-07  Jim Meyering  <meyering@redhat.com>
 
 	regex: avoid compilation failure with upcoming gcc-4.4
diff --git a/doc/posix-functions/dirfd.texi b/doc/posix-functions/dirfd.texi
index 601fab87d..d79c2dbb7 100644
--- a/doc/posix-functions/dirfd.texi
+++ b/doc/posix-functions/dirfd.texi
@@ -10,12 +10,16 @@ Portability problems fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-AIX 5.1, HP-UX 11, OSF/1 5.1, Solaris 10.
+AIX 5.1, HP-UX 11, OSF/1 5.1, Solaris 10, mingw.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
+This function always fails on some platforms:
 mingw.
 @end itemize
+
+With the @code{dirfd} module, this functions always sets @code{errno} when it
+fails. (POSIX does not require that @code{dirfd} sets @code{errno} when it
+fails.)