[Rd] Warning under R 2.6.0: Rd files with unknown encoding

[Prof Brian Ripley]

These can be hard to spot.  My technique (which in fact I did not need 
here) is to use 'less' in a C locale, as that does things like

     (s_{ij} - c_{ij})/[(c_{ii}c_{jj} - c_{ij}<B2>)/N]^{1/2}}

with <B2> in reverse video so it is hard to miss.

Brian

On Tue, 12 Jun 2007, John Fox wrote:

> Dear Brian,
>
>> -----Original Message-----
>> From: Prof Brian Ripley [mailto:ripley at stats.ox.ac.uk]
>> Sent: Tuesday, June 12, 2007 7:45 AM
>> To: John Fox
>> Cc: r-devel at r-project.org
>> Subject: Re: [Rd] Warning under R 2.6.0: Rd files with
>> unknown encoding
>>
>> On Tue, 12 Jun 2007, John Fox wrote:
>>
>>> Dear R-devel list members,
>>>
>>> Under the development version of R (2.6.0), I notice that my sem
>>> package produces the following warning:
>>>
>>> 	checking Rd files ... WARNING
>>> 	Rd files with unknown encoding:
>>> 	residuals.Rd
>>>
>>> I wonder what the warning means. As far as I can see,
>> residuals.Rd is
>>> similar to the other .Rd files in the package.
>>>
>>> At least for the time being, I won't reproduce residuals.Rd here in
>>> the interest of brevity.
>>
>> You have in the \details of that file:
>>
>>      (s_{ij} - c_{ij})/[(c_{ii}c_{jj} - c_{ij}²)/N]^{1/2}}
>>
>> and that superscript 2 (which will probably come out in your
>> mailer but not for all readers) is not ASCII.  'Writing R
>> Extensions' tells you that for files that are not entirely
>> ASCII you need to declare the encoding:
>> I presume you want \encoding{latin1}.
>
> Thanks for catching that. I wonder how it happened, since I believe that I
> produced the file with a plain-text editor, probably Tinn-R.
>
>>
>> You might also want to think about the N^{*} in the latex
>> version and the N in the not-so-plain text version.
>
> Yes, I saw the missing asterisk (and the not-so-plain text) when I compared
> the PDF and chtml versions of the help page in my attempt to locate the
> error.
>
> Thanks again,
> John
>
>>
>> --
>> 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