Re: [Rd] Title case in DESCRIPTION for package where a word is a function name
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. JN 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. Best, Uwe Ligges Ben Bolker __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] Title case in DESCRIPTION for package where a word is a function name
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. Best, Uwe Ligges Ben Bolker __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] Title case in DESCRIPTION for package where a word is a function name
Uwe Ligges ligges at statistik.tu-dortmund.de writes: 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. Best, Uwe Ligges Does this then constitute a bug in the package-checking code? With a just-updated R-devel, for a test case I get: The Title field should be in title case, current version then in title case: ‘Support Functions and Data for Ecological Models and Data plus 'optim()'’ ‘Support Functions and Data for Ecological Models and Data Plus 'Optim()'’ (while I'm nit-picking, I will say that the first time I got a version of this error a few weeks ago, it took me two or three tries to parse what ..., current version then in title case meant. It is perfectly correct, I just found it really hard to understand ...) cheers Ben Bolker __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] Title case in DESCRIPTION for package where a word is a function name
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. It is A Replacement and Extension of the optim() Function R CMD check suggests the incorrect form A Replacement and Extension of the Optim() Function 'Writing R Extensions' suggests single quotes, i.e., A Replacement and Extension of the 'optim()' Function which R CMD check still complains about. 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. On a related matter, I'm finding the reverse dependency check for optimx takes a very long time and sometimes stalls for reasons I have not yet sorted out. I run it in virtual machines for R3.2 and R-devel. Possibly optimx needs so many packages I'm hitting memory or disk limits. Perhaps off-list discussion could suggest a way to set up a reverse check server. I'd be willing to help on such a project, which might be helpful for many developers. JN __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] Title case in DESCRIPTION for package where a word is a function name
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 ... Ben Bolker __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel