]> Savannah Git Hosting - gnulib.git/commitdiff
doc: Clarify doc about socket functions on native Windows.
authorBruno Haible <bruno@clisp.org>
Thu, 11 May 2017 13:22:13 +0000 (15:22 +0200)
committerBruno Haible <bruno@clisp.org>
Thu, 11 May 2017 13:23:11 +0000 (15:23 +0200)
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.

17 files changed:
ChangeLog
doc/posix-functions/accept.texi
doc/posix-functions/bind.texi
doc/posix-functions/connect.texi
doc/posix-functions/getpeername.texi
doc/posix-functions/getsockname.texi
doc/posix-functions/getsockopt.texi
doc/posix-functions/ioctl.texi
doc/posix-functions/listen.texi
doc/posix-functions/recv.texi
doc/posix-functions/recvfrom.texi
doc/posix-functions/select.texi
doc/posix-functions/send.texi
doc/posix-functions/sendto.texi
doc/posix-functions/setsockopt.texi
doc/posix-functions/shutdown.texi
doc/posix-functions/socket.texi

index e2b473b4e9163aeb827a084f7746c3f3a4ff0f2e..f5f34cc62c796317cccbee2041de9a9f9bdf9012 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,25 @@
+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.
index 65dab3719ead156629a9acdb2ba9d9f6c4f41fdd..a92ea3f057edfb30ba9d80b1215886756e358e47 100644 (file)
@@ -14,9 +14,9 @@ the @code{accept} function cannot be used in calls to @code{read},
 @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:
index 49f6e65de95b5dac9e520221664f00f5475816cd..1eb52848ab892235218068d44a4b0689cfc05837 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: bind
 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:
index f2fcd66c47aef8ad39922bb6f45dcf3dd4f96f15..0e9b3a91ec9e7266a3c0f1d80fa0071f935819c4 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: connect
 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:
index 5d2cefaf2b3171508f2644db65ff1dcc0f1c0c7a..5b2776e78f0a75fd21f09b87e216f34134867919 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: getpeername
 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:
index e0df7caea10105e3cdd06e85835b88e026968c42..7d462a72b0cc6e81dac44a1562cdf4d1126a7196 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: getsockname
 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:
index 28cc41f7bb1cd1965c871f665f63cba7941b1c7d..9e7d26e43308ba0d9ae6c00581630c00cec550cd 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: getsockopt
 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:
index 0afe64bb1b6e7c590b7671b61606f0c225a0e817..c4e24151e2445c7251b910d3c6c5d16e04dde865 100644 (file)
@@ -10,7 +10,7 @@ Portability problems 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}
index 0c16ede1aa714264cde0e5ddfd3bc688e8fbacdc..44d8c3297cc0898f313228d09ea5e3b3332c8c2d 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: listen
 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:
index 028966eddaea556dace0774bed0f00d86675cc3a..d39238ac741599662109ab47831c82bf1481dbfe 100644 (file)
@@ -13,9 +13,9 @@ This function has the return type @code{int} instead of @code{ssize_t}
 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:
index c3765488004432cd2485a673f258ff7b21ec9863..f591d0c2f93c9ff2d64a7b8e6f4496c91beac8f1 100644 (file)
@@ -13,9 +13,9 @@ This function has the return type @code{int} instead of @code{ssize_t}
 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:
index 26fb2022ad1e68ba5b88a8a10b1ffcb89bcc4151..a5a77de082d9a2be1d7a4957ac442289f5d17c13 100644 (file)
@@ -13,8 +13,9 @@ On Windows platforms (excluding Cygwin), @code{select} can only be
 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.
index e3151f71e6548b69f8277bdcbc55fdbba35155e4..72651b0e8022798697db25d35138cdfd77a03343 100644 (file)
@@ -13,9 +13,9 @@ This function has the return type @code{int} instead of @code{ssize_t}
 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:
index fcb3f61c4629aa4276f9b6f051a92efabf581aeb..152c4f093c69f1efeddb55d94df28ec287fe69e2 100644 (file)
@@ -13,9 +13,9 @@ This function has the return type @code{int} instead of @code{ssize_t}
 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:
index 3fe6871d9fb0a33ff7e4f60678de24420132a053..fe2dabda6ace67927b14d996b5a3bdee43a635be 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: setsockopt
 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:
index 1c49142a2660f725142832af8b0b8f263ab04f61..51dea63f82927d6a216251647d5a73852c658491 100644 (file)
@@ -9,9 +9,9 @@ Gnulib module: shutdown
 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:
index a91ebd6d76029ebb6116c4ba4413d16dbe0be6c4..19bb497c239b2fa659da62bd87092251137d6837 100644 (file)
@@ -14,9 +14,9 @@ the @code{socket} function cannot be used in calls to @code{read},
 @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: