From dbc61a5038cacc516a49d00a59a669e2617cff51 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Thu, 18 Jun 2020 19:19:06 -0700 Subject: Language cleanups in the documentation. Mostly this is removal of the smart quotes, which were over-used, and misused, and could have been mistaken to be pejorative. A few other minor nits were fixed while here. --- docs/man/nng.7.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs/man/nng.7.adoc') diff --git a/docs/man/nng.7.adoc b/docs/man/nng.7.adoc index 88c0266a..8511bdb0 100644 --- a/docs/man/nng.7.adoc +++ b/docs/man/nng.7.adoc @@ -102,10 +102,10 @@ messages may be dropped or reordered (Some protocols, such as xref:nng_req.7.adoc[_req_] may offer stronger guarantees by performing their own retry and validation schemes.) -Each socket can have zero, one, or many "endpoints", which are either +Each socket can have zero, one, or many endpoints, which are either _listeners_ or _dialers_. (A given socket may freely choose whether it uses listeners, dialers, or both.) -These "`endpoints`" provide access to underlying transports, such as TCP, etc. +These endpoints provide access to underlying transports, such as TCP, etc. Each endpoint is associated with a URL, which is a service address. For dialers, this will be the service address that will be contacted, whereas @@ -131,7 +131,7 @@ other than in a few specific circumstances. ==== Raw Mode (((cooked mode)))(((raw mode))) -Most applications will use _nng_ sockets in "`cooked`" mode. +Most applications will use _nng_ sockets in normal, or _cooked_, mode. This mode provides the full semantics of the protocol. For example, xref:nng_req.7.adoc[_req_] sockets will automatically match a reply to a request, and resend requests periodically if no reply @@ -140,7 +140,7 @@ was received. There are situations, such as with xref:nng_device.3.adoc[proxies], where it is desirable to bypass these semantics and simply pass messages to and from the socket with no extra semantic handling. -This is possible using "`raw`" mode sockets. +This is possible using _raw_ mode sockets. Raw mode sockets are generally constructed with a different function, such as xref:nng_req_open.3.adoc[`nng_req0_open_raw()`]. -- cgit v1.2.3-70-g09d2