From c270253d61706c1e0229e58cd2ce76b49890612c Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sun, 6 Jan 2019 18:10:32 -0800 Subject: fixes #854 Various minor corrections to TCP man pages --- docs/man/nng_tcp_dialer_close.3tcp.adoc | 5 ++--- docs/man/nng_tcp_dialer_free.3tcp.adoc | 3 +-- docs/man/nng_tcp_listener.5.adoc | 6 +++--- docs/man/nng_tcp_listener_accept.3tcp.adoc | 5 ++--- docs/man/nng_tcp_listener_close.3tcp.adoc | 7 +++---- docs/man/nng_tcp_listener_free.3tcp.adoc | 3 +-- docs/man/nng_tcp_listener_setopt.3tcp.adoc | 1 - docs/man/nng_tcp_setopt.3tcp.adoc | 2 +- 8 files changed, 13 insertions(+), 19 deletions(-) (limited to 'docs') diff --git a/docs/man/nng_tcp_dialer_close.3tcp.adoc b/docs/man/nng_tcp_dialer_close.3tcp.adoc index 94b720d5..b325a3a0 100644 --- a/docs/man/nng_tcp_dialer_close.3tcp.adoc +++ b/docs/man/nng_tcp_dialer_close.3tcp.adoc @@ -28,8 +28,7 @@ void nng_tcp_dialer_close(nng_tcp_dialer *d); The `nng_tcp_dialer_close()` function closes the supplied TCP dialer _d_, but does not free the underlying resources associated with it. -If any dial operations -(see `<>`) using _d_ are +If any <> operations using _d_ are in progress, they will be terminated with an `NNG_ECLOSED` error condition. Furthermore any future accesses to the dialer _d_ will also result in @@ -37,7 +36,7 @@ Furthermore any future accesses to the dialer _d_ will also result in NOTE: This function does not release the memory for the dialer, so the application should still free the memory using -`<>` +<> once it is certain that nothing else is using it. == RETURN VALUES diff --git a/docs/man/nng_tcp_dialer_free.3tcp.adoc b/docs/man/nng_tcp_dialer_free.3tcp.adoc index 3116ad8e..7b15fc39 100644 --- a/docs/man/nng_tcp_dialer_free.3tcp.adoc +++ b/docs/man/nng_tcp_dialer_free.3tcp.adoc @@ -28,8 +28,7 @@ void nng_tcp_dialer_free(nng_tcp_dialer *d); The `nng_tcp_dialer_free()` function closes the supplied TCP dialer _d_, and frees the underlying resources associated with it. -If any dial operations -(see `<>`) using _d_ are +If any <> operations using _d_ are in progress, they will be terminated with an `NNG_ECLOSED` error condition. WARNING: It is important that the application ensure that no further accesses diff --git a/docs/man/nng_tcp_listener.5.adoc b/docs/man/nng_tcp_listener.5.adoc index 851ff2fa..f616d321 100644 --- a/docs/man/nng_tcp_listener.5.adoc +++ b/docs/man/nng_tcp_listener.5.adoc @@ -1,6 +1,6 @@ = nng_tcp_listener(5) // -// Copyright 2018 Staysail Systems, Inc. +// Copyright 2019 Staysail Systems, Inc. // Copyright 2018 Capitar IT Group BV // // This document is supplied under the terms of the MIT License, a @@ -27,7 +27,7 @@ typedef struct nng_tcp_dialer_s nng_tcp_dialer; (((TCP, listener))) An `nng_tcp_listener` is a handle to a TCP "`listener`", which is responsible -for accepting connections (`<>` objects) from remote +for accepting connections (<> objects) from remote systems. NOTE: The `nng_tcp_listener` object is used for raw TCP connections, and @@ -35,7 +35,7 @@ should not be confused with a listener object created using the <> transport. TIP: Most NNG applications should not use this, but instead use the -`<>` transport instead. +<> transport instead. == SEE ALSO diff --git a/docs/man/nng_tcp_listener_accept.3tcp.adoc b/docs/man/nng_tcp_listener_accept.3tcp.adoc index b7391851..e0c5f27b 100644 --- a/docs/man/nng_tcp_listener_accept.3tcp.adoc +++ b/docs/man/nng_tcp_listener_accept.3tcp.adoc @@ -30,8 +30,7 @@ from a remote peer, using the listener _l_. The operation is completed asynchronously, using _aio_. This operation can only be done after the listener is already bound to -a TCP port and is listening. -(See `<>`.) +a TCP port and is <>. If a connection is successfully established, the _aio_ will have the resulting `<>` stored as its first output. @@ -50,7 +49,7 @@ None. [horizontal] `NNG_ECANCELED`:: The operation was aborted. -`NNG_ECLOSED`:: The dialer is closed. +`NNG_ECLOSED`:: The listener is closed. `NNG_ECONNRESET`:: The TCP connection was reset by the peer. `NNG_ENOMEM`:: Insufficient free memory exists. `NNG_ESTATE`:: The listener is not not listening. diff --git a/docs/man/nng_tcp_listener_close.3tcp.adoc b/docs/man/nng_tcp_listener_close.3tcp.adoc index 57b7088e..a85d3675 100644 --- a/docs/man/nng_tcp_listener_close.3tcp.adoc +++ b/docs/man/nng_tcp_listener_close.3tcp.adoc @@ -1,6 +1,6 @@ = nng_tcp_listener_close(3tcp) // -// Copyright 2018 Staysail Systems, Inc. +// Copyright 2019 Staysail Systems, Inc. // Copyright 2018 Capitar IT Group BV // // This document is supplied under the terms of the MIT License, a @@ -28,8 +28,7 @@ void nng_tcp_listener_close(nng_tcp_listener *l); The `nng_tcp_listener_close()` function closes the supplied TCP listener _l_, but does not free the underlying resources associated with it. -If any acceppt operations -(see `<>`) using _l_ +If any <> operations using _l_ are in progress, they will be terminated with an `NNG_ECLOSED` error condition. Furthermore any future accesses to the listener _l_ will also result in @@ -37,7 +36,7 @@ Furthermore any future accesses to the listener _l_ will also result in NOTE: This function does not release the memory for the listener, so the application should still free the memory using -`<>` +<> once it is certain that nothing else is using it. == RETURN VALUES diff --git a/docs/man/nng_tcp_listener_free.3tcp.adoc b/docs/man/nng_tcp_listener_free.3tcp.adoc index cd37935c..a91a67b4 100644 --- a/docs/man/nng_tcp_listener_free.3tcp.adoc +++ b/docs/man/nng_tcp_listener_free.3tcp.adoc @@ -28,8 +28,7 @@ void nng_tcp_listener_free(nng_tcp_listener *l); The `nng_tcp_listener_free()` function closes the supplied TCP listener _l_, and frees the underlying resources associated with it. -If any accept operations -(see `<>`) using _l_ +If any <> operations using _l_ are in progress, they will be terminated with an `NNG_ECLOSED` error condition. WARNING: It is important that the application ensure that no further accesses diff --git a/docs/man/nng_tcp_listener_setopt.3tcp.adoc b/docs/man/nng_tcp_listener_setopt.3tcp.adoc index 4cf1297a..15aa4e1f 100644 --- a/docs/man/nng_tcp_listener_setopt.3tcp.adoc +++ b/docs/man/nng_tcp_listener_setopt.3tcp.adoc @@ -35,7 +35,6 @@ in length. The options specifically suppported for modification on TCP listeners are: -* <> * <> * <> diff --git a/docs/man/nng_tcp_setopt.3tcp.adoc b/docs/man/nng_tcp_setopt.3tcp.adoc index 35b6597c..9debd3ef 100644 --- a/docs/man/nng_tcp_setopt.3tcp.adoc +++ b/docs/man/nng_tcp_setopt.3tcp.adoc @@ -27,7 +27,7 @@ int nng_tcp_setopt(nng_tcp *conn, const char *name, const void *data, size_t siz == DESCRIPTION The `nng_tcp_setopt()` is used to set the option _name_ for the -<> _conn_. +<> _conn_. The value to set is copied from _data_, which should be _size_ bytes in length. -- cgit v1.2.3-70-g09d2