Skip to content

Warning under R 2.6.0: Rd files with unknown encoding

5 messages · John Fox, Peter Dalgaard, Brian Ripley

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

Any help would be appreciated.

John

--------------------------------
John Fox, Professor
Department of Sociology
McMaster University
Hamilton, Ontario
Canada L8S 4M4
905-525-9140x23604
http://socserv.mcmaster.ca/jfox
#
On Tue, 12 Jun 2007, John Fox wrote:

            
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.
#
Dear Brian,
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.
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
#
John Fox wrote:
Several tools seem to be overly helpful in doing that conversion 
(x-caret-2 becomes x-superscript-2) these days. X11 keyboards without 
the nodeadkeys option does it if you forget a space after the caret, and 
Thunderbird does it when displaying emails, which is almost as annoying 
as the automatic smiley recognition (which has been said to "turn Perl 
scripts into love letters").
#
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: