nextmode -> next_config

Author: shikokuchuo

DESCRIPTION

@@ -1,7 +1,7 @@
 Package: nanonext
 Type: Package
 Title: NNG (Nanomsg Next Gen) Lightweight Messaging Library
-Version: 0.10.4.9025
+Version: 0.10.4.9026
 Description: R binding for NNG (Nanomsg Next Gen), a successor to ZeroMQ. NNG is
     a socket library implementing 'Scalability Protocols', a reliable,
     high-performance standard for common communications patterns including

NAMESPACE

@@ -63,7 +63,7 @@ export(nano)
 export(ncurl)
 export(ncurl_aio)
 export(ncurl_session)
-export(nextmode)
+export(next_config)
 export(nng_error)
 export(nng_version)
 export(opt)

NEWS.md

@@ -1,4 +1,4 @@
-# nanonext 0.10.4.9025
+# nanonext 0.10.4.9026
 
 *This is a major stability release bundling the 'libnng' v1.6.0 source code.*
 
@@ -11,8 +11,8 @@
 #### Updates
 
 * `until()` updated to be identical to `.until()`, returning FALSE instead of TRUE if the timeout has been reached.
-* `nextmode()` improvements:
-  + simplified function signature to take a 'refhook' argument comprising a list of serialization / unserialization functions.
+* `next_config()` replaces `nextmode()` with the following improvements:
+  + simplified 'refhook' argument takes a pair of serialization and unserialization functions as a list.
   + registered 'refhook' functions apply to external pointer type objects only.
   + no longer returns invisibly for easier confimation that the correct functions have been registered.
 * `reap()` updated to no longer warn in cases it returns an 'errorValue'.

R/sendrecv.R

@@ -64,10 +64,10 @@
 #'     corresponding to the vector sent should be used.
 #'
 #'     Mode 'next' sends serialised R objects, with native extensions enabled by
-#'     \code{\link{nextmode}}. This allows custom serialization and
-#'     unserialization functions to be registered for objects accessed via an
-#'     external pointer. When receiving, mode 'serial' should be used as 'next'
-#'     sends are fully compatible.
+#'     \code{\link{next_config}}. This configures custom serialization and
+#'     unserialization functions for external pointer type objects. When
+#'     receiving, mode 'serial' should be used as 'next' sends are fully
+#'     compatible.
 #'
 #' @seealso \code{\link{send_aio}} for asynchronous send.
 #' @examples

R/utils.R

@@ -275,7 +275,7 @@ status_code <- function(x) .Call(rnng_status_code, x)
 #'
 strcat <- function(a, b) .Call(rnng_strcat, a, b)
 
-#' Next Mode Settings
+#' Configure Next Mode
 #'
 #' Configures send mode 'next' by registering functions for custom serialization
 #'     and unserialization of external pointer objects, allowing these to be
@@ -295,14 +295,15 @@ strcat <- function(a, b) .Call(rnng_strcat, a, b)
 #'     currently-registered 'refhook' functions (and resets 'mark' to FALSE).
 #'
 #' @examples
-#' nextmode(refhook = list(function(x) serialize(x, NULL), unserialize),
-#'          mark = TRUE)
-#' nextmode()
+#' g <- next_config(refhook = list(function(x) serialize(x, NULL), unserialize),
+#'                  mark = TRUE)
+#' next_config()
+#' next_config(g)
 #'
-#' nextmode(NULL)
-#' nextmode()
+#' next_config(NULL)
+#' next_config()
 #'
 #' @export
 #'
-nextmode <- function(refhook = list(), mark = FALSE)
-  .Call(rnng_next_mode, refhook, mark)
+next_config <- function(refhook = list(), mark = FALSE)
+  .Call(rnng_next_config, refhook, mark)