further docs cleanups

Author: shikokuchuo

NEWS.md

@@ -7,8 +7,8 @@
 
 #### Updates
 
-* Unified synchronous `send()` and `recv()` functions, and their asynchronous counterparts `send_aio()` and `recv_aio()`, are now S3 generics and can be used across Sockets, Contexts and Streams.
-* Revised 'block' argument for synchronous `send()` and `recv()` allows setting a timeout for all methods.
+* Unified `send()` and `recv()` functions, and their asynchronous counterparts `send_aio()` and `recv_aio()`, are now S3 generics and can be used across Sockets, Contexts and Streams.
+* Revised 'block' argument for `send()` and `recv()` now allows an integer value for setting a timeout.
 * `send_ctx()` and `recv_ctx()` are deprecated and will be removed in a future package version - the methods for `send()` and `recv()` should be used instead.
 
 # nanonext 0.3.0

R/sendrecv.R

@@ -136,14 +136,18 @@ send.nanoStream <- function(con,
 #'
 #' Receive data over a connection (Socket, Context or Stream).
 #'
-#' @inheritParams send
+#' @param con a Socket, Context or Stream.
 #' @param mode <Sockets and Contexts> [default 'serial'] mode of vector to be
 #'     received - one of 'serial', 'character', 'complex', 'double', 'integer',
 #'     'logical', 'numeric', or 'raw'. The default 'serial' means a serialised
 #'     R object, for the other modes, the raw vector received will be converted
 #'     into the respective mode.
 #'     <Streams> [default 'character'] note that 'serial' is not an option for
 #'     Streams.
+#' @param block logical TRUE to block until successful or FALSE to return
+#'     immediately even if unsuccessful  (e.g. if no messages are available),
+#'     or else an integer value specifying the maximum time to block in
+#'     milliseconds, after which the operation will time out.
 #' @param keep.raw [default TRUE] logical flag whether to keep the received raw
 #'     vector (useful for verification e.g. via hashing). If FALSE, will return
 #'     the converted data only.