R for Windows Configuration

Description

The file ‘Rconsole’ configures the R GUI console in this Windows port. The file ‘Rdevga’ configures the graphics devices windows, win.graph, win.metafile and win.print.

Details

There are system copies of these files in ‘R\_HOME\etc’. Users can have personal copies of the files: these are looked for in the location given by the environment variable R\_USER. The system files are read only if a corresponding personal file is not found.

If the environment variable R\_USER is not set, the R system sets it to HOME if that is set (stripping any trailing slash), otherwise to the Windows "personal" directory, otherwise to {HOMEDRIVE}{HOMEPATH} if HOMEDRIVE and HOMEDRIVE are both set otherwise to the working directory. This is as described in the file ‘rw-FAQ’.

Value

Each of the files contains details in its comments of how to set the values.

At the time of writing ‘Rdevga’ configured the mapping of font numbers to fonts, and ‘Rconsole’ configured the appearance (single or multiple document interface, toolbar, statusbar on MDI), size, font and colours of the GUI console, and whether resizing the console sets options("width").

The file ‘Rconsole’ also configures the internal pager. This shares the font and colours of the console, but can be sized separately.

‘Rconsole’ can also set the initial positions of the console and the graphics device, as well as the size and position of the MDI workspace in MDI mode.

Note

The GUI preferences item on the Edit menu brings up an form which can be used to edit the console settings, and to save them to a file.

Author(s)

Guido Masarotto

See Also

windows

Examples

ruser <- Sys.getenv("R_USER")
cat("\n\nLocation for personal configuration files is\n   R_USER = ",
    ruser, "\n\n", sep="")
## see if there are personal configuration files
sapply(c("Rconsole", "Rdevga"), function(x) file.exists(file.path(ruser, x)))

## show the configuration files used
showConfig <- function(file)
{
    ruser <- Sys.getenv("R_USER")
    path <- file.path(ruser, file)
    if(!file.exists(path)) path <- file.path(R.home(), "etc", file)
    file.show(path, header=path)
}
showConfig("Rconsole")