From m@ech|er @end|ng |rom @t@t@m@th@ethz@ch  Thu Aug  4 16:03:24 2022
From: m@ech|er @end|ng |rom @t@t@m@th@ethz@ch (Martin Maechler)
Date: Thu, 4 Aug 2022 16:03:24 +0200
Subject: [Rd] Minor error in ?cbind
In-Reply-To: <c6ce8ca6-ff8f-4420-4c2a-200fb244356c@stats.uwo.ca>
References: <c6ce8ca6-ff8f-4420-4c2a-200fb244356c@stats.uwo.ca>
Message-ID: <25323.53676.470465.743476@stat.math.ethz.ch>

>>>>> Duncan Murdoch 
>>>>>     on Thu, 4 Aug 2022 08:48:06 -0400 writes:

    > The help for rbind() and cbind() says in the text that the
    > default for deparse.level is 0, when in fact it is 1.?

Well, that's not what is meant by the current text.
Note that ";" is semantically almost a ".", and I have always read

     \code{deparse.level = 0} constructs no labels; the default,\cr
     \code{deparse.level = 1 or 2} constructs labels from the argument
     names, see the \sQuote{Value} section below.

as

     'deparse.level = 0' constructs no labels; 
     the default, 'deparse.level = 1 or 2' constructs labels from the argument
     names, see the _Value_ section below.

so *not* as claiming that the default is deparse.level=0.
But you are right that the current phrasing should be changed to
be more clear.  I would like to keep mentioning the default in the
\arguments{} part, and only change that, e.g., to

     \code{deparse.level = 0} constructs no labels; 
     the default \code{deparse.level = 1} typically and
     \code{deparse.level = 2} always construct labels from the argument
     names, see the \sQuote{Value} section below.

WDYT ?


    > Here's a patch to fix it.

    > Duncan Murdoch



[Rd] Minor error in ?cbind
Martin Maechler