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

[Prof Brian Ripley]

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}.

You might also want to think about the N^{*} in the latex version and the 
N in the not-so-plain text version.

-- 
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