mention .() more places

rebuild and recheck

Author: JohnMount

DESCRIPTION

@@ -2,7 +2,7 @@ Package: wrapr
 Type: Package
 Title: Wrap R Tools for Debugging and Parametric Programming
 Version: 1.9.1
-Date: 2019-10-04
+Date: 2019-10-05
 Authors@R: c(
     person("John", "Mount", email = "[email protected]", role = c("aut", "cre")),
     person("Nina", "Zumel", email = "[email protected]", role = c("aut")),

NEWS.md

@@ -1,5 +1,5 @@
 
-# wrapr 1.9.1 2019-10-04
+# wrapr 1.9.1 2019-10-05
 
  * Fix locum composite line printing.
  * Document .()-escaping in pipe.

R/bpipe.R

@@ -505,6 +505,12 @@ pipe_impl <- function(pipe_left_arg,
 #' cos(exp(sin(4)))
 #' 4 %.>% sin(.) %.>% exp(.) %.>% cos(.)
 #'
+#' f <- function() { sin }
+#' # returns f() ignoring dot, not what we want
+#' 5 %.>% f()
+#' # evaluates f() early then evaluates result with .-substitution rules
+#' 5 %.>% .(f())
+#'
 #' @name dot_arrow
 NULL
 

README.md

@@ -239,6 +239,16 @@ Checks and transforms are not performed on items inside braces (example:
 
 </li>
 
+<li>
+
+The dot arrow pipe has S3/S4 dispatch (please see ). However as the
+right-hand side of the pipe is normally held unevaluated, we don’t know
+the type except in special cases (such as the rigth-hand side being
+referred to by a name or variable). To force the evaluation of a pipe
+term, simply wrap it in `.()`.
+
+</li>
+
 </ul>
 
 The dot pipe is also user configurable through standard `S3`/`S4`