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

[Duncan Murdoch]

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