[Rd] Rd: pdf manual: package information not on first page

Duncan Murdoch murdoch at stats.uwo.ca
Fri Jun 26 13:10:30 CEST 2009


Thorn Thaler wrote:
> Duncan Murdoch schrieb:
>   
>>> So my question is, if there is any possibility to get the package 
>>> documentation on the first page?
>>>       
>> That's where it is supposed to be.  Could you look for errors in the one 
>> where it comes last?  If you can't spot anything, you could send me the 
>> tar.gz version of it and I'll take a look.
>>     
>
> Hmm, "R CMD check" works fine without any problems. Are there any 
> further checks I could perform? As pointed out by another reader of this 
> list, could it, however, be an alphabetical issue? The name of the 
> package with the information correctly on the first page starts with an 
> upper case letter, while the other one doesn't. If upper case letters 
> are supposed to come before lower case letters in the ordering, all 
> would make sense. It would not be what I would like to have though. ;)
>
> While writing these lines I investigated this behaviour and added a 
> documentation file for function 'AAA' to see where it will be printed in 
> the manual for the package starting with an upper case letter. And as 
> presumed it was put on the very first page. So I think that R internally 
> orders all documentation files, in doing so all documentation files 
> starting with an upper case take precedence over those starting with a 
> lower case letter.
>
> This behaviour is somehow odd, though, a workaround would be of course 
> to rename the documentation file for the package as 
> "00-<package-name>-package.Rd" to assure that it will come first in the 
> manual.
>
> Is this behaviour intentional or is it a bug?

How did you produce the manual?  When I do R CMD Rd2dvi on a package, I 
get the package man page first.  There are other ways to produce the 
manual, and in some cases we may not control the sort order.

Duncan Murdoch



More information about the R-devel mailing list