[R] Problems getting html files out of R CMD check

[Duncan Murdoch]

On 14/03/2011 8:29 AM, Amos Folarin wrote:
> On 14 March 2011 11:43, Duncan Murdoch<murdoch.duncan at gmail.com>  wrote:
>
> >  On 11-03-14 7:32 AM, Amos Folarin wrote:
> >
> >>
> >>>  ---------- Forwarded message ----------
> >>>  From: Duncan Murdoch<murdoch.duncan at gmail.com>
> >>>  To: Amos Folarin<amosfolarin at gmail.com>
> >>>  Date: Sun, 13 Mar 2011 20:53:57 -0400
> >>>  Subject: Re: [R] Problems getting html files out of R CMD check
> >>>  On 11-03-13 7:14 PM, Amos Folarin wrote:
> >>>
> >>>   Hi,
> >>>>
> >>>>  I'm trying to R CMD check a package, however I have hit a snag. There
> >>>>  seems
> >>>>  to be a problem with the creation of the /html files (the only file
> >>>>  that's
> >>>>  constructed here is the 00Index.html). I've tested each of the .Rd files
> >>>>  independently with R CMD Rdconv, they all happily create html files
> >>>>  without
> >>>>  complaint.
> >>>>
> >>>>
> >>>  R doesn't build .html files any more unless you ask it to explicitly,
> >>>  e.g.
> >>>  using R CMD Rdconv.
> >>>
> >>>  Duncan Murdoch
> >>>
> >>>
> >>
> >>
> >>  Thanks Duncan, I guess much of the documentation "out there" still
> >>  indicate
> >>  this functionality.
> >>
> >
> >  If it's R Project documentation, you should tell us about it, and we'll fix
> >  it.  If you're finding it on a third party website, consider it a warning
> >  about the reliability of the source.
> >
> >  Duncan Murdoch
> >
>
> Yes, I stand warned. But perhaps a heads-up would be useful in the docs
> (there is some information about this in the vignettes section but I think
> it's worth including this in the documentation for "R CMD check" to prevent
> confusion. I suppose implicitly you expect the html to be generated given
> that the pdf manual is created at this step).

I don't really see the connection to "R CMD check".  This was documented 
as a change back in the NEWS file for 2.10.0, and as far as I know 
nothing in the documentation suggests that .html files will ever be 
produced (unless you ask for them).  That seems to me to be the right 
way to do it:  document how things are in the main documentation, and 
how things have changed in the NEWS.

R CMD check creates a pdf manual because sometimes that fails.  We don't 
have an HTML validity checker, so we don't try to check the validity of 
our generated HTML.

Duncan Murdoch