[R] [FORGED] Re: [FORGED] Re: identical() versus sapply()
r.turner at auckland.ac.nz
Tue Apr 12 05:34:54 CEST 2016
On 12/04/16 14:45, Duncan Murdoch wrote:
> On 11/04/2016 10:18 PM, Bert Gunter wrote:
>> "The documentation aims to be accurate, not necessarily clear."
>> I hope that is not the case! Accurate documentation that is confusing
>> is not very useful.
> I don't think it is ever intentionally confusing, but it is often
> concise to the point of obscurity. Words are chosen carefully, and
> explanations are not repeated. It takes an effort to read it. It will
> be clear to careful readers, but not to all readers.
> I was thinking of the statement quoted earlier, 'as(x, "numeric") uses
> the existing as.numeric function'. That is different than saying 'as(x,
> "numeric") is the same as as.numeric(x)'.
IMHO this is so *obviously* confusing and misleading --- even though it
is technically correct --- that whoever wrote it was either
intentionally trying to be confusing or is unbelievably obtuse and/or
out of touch with reality.
It is not (again IMHO) clear even to *very* careful readers.
To my mind this documentation fails even the fortune(350) test.
Technical Editor ANZJS
Department of Statistics
University of Auckland
Phone: +64-9-373-7599 ext. 88276
More information about the R-help