Bug 15312 - Contradictory documentation re. deprecation of 'representation' in setClass() in R 3.0.0
Contradictory documentation re. deprecation of 'representation' in setClass()...
Status: RESOLVED FIXED
Product: R
Classification: Unclassified
Component: Documentation
R 3.0.0
x86_64/x64/amd64 (64-bit) Linux
: P5 minor
Assigned To: R-core
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2013-05-16 00:52 UTC by Tom Wainwright
Modified: 2013-05-16 18:53 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tom Wainwright 2013-05-16 00:52:23 UTC
In R version 3.0.0 (2013-04-03) -- "Masked Marvel":

Documentation for "setClass {methods}" contains the statement:

S3methods, representation, access, version: All these arguments are deprecated from version 3.0.0 of R and should be avoided.

However, the documentation for "representation {methods}" still recommends it's use and makes no mention of deprecation:

Description: In calls to setClass, these two functions construct, respectively, the representation and prototype arguments. They do various checks and handle special cases. You're encouraged to use them ...

Minor problem, but confusing.
Comment 1 John Chambers 2013-05-16 18:53:23 UTC
Fixed in r-devel and 3.0.1-patched.  There was also a leftover recommendation in the ?setClass documentation.  We don't want the function to be deprecated, since there is nothing wrong with it, just an improved readability for new code with slots= instead.