The purpose of the functions is to provide a simple means of markup
for quoting text to be used in the R output, e.g., in warnings or
error messages. The choice of the appropriate quotation marks depends on both the
locale and the available character sets. Older Unix/X11 fonts
displayed the grave accent (ASCII code 0x60) and the apostrophe (0x27)
in a way that they could also be used as matching open and close
single quotation marks. Using modern fonts, or non-Unix systems,
these characters no longer produce matching glyphs. Unicode provides
left and right single quotation mark characters (U+2018 and U+2019);
if Unicode markup cannot be assumed to be available, it seems good
practice to use the apostrophe as a non-directional single quotation
mark.
Similarly, Unicode has left and right double quotation mark characters
(U+201C and U+201D); if only ASCII's typewriter characteristics can be
employed, than the ASCII quotation mark (0x22) should be used as both
the left and right double quotation mark.
Some other locales also have the directional quotation marks, notably
on Windows. TeX uses grave and apostrophe for the directional single
quotation marks, and doubled grave and doubled apostrophe for the
directional double quotation marks.
What rendering is used depend on the options
setting for
useFancyQuotes
. If this is FALSE
then the undirectional
ASCII quotation style is used. If this is TRUE
(the default),
Unicode directional quotes are used are used where available
(currently, UTF-8 locales on Unix-alikes and all Windows locales
except C
): if set to "UTF-8"
UTF-8 markup is used
(whatever the current locale). If set to "TeX"
, TeX-style
markup is used. Finally, if this is set to a character vector of
length four, the first two entries are used for beginning and ending
single quotes and the second two for beginning and ending double
quotes: this can be used to implement non-English quoting conventions
such as the use of guillemets.
Where fancy quotes are used, you should be aware that they may not be
rendered correctly as not all fonts include the requisite glyphs: for
example some have directional single quotes but not directional double
quotes.
windows
This is particularly troublesome in Windows Command Prompt
windows, which by default are set up to run in the so-called OEM
codepage, which in most locales uses a different encoding from
Windows. Further, if the codepage is changed (with chcp.exe
,
e.g.\ifelse{latex}{\out{~}}{ } to 1252 in a Western European language), the default raster fonts
do not support the directional quotes.
To work around this, the default for options("useFancyQuotes")
is FALSE
on Windows except for the Rgui
console. There
fancy quotes work with the default Courier New font and more elegantly with
Lucida Console and default East Asian fonts, but directional double
quotes are missing in raster fonts such as Courier and FixedSys.