From 4a07a4c1681a85311ab4d7f329291ffdefd9b811 Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Fri, 10 Oct 2008 02:05:36 +0200
Subject: [PATCH] Document <sys/ioctl.h> status.

---
 ChangeLog                        |  5 +++++
 doc/glibc-headers/sys_ioctl.texi | 33 +++++++++++++++++++++++++++++++++
 doc/gnulib.texi                  |  5 +++++
 3 files changed, 43 insertions(+)
 create mode 100644 doc/glibc-headers/sys_ioctl.texi

diff --git a/ChangeLog b/ChangeLog
index 6a1ffa40b..64d035a2b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-10-09  Bruno Haible  <bruno@clisp.org>
+
+	* doc/glibc-headers/sys_ioctl.texi: New file.
+	* doc/gnulib.texi: Include it.
+
 2008-10-09  Paolo Bonzini  <bonzini@gnu.org>
             Bruno Haible  <bruno@clisp.org>
 
diff --git a/doc/glibc-headers/sys_ioctl.texi b/doc/glibc-headers/sys_ioctl.texi
new file mode 100644
index 000000000..16908bd18
--- /dev/null
+++ b/doc/glibc-headers/sys_ioctl.texi
@@ -0,0 +1,33 @@
+@node sys/ioctl.h
+@section @file{sys/ioctl.h}
+
+Declares the function @code{ioctl}.
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{IOCTLs,,,libc},
+@end ifinfo
+@ifnotinfo
+@url{http://www.gnu.org/software/libc/manual/html_node/IOCTLs.html},
+@end ifnotinfo
+@item
+@uref{http://www.kernel.org/doc/man-pages/online/pages/man2/ioctl.2.html,,man ioctl}.
+@end itemize
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This header file is missing on some platforms:
+mingw.
+@item
+This header file does not declare the @code{ioctl} function on some platforms:
+AIX 5.1, Solaris 10.
+@end itemize
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 0e2ed96d2..5b99de05d 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -2937,6 +2937,7 @@ not worked around by Gnulib.
 * pty.h::
 * resolv.h::
 * shadow.h::
+* sys/ioctl.h::
 * sysexits.h::
 * ttyent.h::
 @end menu
@@ -2969,6 +2970,7 @@ not worked around by Gnulib.
 @include glibc-headers/pty.texi
 @include glibc-headers/resolv.texi
 @include glibc-headers/shadow.texi
+@include glibc-headers/sys_ioctl.texi
 @include glibc-headers/sysexits.texi
 @include glibc-headers/ttyent.texi
 
@@ -5088,6 +5090,9 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/ioperm.texi
 @include glibc-functions/iopl.texi
 
+@c @node Glibc sys/ioctl.h
+@c @section Glibc @code{<sys/ioctl.h>}
+
 @c @node Glibc sys/ipc.h
 @c @section Glibc Extensions to @code{<sys/ipc.h>}
 
-- 
2.11.0