From murdoch at stats.uwo.ca  Fri Jun 26 13:10:30 2009
From: murdoch at stats.uwo.ca (Duncan Murdoch)
Date: Fri, 26 Jun 2009 07:10:30 -0400
Subject: [Rd] Rd: pdf manual: package information not on first page
In-Reply-To: <4A4476D1.4090904@sbox.tugraz.at>
References: <4A43AFEC.30901@sbox.tugraz.at> <4A440C41.60602@stats.uwo.ca>
	<4A4476D1.4090904@sbox.tugraz.at>
Message-ID: <4A44ACA6.3050206@stats.uwo.ca>

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



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