From ripley at stats.ox.ac.uk  Tue Jun 12 13:45:18 2007
From: ripley at stats.ox.ac.uk (Prof Brian Ripley)
Date: Tue, 12 Jun 2007 12:45:18 +0100 (BST)
Subject: [Rd] Warning under R 2.6.0: Rd files with unknown encoding
In-Reply-To: <20070612112518.RFIU1673.tomts16-srv.bellnexxia.net@JohnDesktop8300>
References: <20070612112518.RFIU1673.tomts16-srv.bellnexxia.net@JohnDesktop8300>
Message-ID: <Pine.LNX.4.64.0706121238160.15600@auk.stats>

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


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