Re: [Rd] base R pipe documentation

2021-05-18 Thread Bill Dunlap
It would be nice to have "|>" listed in the precedence table in
help(Syntax).  I think it has the same precedence as "%any%" and both are
left-associative.
  > quote( a |> f1() %any% f2())
  f1(a) %any% f2()
  > quote( a %any% f1() |> f2())
  f2(a %any% f1())

help(`|>`) does mention magrittr's pipe operator so the user can compare
and contrast them.

-Bill

On Mon, May 17, 2021 at 10:20 AM Ben Bolker  wrote:

>As of right now, as far as I can tell, the documentation for the new
> native |> pipe still says that it's experimental.
>
>
> https://github.com/wch/r-source/blob/trunk/src/library/base/man/pipeOp.Rd#L45
>
>   *Pipe support is experimental and may change prior to release.*
>
> Also still in the 4-1 branch:
>
>
> https://github.com/wch/r-source/blob/R-4-1-branch/src/library/base/man/pipeOp.Rd#L45
>
>(The corresponding comment in the NEWS file has been fixed in the
> last 24 hours, but hasn't propagated to the online/HTML version on the
> developer page yet ...)
>
>As a "wish list" item, if there are any particularly
> salient/important  differences between the |> pipe and the %>% magrittr
> pipe, it would be great to have those documented (I know that
> documenting the difference between a base-R operator and the one that's
> implemented in a non-Recommended package is a little weird, but it would
> be helpful in this case ...)  I know I could go back to the mailing list
> discussion at
> https://hypatia.math.ethz.ch/pipermail/r-devel/2020-December/080173.html
> and try to figure it out for myself ...
>
>cheers
> Ben Bolker
>
> __
> R-devel@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel
>

[[alternative HTML version deleted]]

__
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel


Re: [Rd] base R pipe documentation

2021-05-17 Thread peter dalgaard
OK, zapped the \note for 4-1-branch (for now). This close to release, changes 
have to be very small and safe to be allowed in, so anything more than that 
will have to wait for a later version.

- Peter

> On 17 May 2021, at 19:20 , Ben Bolker  wrote:
> 
>  As of right now, as far as I can tell, the documentation for the new native 
> |> pipe still says that it's experimental.
> 
> https://github.com/wch/r-source/blob/trunk/src/library/base/man/pipeOp.Rd#L45
> 
> *Pipe support is experimental and may change prior to release.*
> 
> Also still in the 4-1 branch:
> 
> https://github.com/wch/r-source/blob/R-4-1-branch/src/library/base/man/pipeOp.Rd#L45
> 
>  (The corresponding comment in the NEWS file has been fixed in the last 24 
> hours, but hasn't propagated to the online/HTML version on the developer page 
> yet ...)
> 
>  As a "wish list" item, if there are any particularly salient/important  
> differences between the |> pipe and the %>% magrittr pipe, it would be great 
> to have those documented (I know that documenting the difference between a 
> base-R operator and the one that's implemented in a non-Recommended package 
> is a little weird, but it would be helpful in this case ...)  I know I could 
> go back to the mailing list discussion at 
> https://hypatia.math.ethz.ch/pipermail/r-devel/2020-December/080173.html and 
> try to figure it out for myself ...
> 
>  cheers
>   Ben Bolker
> 
> __
> R-devel@r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel

-- 
Peter Dalgaard, Professor,
Center for Statistics, Copenhagen Business School
Solbjerg Plads 3, 2000 Frederiksberg, Denmark
Phone: (+45)38153501
Office: A 4.23
Email: pd@cbs.dk  Priv: pda...@gmail.com

__
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel


[Rd] base R pipe documentation

2021-05-17 Thread Ben Bolker
  As of right now, as far as I can tell, the documentation for the new 
native |> pipe still says that it's experimental.


https://github.com/wch/r-source/blob/trunk/src/library/base/man/pipeOp.Rd#L45

 *Pipe support is experimental and may change prior to release.*

Also still in the 4-1 branch:

https://github.com/wch/r-source/blob/R-4-1-branch/src/library/base/man/pipeOp.Rd#L45

  (The corresponding comment in the NEWS file has been fixed in the 
last 24 hours, but hasn't propagated to the online/HTML version on the 
developer page yet ...)


  As a "wish list" item, if there are any particularly 
salient/important  differences between the |> pipe and the %>% magrittr 
pipe, it would be great to have those documented (I know that 
documenting the difference between a base-R operator and the one that's 
implemented in a non-Recommended package is a little weird, but it would 
be helpful in this case ...)  I know I could go back to the mailing list 
discussion at 
https://hypatia.math.ethz.ch/pipermail/r-devel/2020-December/080173.html 
and try to figure it out for myself ...


  cheers
   Ben Bolker

__
R-devel@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel