The R Project SVN R

Rev

Rev 51006 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 51006 Rev 52246
Line 5... Line 5...
5
Windows 2000 and later (including 64-bit versions of Windows) on ix86
5
Windows 2000 and later (including 64-bit versions of Windows) on ix86
6
and x86_64 chips.  It is designed to be as close as possible to the
6
and x86_64 chips.  It is designed to be as close as possible to the
7
implementation on Unix, but see the list of differences below.  The
7
implementation on Unix, but see the list of differences below.  The
8
port was by Guido Masarotto, Brian Ripley and Duncan Murdoch.
8
port was by Guido Masarotto, Brian Ripley and Duncan Murdoch.
9
 
9
 
10
See the file `CHANGES' for the new features of this version.
10
See the file 'CHANGES' for the new features of this version.
11
 
11
 
12
 
12
 
13
Installation
13
Installation
14
============
14
============
15
 
15
 
16
The distribution is distributed as a 30Mb installer @RWVER@-win32.exe.
16
The distribution is distributed as a 37Mb installer @RWVER@-win.exe.
17
 
17
 
18
Just run this for a Windows-XP style installer.  It contains all the R
18
Just run this for a Windows-XP style installer.  It contains all the R
19
components, and you can select what want installed.
19
components, and you can select what want installed.
20
 
20
 
21
For more details, including command-line options for the installer
21
For more details, including command-line options for the installer
Line 25... Line 25...
25
 
25
 
26
 
26
 
27
Usage
27
Usage
28
=====
28
=====
29
 
29
 
30
There are two versions of the R executable in @RWVER@\bin:
30
There are two versions of the R executable in @RWVER@\bin\i386 (32-bit) or 
-
 
31
@RWVER@\bin\x64 (64-bit).
31
 
32
 
32
GUI:
33
GUI:
33
 
34
 
34
Rgui.exe runs as a standard Windows GUI executable and provides an R
35
Rgui.exe runs as a standard Windows GUI executable and provides an R
35
console in its own window.  It takes the standard R command-line
36
console in its own window.  It takes the standard R command-line
36
arguments; these are most easily set by making a shortcut to
37
arguments; these are most easily set by making a shortcut to
37
...\@RWVER@\bin\Rgui.exe and adding the arguments in the Target field.
38
...\@RWVER@\bin\Rgui.exe and adding the arguments in the Target field.
38
Set the `Start in' field of the shortcut to the directory you want to
39
Set the 'Start in' field of the shortcut to the directory you want to
39
use as the working directory (where workspaces and files are saved to
40
use as the working directory (where workspaces and files are saved to
40
and loaded from).  The installer creates a shortcut on the desktop for
41
and loaded from).  The installer creates a shortcut on the desktop for
41
you (by default).
42
you (by default).
42
 
43
 
43
You have a choice of interface: SDI (separate windows) or MDI
44
You have a choice of interface: SDI (separate windows) or MDI
Line 52... Line 53...
52
 
53
 
53
The 'load' menu items (Source R code, Display file, Load Workspace)
54
The 'load' menu items (Source R code, Display file, Load Workspace)
54
keep track of the directory that was last used, and start their dialog
55
keep track of the directory that was last used, and start their dialog
55
boxes from that directory the next time they are used.  That directory
56
boxes from that directory the next time they are used.  That directory
56
can be made the working directory by the File | Change dir menu item.
57
can be made the working directory by the File | Change dir menu item.
57
All the `save' menu items start dialog boxes at the current working
58
All the 'save' menu items start dialog boxes at the current working
58
directory: this includes `Save Workspace' and the various ways to save
59
directory: this includes 'Save Workspace' and the various ways to save
59
graphics, as well as saving the workspace at the end of the session.
60
graphics, as well as saving the workspace at the end of the session.
60
 
61
 
61
Note that the text help files use the latin1 encoding.  To see all the
62
Note that a few of the text help files use accented Western European.
62
characters you must use an appropriate font (European-language True
63
To see all the characters you must use an appropriate font
63
Type fonts should be OK).  To check if your preferred font has latin1
64
(European-language True Type fonts should be OK).  To check if your
64
capability, try "help(text)" and look at the examples.   [Note: only a
-
 
65
few help files make use of latin1 characters not contained in the
65
preferred font has these characters, try "help(text)" and look at the
66
standard ASCII set so if you like a font without latin1 capability,
-
 
67
use it.]
66
examples.
68
 
67
 
69
 
68
 
70
TERMINAL/BATCH:
69
TERMINAL/BATCH:
71
 
70
 
72
Rterm.exe will run from a command line such as an MS-DOS or Commands
71
Rterm.exe will run from a command line such as a 'Command Prompt'
73
Window running the standard shell, cmd.exe, as well as the ports of
72
window running the standard shell, cmd.exe, as well as the ports of
74
bash and tcsh that we use.  Its primary purpose is to allow batch
73
bash and tcsh that we use.  Its primary purpose is to allow batch
75
operation, but it does provide all the facilities needed for
74
operation, but it does provide all the facilities needed for
76
interactive use, including command-line editing (see the file
75
interactive use, including command-line editing (see the file
77
README.Rterm).
76
README.Rterm).
78
 
77
 
Line 127... Line 126...
127
Many aspects of the console (size, appearance, font, font size,
126
Many aspects of the console (size, appearance, font, font size,
128
colours) can be customized by editing the file etc\Rconsole, and a
127
colours) can be customized by editing the file etc\Rconsole, and a
129
copy with a user's settings can be put in her HOME directory or in the
128
copy with a user's settings can be put in her HOME directory or in the
130
working directory.  (The exact sequence is to search the directory
129
working directory.  (The exact sequence is to search the directory
131
pointed to by the first found of the environment variables R_USER then
130
pointed to by the first found of the environment variables R_USER then
132
HOME, then the Windows "personal" directory (typically `C:\Documents
131
HOME, then the Windows "personal" directory (typically 'C:\Documents
133
and Settings\username\My Documents' in Windows XP)
132
and Settings\username\My Documents' in Windows XP and
-
 
133
'C:\Users\username\My Documents' on Vista/7) then
134
 then {HOMEDRIVE}{HOMEPATH} then the working directory, finally
134
{HOMEDRIVE}{HOMEPATH} then the working directory, finally R_HOME\etc.
135
R_HOME\etc.  This also applies to .Renviron and other uses of `HOME'
135
This also applies to .Renviron and other uses of 'HOME' in our
136
in our documentation.)  The file contains a description of the
136
documentation.)  The file contains a description of the settings that
137
settings that can be altered.  See also ?Rconsole.
137
can be altered.  See also ?Rconsole.
138
 
138
 
139
An alternative way to edit the Rconsole file is to use the GUI
139
An alternative way to edit the Rconsole file is to use the GUI
140
preferences item on the Edit menu in Rgui.exe.  This can change some
140
preferences item on the Edit menu in Rgui.exe.  This can change some
141
of the settings (for example colours, font and window sizes) on the
141
of the settings (for example colours, font and window sizes) on the
142
current running console.
142
current running console.
Line 164... Line 164...
164
Binaries for many packages are available under
164
Binaries for many packages are available under
165
CRAN/bin/windows/contrib.  These are zip files which should be
165
CRAN/bin/windows/contrib.  These are zip files which should be
166
unpacked in @RWVER@\library.  The simplest option is use the items on
166
unpacked in @RWVER@\library.  The simplest option is use the items on
167
the Packages menu to install from a zip file or to download from CRAN.
167
the Packages menu to install from a zip file or to download from CRAN.
168
 
168
 
169
The list of packages and functions given by HTML help and used by the
-
 
170
search engine can be updated from a running R process by the command
-
 
171
 
-
 
172
	link.html.help()
-
 
173
 
-
 
174
provided the owner of the process has write permission on
-
 
175
@RWVER@\doc\html.
-
 
176
 
-
 
177
Private libraries of packages can be used and can be specified by the
169
Private libraries of packages can be used and can be specified by the
178
environment variable R_LIBS.  (Separate directories by ";" in this
170
environment variable R_LIBS.  (Separate directories by ";" in this
179
version.)  They will not be linked to HTML help.  In more detail, to
171
version.)  They will not be linked to HTML help.  In more detail, to
180
use packages installed in directory R:\libraries\gm, set
172
use packages installed in directory R:\libraries\gm, set
181
 
173
 
Line 188... Line 180...
188
 
180
 
189
to your .Rprofile or at the end of R_HOME\etc\Rprofile.
181
to your .Rprofile or at the end of R_HOME\etc\Rprofile.
190
 
182
 
191
To install a package from source code you need the source-package
183
To install a package from source code you need the source-package
192
distribution installed from @RWVER@-win32.exe (but not the R sources).
184
distribution installed from @RWVER@-win32.exe (but not the R sources).
193
The `R Installation and Administration' manual contains detailed
185
The 'R Installation and Administration' manual contains detailed
194
instructions.
186
instructions.
195
 
187
 
196
 
188
 
197
Differences from Unix versions of R
189
Differences from Unix versions of R
198
===================================
190
===================================
Line 201... Line 193...
201
  Ctrl-C is used for copying in the GUI version.  C-c C-c works
193
  Ctrl-C is used for copying in the GUI version.  C-c C-c works
202
  under NTemacs.
194
  under NTemacs.
203
 
195
 
204
- Command-line editing is always available, but is simpler than
196
- Command-line editing is always available, but is simpler than
205
  under readline-based input on Unix.  For Rgui.exe, see the menu item
197
  under readline-based input on Unix.  For Rgui.exe, see the menu item
206
  `Help | Console', for Rterm.exe the file README.Rterm.
198
  'Help | Console', for Rterm.exe the file README.Rterm.
207
 
199
 
208
- Paths to files can be specified with "/" or "\\".
200
- Paths to files can be specified with "/" or "\\".
209
 
201
 
210
- system() is enhanced here and does not automatically use a shell.
202
- system() is enhanced here and does not automatically use a shell.
211
  See its help page and that of shell().
203
  See its help page and that of shell().
Line 224... Line 216...
224
 
216
 
225
 
217
 
226
Building From Source
218
Building From Source
227
====================
219
====================
228
 
220
 
229
See the `R Installation and Adminstration' Manual
221
See the 'R Installation and Adminstration' Manual
230
(doc\manual\R-admin.html) and the rw-FAQ.
222
(doc\manual\R-admin.html) and the rw-FAQ.
231
 
223
 
232
 
224
 
233
Feedback
225
Feedback
234
========
226
========