From ligges at statistik.tu-dortmund.de  Thu Sep 23 13:57:25 2010
From: ligges at statistik.tu-dortmund.de (Uwe Ligges)
Date: Thu, 23 Sep 2010 13:57:25 +0200
Subject: [Rd] some problems reported in 00check.log
In-Reply-To: <134458.1267.qm@web62005.mail.re1.yahoo.com>
References: <134458.1267.qm@web62005.mail.re1.yahoo.com>
Message-ID: <4C9B40A5.8070101@statistik.tu-dortmund.de>



On 23.09.2010 09:20, carol white wrote:
> True. A markup command won't be enough to do the job. A function is needed to count the character number (based on the font and size) and if it is greater than the width of the page (based on A4 format or US letter), it will split the line.
>
> Now another question regarding the code in the \examples field: how to keep the same format as the source code because all lines start vertically at the same position? for ex, if I have tab set manually in the source code, it is ignored in the pdf manual file. Do I have to use \tab? How about html help page?
 >
> I have noticed that there is one file 00Index.html in html folder. I didn't have any error message when I ran R CMD check and build. But it seems that other html files missing. How to repair?

If this is R > 2.10.0, it is expected. Static html files are not 
generated upon installation any more. Contents is generated dynamically 
upon request now.


> when I ran R CMD check, the pdf manual file was created in one level up the package folder. I moved it to help folder. How to set options so that  it will be created in the help folder?

The pdf manual is not part of a binary package. A user can ask R to 
generate the manual or parts of it. The manual will so be generated by 
CRAN, for example.


Uwe Ligges




>
> thanks,
>
> --- On Wed, 9/22/10, Prof Brian Ripley<ripley at stats.ox.ac.uk>  wrote:
>
>> From: Prof Brian Ripley<ripley at stats.ox.ac.uk>
>> Subject: Re: [Rd] some problems reported in 00check.log
>> To: "carol white"<wht_crl at yahoo.com>
>> Cc: "Uwe Ligges"<ligges at statistik.tu-dortmund.de>, r-devel at r-project.org
>> Date: Wednesday, September 22, 2010, 5:04 AM
>> On Wed, 22 Sep 2010, carol white
>> wrote:
>>
>>> So there is no sort of automatic way like using a
>> markup command for the susceptible fields instead of
>> splitting manually a line on different lines?
>>
>> Well, how is the automatic command to know how to do
>> this?  As you
>> will see from the autmatic wrapping in e.g. deparse(), we
>> are not able
>> to do a very good job.
>>
>> There has been some talk about doing this automatically as
>> a backstop,
>> but I don't know the current state: in any case it does not
>> happen in
>> released versions of R.
>>
>>> True that this doesn't happen in Arguments field (I
>> confused with
>>> Format field).
>>>
>>> Also true that the codes used in Usage, Examples etc
>> are in
>>> courrier. Is there any way to reduce the size and not
>> to change the
>>> font of character for these fields?
>>
>> You can change Rd.sty, which already contains options for
>> using
>> other fontsets.
>>
>>>
>>> Best,
>>>
>>> Carol
>>>
>>> --- On Wed, 9/22/10, Prof Brian Ripley<ripley at stats.ox.ac.uk>
>> wrote:
>>>
>>>> From: Prof Brian Ripley<ripley at stats.ox.ac.uk>
>>>> Subject: Re: [Rd] some problems reported in
>> 00check.log
>>>> To: "carol white"<wht_crl at yahoo.com>
>>>> Cc: "Uwe Ligges"<ligges at statistik.tu-dortmund.de>,
>> r-devel at r-project.org
>>>> Date: Wednesday, September 22, 2010, 2:15 AM
>>>> On Wed, 22 Sep 2010, carol white
>>>> wrote:
>>>>
>>>>> Thank you very much Uwe. It works now.
>>>>>
>>>>> I have a question about pdf formating in pdf
>> manual
>>>> file:
>>>>>
>>>>> How to format the long lines which go to the
>> margin?
>>>> For ex, this happens in Usage field if a function
>> has many
>>>> arguments. Also, it happens in examples or
>> Arugment sections
>>>> when the lines are long.
>>>>
>>>> Correct the sources by re-formatting over-long
>> lines
>>>> yourself.  (This should only happen in
>> verbatim-like
>>>> sections, hence unlikely to happen in
>> \argument{}.)
>>>>
>>>> One of the things we suggest when checking a
>> package is to
>>>> read through the PDF manual, and this is one of
>> the problems
>>>> to look out for.  (Note that it does depend on
>> the
>>>> fonts used for the PDF, but the default Courier
>> for
>>>> monospaced text is somewhat wide.)
>>>>
>>>> -- Brian D. Ripley,
>>>>          ripley at stats.ox.ac.uk
>>>> Professor of Applied Statistics,  http://www.stats.ox.ac.uk/~ripley/
>>>> University of Oxford,
>>>>     Tel:  +44 1865 272861 (self)
>>>> 1 South Parks Road,
>>>>             +44 1865
>>>> 272866 (PA)
>>>> Oxford OX1 3TG, UK
>>>>      Fax:  +44 1865 272595
>>>>
>>>
>>>
>>>
>>>
>>
>> --
>> Brian D. Ripley,
>>        ripley at stats.ox.ac.uk
>> Professor of Applied Statistics,  http://www.stats.ox.ac.uk/~ripley/
>> University of Oxford,
>>     Tel:  +44 1865 272861 (self)
>> 1 South Parks Road,
>>             +44 1865
>> 272866 (PA)
>> Oxford OX1 3TG, UK
>>      Fax:  +44 1865 272595
>
>
>



[Rd] some problems reported in 00check.log
Uwe Ligges