docs: mention cygwin shortcoming in <sys/un.h>

I'm not quite ready to implement a replacement <sys/un.h> that
automatically works around this problem, since making the replacement
work for mingw seems much harder; so for now I'm just documenting
the issue I hit.

* doc/posix-headers/sys_un.texi (sys/un.h): Mention problem.

Signed-off-by: Eric Blake <eblake@redhat.com>

diff --git a/ChangeLog b/ChangeLog
index d7202e0..d251b37 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2013-05-30  Eric Blake  <eblake@redhat.com>
 
+       docs: mention cygwin shortcoming in <sys/un.h>
+       * doc/posix-headers/sys_un.texi (sys/un.h): Mention problem.
+
        vasnprintf: silence mingw compiler warning
        * lib/vasnprintf.c (VASNPRINTF): Avoid unused variable warning.
 

diff --git a/doc/posix-headers/sys_un.texi b/doc/posix-headers/sys_un.texi
index 78c848e..2297a13 100644 (file)
--- a/doc/posix-headers/sys_un.texi
+++ b/doc/posix-headers/sys_un.texi
@@ -14,4 +14,8 @@ Portability problems not fixed by Gnulib:
 @item
 This header file is missing on some platforms:
 mingw, MSVC 9, BeOS.
+@item
+This header requires <code>sys/socket.h</code> to be included first on
+some platforms:
+Cygwin 1.7.18.
 @end itemize