[R-pkg-devel] R CMD check package subdirectory warning on filenames

Ben Bolker bbolker at gmail.com
Thu Jun 18 15:14:54 CEST 2015

Hash: SHA1

  It's specific to doc files. In the current version, section 1.4 says:

Documents in inst/doc can be in arbitrary format, however we strongly
recommend providing them in PDF format, so users on almost all
platforms can easily read them. To ensure that they can be accessed
from a browser (as an HTML index is provided), the file names should
start with an ASCII letter and be comprised entirely of ASCII letters
or digits or hyphen or underscore.

  (I didn't know that browsers had trouble accessing file names that
started with a digit?)

  I don't know when this was added ...

  Ben Bolker

On 15-06-18 08:45 AM, Kevin Coombes wrote:
> Hello,
> In putting together my latest package, I'm getting the following
> warning from "R CMD check --as-cran"
> * checking package subdirectories ... WARNING Subdirectory
> 'inst/doc' contains invalid file names: '02oneGeneSims.Rnw'
> '02oneGeneSims.pdf' Please remove or rename the files. See section
> 'Package subdirectories' in the 'Writing R Extensions' manual.
> Having read the recommended section several times and looked
> everywhere I can to read about valid file names, I had a hard time
> figuring out why I was getting this message. Finally, I tried
> removing the "02" from the beginning of the filename, and the
> warning went away.
> I still can't find anyplace in the manual that says "thou shalt
> not start a filename with a digit" or "thou shalt not start a
> filename with the number '0' followed by another digit". In fact,
> the second sentence of the section on Package subdirectories says
> "The code files to be installed must start with an ASCII (lower or
> upper case) letter or digit...."
> [1] Why is this restriction here?
> [2] If the restriction must remain, can the warning message be
> improved so it actually tells you what the problem is? Or points to
> a place in the manual that actually tells you what the problem is?
> [3] Since vignettes get listed in the help pages in alphabetical
> order, does this mean I have to call my vignettes "a.Rnw", "b.Rnw"
> and "c.Rnw" to get them listed in the order I want?
> Kevin
> ______________________________________________ 
> R-package-devel at r-project.org mailing list 
> https://stat.ethz.ch/mailman/listinfo/r-package-devel

Version: GnuPG v1.4.11 (GNU/Linux)


More information about the R-package-devel mailing list