X-Git-Url: https://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fposix_openpt.texi;h=8d47b36f6f0e22076f8ab1ed7c62a4b517f6e130;hb=b28ec8ed78286cbd1d113d0785e0e1f5cf11832e;hp=bd848e6cd6d13bc9160f4338e2820cc7ec081e4e;hpb=4e39aa42880fd6a5c6d55f67c912381c0d0980aa;p=gnulib.git

diff --git a/doc/posix-functions/posix_openpt.texi b/doc/posix-functions/posix_openpt.texi
index bd848e6cd..8d47b36f6 100644
--- a/doc/posix-functions/posix_openpt.texi
+++ b/doc/posix-functions/posix_openpt.texi
@@ -4,16 +4,23 @@
 
 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/posix_openpt.html}
 
-Gnulib module: ---
+Gnulib module: posix_openpt
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+This function is missing on some platforms:
+Mac OS X 10.3, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1,
+Solaris 9, Cygwin 1.5.x, mingw, MSVC 9, Interix 3.5, BeOS.
+However, the replacement may fail with @code{ENOSYS} or @code{ENOENT} on
+some platforms.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
-@item
-This function is missing on some platforms:
-MacOS X 10.3, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1,
-Solaris 9, Cygwin 1.5.x, mingw, MSVC 9, Interix 3.5, BeOS.
 @end itemize
+
+Note that when using this function to open the master side of a
+pseudo-terminal, you still need platform dependent code to open the
+corresponding slave side.  The Gnulib module @code{openpty} provides
+an easy-to-use API that does both at once.