This reworks doc that was added on 2008-09-29.
* doc/posix-functions/select.texi: Fix copy-and-paste mistake and use
clearer wording.
* doc/posix-functions/accept.texi: Use clearer wording.
* doc/posix-functions/bind.texi: Likewise.
* doc/posix-functions/connect.texi: Likewise.
* doc/posix-functions/getpeername.texi: Likewise.
* doc/posix-functions/getsockname.texi: Likewise.
* doc/posix-functions/getsockopt.texi: Likewise.
* doc/posix-functions/ioctl.texi: Likewise.
* doc/posix-functions/listen.texi: Likewise.
* doc/posix-functions/recv.texi: Likewise.
* doc/posix-functions/recvfrom.texi: Likewise.
* doc/posix-functions/send.texi: Likewise.
* doc/posix-functions/sendto.texi: Likewise.
* doc/posix-functions/setsockopt.texi: Likewise.
* doc/posix-functions/shutdown.texi: Likewise.
* doc/posix-functions/socket.texi: Likewise.
+2017-05-11 Bruno Haible <bruno@clisp.org>
+
+ doc: Clarify doc about socket functions on native Windows.
+ This reworks doc that was added on 2008-09-29.
+ * doc/posix-functions/select.texi: Fix copy-and-paste mistake and use
+ clearer wording.
+ * doc/posix-functions/accept.texi: Use clearer wording.
+ * doc/posix-functions/bind.texi: Likewise.
+ * doc/posix-functions/connect.texi: Likewise.
+ * doc/posix-functions/getpeername.texi: Likewise.
+ * doc/posix-functions/getsockname.texi: Likewise.
+ * doc/posix-functions/getsockopt.texi: Likewise.
+ * doc/posix-functions/ioctl.texi: Likewise.
+ * doc/posix-functions/listen.texi: Likewise.
+ * doc/posix-functions/recv.texi: Likewise.
+ * doc/posix-functions/recvfrom.texi: Likewise.
+ * doc/posix-functions/send.texi: Likewise.
+ * doc/posix-functions/sendto.texi: Likewise.
+ * doc/posix-functions/setsockopt.texi: Likewise.
+ * doc/posix-functions/shutdown.texi: Likewise.
+ * doc/posix-functions/socket.texi: Likewise.
+
2017-05-10 Bruno Haible <bruno@clisp.org>
poll: Fix link error on native Windows.
@code{write}, and @code{close}; you have to use @code{recv}, @code{send},
@code{closesocket} in these cases instead.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{accept}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for @code{bind}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{connect} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{getpeername} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{getsockname} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{getsockopt} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
@itemize
@item
On Windows platforms (excluding Cygwin), @code{ioctl} is called
-@code{ioctlsocket}, and error codes for this function are not placed in
+@code{ioctlsocket}, and error codes from this function are not placed in
@code{errno}, and @code{WSAGetLastError} must be used instead.
@item
On glibc platforms, the second parameter is of type @code{unsigned long}
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for @code{listen}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
on some platforms:
OSF/1 5.1.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{recv}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
on some platforms:
OSF/1 5.1.
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{recvfrom} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
called on descriptors created by the @code{socket} function, not on regular
file descriptors.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
-placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@item
This function fails when the @code{nfds} argument is 0 on some platforms:
Interix 3.5.
on some platforms:
OSF/1 5.1.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{send}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
on some platforms:
OSF/1 5.1.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{sendto}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{setsockopt} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
Portability problems fixed by Gnulib:
@itemize
@item
-On Windows platforms (excluding Cygwin), error codes for
-@code{shutdown} are not placed in @code{errno}, and
-@code{WSAGetLastError} must be used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib:
@code{write}, and @code{close}; you have to use @code{recv}, @code{send},
@code{closesocket} in these cases instead.
@item
-On Windows platforms (excluding Cygwin), error codes for @code{socket}
-are not placed in @code{errno}, and @code{WSAGetLastError} must be
-used instead.
+On Windows platforms (excluding Cygwin), error codes from this function
+are not placed in @code{errno}, and @code{WSAGetLastError} must be used
+instead.
@end itemize
Portability problems not fixed by Gnulib: