On 14/03/2011 8:29 AM, Amos Folarin wrote:
On 14 March 2011 11:43, Duncan Murdoch<murdoch.dun...@gmail.com>  wrote:

>  On 11-03-14 7:32 AM, Amos Folarin wrote:
>
>>
>>>  ---------- Forwarded message ----------
>>>  From: Duncan Murdoch<murdoch.dun...@gmail.com>
>>>  To: Amos Folarin<amosfola...@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

______________________________________________
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.

Reply via email to