[Rd] Title case in DESCRIPTION for package where a word is a function name
Prof J C Nash (U30A)
nashjc at uottawa.ca
Sat Apr 25 13:11:47 CEST 2015
Hendrik pointed out it was the parentheses that gave the complaint.
Single quotes and no parentheses seem to satisfy R CMD check. Perhaps
that needs to be in the WRE.
However, I have for some time used the parentheses to distinguish
functions from packages. optim() is a function, optimx a package.
Is this something CRAN should be thinking about? I would argue greater
benefit to users than title case.
On 15-04-24 06:17 PM, Uwe Ligges wrote:
> On 24.04.2015 22:44, Ben Bolker wrote:
>> Prof J C Nash (U30A <nashjc <at> uottawa.ca> writes:
>>> I was preparing a fix for a minor glitch in my optimx package and R CMD
>>> check gave an error that the title was not in title case.
>> [snip] to make Gmane happy ...
>>> I have found
>>> A Replacement and Extension of the _optim()_ Function
>>> does not get the complaint, but I'm not sure the underscore is allowed.
>>> Given that I've obeyed the RTFM rule, I'm wondering what to do now.
>> Presumably you should ask the CRAN maintainers? That seems to
>> be the only possible answer -- I don't think anyone else can guess
>> very accurately ...
> From WRE:
> "Refer to other packages and external software in single quotes, and to
> book titles (and similar) in double quotes."
> Other non-English usage (as documented for the Description field; this
> inlcudes function names) can also be used in single quotes.
> Uwe Ligges
>> Ben Bolker
>> R-devel at r-project.org mailing list
More information about the R-devel