[Rd] some problems reported in 00check.log

[carol white]

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?

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? 

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