[Rd] question about assignment warnings for replacement methods

[Marc Carlson]

Hi,

I have seen several packages that with the most recent version of R are 
giving a warning like this:

Assignments in \usage in documentation object 'marginalData-methods':
marginalData(object) = value

I assume that this is to prevent people from making assignments in their 
usage statements (which seems completely understandable).  But what 
about the case above?  This is a person who just wants to show the 
proper usage for a replacement method.  IOW they just want to write 
something that looks like what you actually do when you use a 
replacement method.  They just want to show users how to do something 
like this:

replacementMethod(object) <- newValue


So is that really something that should not be allowed in a usage 
statement?


   Marc