SCM

SCM Repository

[ihelp] Annotation of /src/R-admin-ko.po
ViewVC logotype

Annotation of /src/R-admin-ko.po

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1201 - (view) (download)

1 : gnustats 1201 # Korean translations for R-manual-translation-ko package
2 :     # Copyright (C) 2014 Chel Hee Lee
3 :     # This file is distributed under the same license as the R-manual-translation-ko package.
4 :     # Automatically generated, 2014.
5 :     #
6 :     msgid ""
7 :     msgstr ""
8 :     "Project-Id-Version: R-manual-translation-ko 0.3.0.1\n"
9 :     "Report-Msgid-Bugs-To: chl948@mail.usask.ca\n"
10 :     "POT-Creation-Date: 2014-12-23 18:46-0600\n"
11 :     "PO-Revision-Date: 2014-12-23 01:41-0600\n"
12 :     "Last-Translator: Chel Hee Lee <chl948@mail.usask.ca>\n"
13 :     "Language-Team: Chel Hee Lee <chl948@mail.usask.ca>\n"
14 :     "Language: ko\n"
15 :     "MIME-Version: 1.0\n"
16 :     "Content-Type: text/plain; charset=UTF-8\n"
17 :     "Content-Transfer-Encoding: 8bit\n"
18 :     "Plural-Forms: nplurals=1; plural=0;\n"
19 :    
20 :     #. type: top
21 :     #: R-admin.texi:4
22 :     #: R-admin.texi:32
23 :     #: R-admin.texi:50
24 :     #, no-wrap
25 :     msgid "R Installation and Administration"
26 :     msgstr ""
27 :    
28 :     #. type: dircategory
29 :     #: R-admin.texi:11
30 :     #, no-wrap
31 :     msgid "Programming"
32 :     msgstr ""
33 :    
34 :     #. type: menuentry
35 :     #: R-admin.texi:14
36 :     msgid "R Administration: (R-admin)"
37 :     msgstr ""
38 :    
39 :     #. type: menuentry
40 :     #: R-admin.texi:14
41 :     msgid "R Installation and Administration."
42 :     msgstr ""
43 :    
44 :     #. type: include
45 :     #: R-admin.texi:18
46 :     #, no-wrap
47 :     msgid "R-defs.texi"
48 :     msgstr ""
49 :    
50 :     #. type: include
51 :     #: R-admin.texi:19
52 :     #, no-wrap
53 :     msgid "version.texi"
54 :     msgstr ""
55 :    
56 :     #. type: copying
57 :     #: R-admin.texi:23
58 :     msgid "This manual is for R, version @value{VERSION}."
59 :     msgstr ""
60 :    
61 :     #. type: copying
62 :     #: R-admin.texi:25
63 :     msgid "@Rcopyright{2001}"
64 :     msgstr ""
65 :    
66 :     #. type: quotation
67 :     #: R-admin.texi:28
68 :     msgid "@permission{}"
69 :     msgstr ""
70 :    
71 :     #. type: subtitle
72 :     #: R-admin.texi:33
73 :     #, no-wrap
74 :     msgid "Version @value{VERSION}"
75 :     msgstr ""
76 :    
77 :     #. type: author
78 :     #: R-admin.texi:34
79 :     #, no-wrap
80 :     msgid "R Core Team"
81 :     msgstr ""
82 :    
83 :     #. type: node
84 :     #: R-admin.texi:49
85 :     #: R-admin.texi:77
86 :     #: R-admin.texi:223
87 :     #: R-admin.texi:1018
88 :     #: R-admin.texi:1565
89 :     #: R-admin.texi:1740
90 :     #: R-admin.texi:1789
91 :     #: R-admin.texi:2412
92 :     #: R-admin.texi:2638
93 :     #: R-admin.texi:2714
94 :     #: R-admin.texi:2927
95 :     #: R-admin.texi:3728
96 :     #: R-admin.texi:4206
97 :     #: R-admin.texi:5543
98 :     #: R-admin.texi:5791
99 :     #: R-admin.texi:5796
100 :     #: R-admin.texi:5801
101 :     #, no-wrap
102 :     msgid "Top"
103 :     msgstr ""
104 :    
105 :     #. type: node
106 :     #: R-admin.texi:49
107 :     #: R-admin.texi:75
108 :     #: R-admin.texi:77
109 :     #: R-admin.texi:78
110 :     #: R-admin.texi:79
111 :     #: R-admin.texi:90
112 :     #: R-admin.texi:139
113 :     #: R-admin.texi:223
114 :     #, no-wrap
115 :     msgid "Obtaining R"
116 :     msgstr ""
117 :    
118 :     #. type: node
119 :     #: R-admin.texi:49
120 :     #, no-wrap
121 :     msgid "(dir)"
122 :     msgstr ""
123 :    
124 :     #. type: ifnottex
125 :     #: R-admin.texi:53
126 :     msgid "This is a guide to installation and administration for R."
127 :     msgstr ""
128 :    
129 :     #. type: node
130 :     #: R-admin.texi:75
131 :     #: R-admin.texi:77
132 :     #: R-admin.texi:223
133 :     #: R-admin.texi:224
134 :     #: R-admin.texi:262
135 :     #: R-admin.texi:394
136 :     #: R-admin.texi:419
137 :     #: R-admin.texi:572
138 :     #: R-admin.texi:749
139 :     #: R-admin.texi:776
140 :     #: R-admin.texi:905
141 :     #: R-admin.texi:932
142 :     #: R-admin.texi:1018
143 :     #, no-wrap
144 :     msgid "Installing R under Unix-alikes"
145 :     msgstr ""
146 :    
147 :     #. type: node
148 :     #: R-admin.texi:75
149 :     #: R-admin.texi:223
150 :     #: R-admin.texi:1018
151 :     #: R-admin.texi:1019
152 :     #: R-admin.texi:1048
153 :     #: R-admin.texi:1532
154 :     #: R-admin.texi:1565
155 :     #, no-wrap
156 :     msgid "Installing R under Windows"
157 :     msgstr ""
158 :    
159 :     #. type: node
160 :     #: R-admin.texi:75
161 :     #: R-admin.texi:1018
162 :     #: R-admin.texi:1565
163 :     #: R-admin.texi:1566
164 :     #: R-admin.texi:1615
165 :     #: R-admin.texi:1674
166 :     #: R-admin.texi:1713
167 :     #: R-admin.texi:1740
168 :     #, no-wrap
169 :     msgid "Installing R under OS X"
170 :     msgstr ""
171 :    
172 :     #. type: node
173 :     #: R-admin.texi:75
174 :     #: R-admin.texi:1565
175 :     #: R-admin.texi:1740
176 :     #: R-admin.texi:1741
177 :     #: R-admin.texi:1789
178 :     #, no-wrap
179 :     msgid "Running R"
180 :     msgstr ""
181 :    
182 :     #. type: node
183 :     #: R-admin.texi:75
184 :     #: R-admin.texi:1740
185 :     #: R-admin.texi:1789
186 :     #: R-admin.texi:1790
187 :     #: R-admin.texi:1812
188 :     #: R-admin.texi:1838
189 :     #: R-admin.texi:1880
190 :     #: R-admin.texi:2226
191 :     #: R-admin.texi:2260
192 :     #: R-admin.texi:2283
193 :     #: R-admin.texi:2355
194 :     #: R-admin.texi:2412
195 :     #, no-wrap
196 :     msgid "Add-on packages"
197 :     msgstr ""
198 :    
199 :     #. type: node
200 :     #: R-admin.texi:75
201 :     #: R-admin.texi:1789
202 :     #: R-admin.texi:2412
203 :     #: R-admin.texi:2414
204 :     #: R-admin.texi:2445
205 :     #: R-admin.texi:2545
206 :     #: R-admin.texi:2638
207 :     #, no-wrap
208 :     msgid "Internationalization"
209 :     msgstr ""
210 :    
211 :     #. type: node
212 :     #: R-admin.texi:75
213 :     #: R-admin.texi:2412
214 :     #: R-admin.texi:2638
215 :     #: R-admin.texi:2639
216 :     #: R-admin.texi:2714
217 :     #, no-wrap
218 :     msgid "Choosing between 32- and 64-bit builds"
219 :     msgstr ""
220 :    
221 :     #. type: node
222 :     #: R-admin.texi:75
223 :     #: R-admin.texi:2638
224 :     #: R-admin.texi:2714
225 :     #: R-admin.texi:2715
226 :     #: R-admin.texi:2789
227 :     #: R-admin.texi:2850
228 :     #: R-admin.texi:2927
229 :     #, no-wrap
230 :     msgid "The standalone Rmath library"
231 :     msgstr ""
232 :    
233 :     #. type: node
234 :     #: R-admin.texi:75
235 :     #: R-admin.texi:2714
236 :     #: R-admin.texi:2927
237 :     #: R-admin.texi:2928
238 :     #: R-admin.texi:2946
239 :     #: R-admin.texi:3065
240 :     #: R-admin.texi:3298
241 :     #: R-admin.texi:3728
242 :     #, no-wrap
243 :     msgid "Essential and useful other programs under a Unix-alike"
244 :     msgstr ""
245 :    
246 :     #. type: node
247 :     #: R-admin.texi:75
248 :     #: R-admin.texi:2927
249 :     #: R-admin.texi:3728
250 :     #: R-admin.texi:3729
251 :     #: R-admin.texi:3742
252 :     #: R-admin.texi:3810
253 :     #: R-admin.texi:3827
254 :     #: R-admin.texi:3947
255 :     #: R-admin.texi:3957
256 :     #: R-admin.texi:3982
257 :     #: R-admin.texi:4086
258 :     #: R-admin.texi:4167
259 :     #: R-admin.texi:4206
260 :     #, no-wrap
261 :     msgid "Configuration on a Unix-alike"
262 :     msgstr ""
263 :    
264 :     #. type: node
265 :     #: R-admin.texi:75
266 :     #: R-admin.texi:3728
267 :     #: R-admin.texi:4206
268 :     #: R-admin.texi:4207
269 :     #: R-admin.texi:4249
270 :     #: R-admin.texi:4337
271 :     #: R-admin.texi:4542
272 :     #: R-admin.texi:4985
273 :     #: R-admin.texi:5273
274 :     #: R-admin.texi:5420
275 :     #: R-admin.texi:5426
276 :     #: R-admin.texi:5481
277 :     #: R-admin.texi:5543
278 :     #, no-wrap
279 :     msgid "Platform notes"
280 :     msgstr ""
281 :    
282 :     #. type: node
283 :     #: R-admin.texi:75
284 :     #: R-admin.texi:4206
285 :     #: R-admin.texi:5543
286 :     #: R-admin.texi:5544
287 :     #: R-admin.texi:5637
288 :     #: R-admin.texi:5668
289 :     #: R-admin.texi:5680
290 :     #: R-admin.texi:5737
291 :     #: R-admin.texi:5772
292 :     #: R-admin.texi:5791
293 :     #, no-wrap
294 :     msgid "The Windows toolset"
295 :     msgstr ""
296 :    
297 :     #. type: node
298 :     #: R-admin.texi:75
299 :     #: R-admin.texi:5543
300 :     #: R-admin.texi:5791
301 :     #: R-admin.texi:5792
302 :     #: R-admin.texi:5796
303 :     #, no-wrap
304 :     msgid "Function and variable index"
305 :     msgstr ""
306 :    
307 :     #. type: node
308 :     #: R-admin.texi:75
309 :     #: R-admin.texi:5791
310 :     #: R-admin.texi:5796
311 :     #: R-admin.texi:5797
312 :     #: R-admin.texi:5801
313 :     #, no-wrap
314 :     msgid "Concept index"
315 :     msgstr ""
316 :    
317 :     #. type: unnumbered
318 :     #: R-admin.texi:75
319 :     #: R-admin.texi:5796
320 :     #: R-admin.texi:5801
321 :     #: R-admin.texi:5802
322 :     #, no-wrap
323 :     msgid "Environment variable index"
324 :     msgstr ""
325 :    
326 :     #. type: Plain text
327 :     #: R-admin.texi:84
328 :     msgid ""
329 :     "Sources, binaries and documentation for @R{} can be obtained via "
330 :     "@acronym{CRAN}, the ``Comprehensive R Archive Network'' whose current "
331 :     "members are listed at @uref{http://CRAN.R-project.org/@/mirrors.html}."
332 :     msgstr ""
333 :    
334 :     #. type: node
335 :     #: R-admin.texi:88
336 :     #: R-admin.texi:90
337 :     #: R-admin.texi:91
338 :     #: R-admin.texi:139
339 :     #, no-wrap
340 :     msgid "Getting and unpacking the sources"
341 :     msgstr ""
342 :    
343 :     #. type: node
344 :     #: R-admin.texi:88
345 :     #: R-admin.texi:90
346 :     #: R-admin.texi:139
347 :     #: R-admin.texi:140
348 :     #: R-admin.texi:160
349 :     #, no-wrap
350 :     msgid "Getting patched and development versions"
351 :     msgstr ""
352 :    
353 :     #. type: cindex
354 :     #: R-admin.texi:92
355 :     #, no-wrap
356 :     msgid "Sources for R"
357 :     msgstr ""
358 :    
359 :     #. type: Plain text
360 :     #: R-admin.texi:96
361 :     msgid ""
362 :     "The simplest way is to download the most recent @file{R-@var{x}.@var{y}."
363 :     "@var{z}.tar.gz} file, and unpack it with"
364 :     msgstr ""
365 :    
366 :     #. type: example
367 :     #: R-admin.texi:99
368 :     #, no-wrap
369 :     msgid "tar -xf R-@var{x}.@var{y}.@var{z}.tar.gz\n"
370 :     msgstr ""
371 :    
372 :     #. type: Plain text
373 :     #: R-admin.texi:107
374 :     msgid ""
375 :     "on systems that have a suitable@footnote{e.g.@: @acronym{GNU} @command{tar} "
376 :     "version 1.15 or later, or that from the @samp{libarchive} (as used on OS X "
377 :     "versions 10.6 and later) or `Heirloom Toolchest' distributions.} "
378 :     "@command{tar} installed. On other systems you need to have the "
379 :     "@command{gzip} program installed, when you can use"
380 :     msgstr ""
381 :    
382 :     #. type: example
383 :     #: R-admin.texi:110
384 :     #, no-wrap
385 :     msgid "gzip -dc R-@var{x}.@var{y}.@var{z}.tar.gz | tar -xf -\n"
386 :     msgstr ""
387 :    
388 :     #. type: Plain text
389 :     #: R-admin.texi:115
390 :     msgid ""
391 :     "The pathname of the directory into which the sources are unpacked should not "
392 :     "contain spaces, as most @command{make} programs (and specifically "
393 :     "@acronym{GNU} @command{make}) do not expect spaces."
394 :     msgstr ""
395 :    
396 :     #. type: Plain text
397 :     #: R-admin.texi:120
398 :     msgid ""
399 :     "If you want the build to be usable by a group of users, set @code{umask} "
400 :     "before unpacking so that the files will be readable by the target group (e."
401 :     "g.,@: @code{umask 022} to be usable by all users). Keep this setting of "
402 :     "@code{umask} whilst building and installing."
403 :     msgstr ""
404 :    
405 :     #. type: Plain text
406 :     #: R-admin.texi:125
407 :     msgid ""
408 :     "If you use a recent GNU version of @command{tar} and do this as a root "
409 :     "account (which on Windows includes accounts with administrator privileges) "
410 :     "you may see many warnings about changing ownership. In which case you can "
411 :     "use"
412 :     msgstr ""
413 :    
414 :     #. type: example
415 :     #: R-admin.texi:128
416 :     #, no-wrap
417 :     msgid "tar --no-same-owner -xf R-@var{x}.@var{y}.@var{z}.tar.gz\n"
418 :     msgstr ""
419 :    
420 :     #. type: Plain text
421 :     #: R-admin.texi:132
422 :     msgid "and perhaps also include the option @option{--no-same-permissions}."
423 :     msgstr ""
424 :    
425 :     #. type: enindex
426 :     #: R-admin.texi:132
427 :     #: R-admin.texi:1126
428 :     #, no-wrap
429 :     msgid "TAR_OPTIONS"
430 :     msgstr ""
431 :    
432 :     #. type: Plain text
433 :     #: R-admin.texi:136
434 :     msgid ""
435 :     "(These options can also be set in the @env{TAR_OPTIONS} environment "
436 :     "variable: if more than one option is included they should be separated by "
437 :     "spaces.)"
438 :     msgstr ""
439 :    
440 :     #. type: Plain text
441 :     #: R-admin.texi:149
442 :     msgid ""
443 :     "A patched version of the current release, @samp{r-patched}, and the current "
444 :     "development version, @samp{r-devel}, are available as daily tarballs and via "
445 :     "access to the R Subversion repository. (For the two weeks prior to the "
446 :     "release of a minor (3.x.0) version, @samp{r-patched} tarballs may refer to "
447 :     "beta/release candidates of the upcoming release, the patched version of the "
448 :     "current release being available via Subversion.)"
449 :     msgstr ""
450 :    
451 :     #. type: Plain text
452 :     #: R-admin.texi:155
453 :     msgid ""
454 :     "The tarballs are available from @uref{ftp://ftp.stat.math.ethz.ch/@/pub/@/"
455 :     "Software/R/}. Download @file{R-patched.tar.gz} or @file{R-devel.tar.gz} (or "
456 :     "the @file{.tar.bz2} versions) and unpack as described in the previous "
457 :     "section. They are built in exactly the same way as distributions of R "
458 :     "releases."
459 :     msgstr ""
460 :    
461 :     #. type: subsection
462 :     #: R-admin.texi:158
463 :     #: R-admin.texi:160
464 :     #: R-admin.texi:161
465 :     #, no-wrap
466 :     msgid "Using Subversion and rsync"
467 :     msgstr ""
468 :    
469 :     #. type: cindex
470 :     #: R-admin.texi:162
471 :     #: R-admin.texi:3057
472 :     #, no-wrap
473 :     msgid "Subversion"
474 :     msgstr ""
475 :    
476 :     #. type: Plain text
477 :     #: R-admin.texi:173
478 :     msgid ""
479 :     "Sources are also available via @uref{https://svn.R-project.org/R/}, the R "
480 :     "Subversion repository. If you have a Subversion client (see @uref{http://"
481 :     "subversion.apache.org/}), you can check out and update the current @samp{r-"
482 :     "devel} from @uref{https://svn.r-project.org/@/R/@/trunk/} and the current "
483 :     "@samp{r-patched} from @samp{https://svn.r-project.org/@/R/@/branches/@/R-"
484 :     "@var{x}-@var{y}-branch/} (where @var{x} and @var{y} are the major and minor "
485 :     "number of the current released version of R). E.g., use"
486 :     msgstr ""
487 :    
488 :     #. type: example
489 :     #: R-admin.texi:176
490 :     #, no-wrap
491 :     msgid "svn checkout https://svn.r-project.org/R/trunk/ @var{path}\n"
492 :     msgstr ""
493 :    
494 :     #. type: Plain text
495 :     #: R-admin.texi:184
496 :     msgid ""
497 :     "to check out @samp{r-devel} into directory @var{path} (which will be created "
498 :     "if necessary). The alpha, beta and RC versions of an upcoming @var{x.y.0} "
499 :     "release are available from @samp{https://svn.r-project.org/R/branches/R-"
500 :     "@var{x}-@var{y}-branch/} in the four-week period prior to the release."
501 :     msgstr ""
502 :    
503 :     #. type: Plain text
504 :     #: R-admin.texi:189
505 :     msgid ""
506 :     "Note that @samp{https:} is required@footnote{for some Subversion clients "
507 :     "@samp{http:} may appear to work, but requires continual redirection.}, and "
508 :     "that the SSL certificate for the Subversion server of the R project should "
509 :     "be recognized as from a trusted source."
510 :     msgstr ""
511 :    
512 :     #. type: Plain text
513 :     #: R-admin.texi:194
514 :     msgid ""
515 :     "Note that retrieving the sources by e.g.@: @command{wget -r} or @command{svn "
516 :     "export} from that URL will not work (and will give a error early in the "
517 :     "@command{make} process): the Subversion information is needed to build @R{}."
518 :     msgstr ""
519 :    
520 :     #. type: Plain text
521 :     #: R-admin.texi:201
522 :     msgid ""
523 :     "The Subversion repository does not contain the current sources for the "
524 :     "recommended packages, which can be obtained by @command{rsync} or downloaded "
525 :     "from @acronym{CRAN}. To use @code{rsync} to install the appropriate sources "
526 :     "for the recommended packages, run @code{./tools/rsync-recommended} from the "
527 :     "top-level directory of the @R{} sources."
528 :     msgstr ""
529 :    
530 :     #. type: Plain text
531 :     #: R-admin.texi:214
532 :     msgid ""
533 :     "If downloading manually from @acronym{CRAN}, do ensure that you have the "
534 :     "correct versions of the recommended packages: if the number in the file "
535 :     "@file{VERSION} is @samp{@var{x}.@var{y}.@var{z}} you need to download the "
536 :     "contents of @samp{http://CRAN.R-project.org/src/contrib/@var{dir}}, where "
537 :     "@var{dir} is @samp{@var{x}.@var{y}.@var{z}/Recommended} for r-devel or "
538 :     "@file{@var{x}.@var{y}-patched/Recommended} for r-patched, respectively, to "
539 :     "directory @file{src/library/Recommended} in the sources you have unpacked. "
540 :     "After downloading manually you need to execute @command{tools/link-"
541 :     "recommended} from the top level of the sources to make the requisite links "
542 :     "in @file{src/library/Recommended}. A suitable incantation from the top "
543 :     "level of the R sources using @command{wget} might be (for the correct value "
544 :     "of @file{@var{dir}})"
545 :     msgstr ""
546 :    
547 :     #. type: example
548 :     #: R-admin.texi:219
549 :     #, no-wrap
550 :     msgid ""
551 :     "wget -r -l1 --no-parent -A\\*.gz -nd -P src/library/Recommended \\\n"
552 :     " http://CRAN.R-project.org/src/contrib/@var{dir}\n"
553 :     "./tools/link-recommended\n"
554 :     msgstr ""
555 :    
556 :     #. type: cindex
557 :     #: R-admin.texi:225
558 :     #, no-wrap
559 :     msgid "Installing under Unix-alikes"
560 :     msgstr ""
561 :    
562 :     #. type: Plain text
563 :     #: R-admin.texi:243
564 :     msgid ""
565 :     "@R{} will configure and build under most common Unix and Unix-alike "
566 :     "platforms including @samp{@var{cpu}-*-linux-gnu} for the @cputype{alpha}, "
567 :     "@cputype{arm}, @cputype{hppa}, @cputype{ix86}, @cputype{ia64}, "
568 :     "@cputype{m68k}, @cputype{mips}, @cputype{mipsel}, @cputype{powerpc}, "
569 :     "@cputype{s390}, @cputype{sparc}, and @cputype{x86_64} @acronym{CPU}s, "
570 :     "@samp{x86_64-@/apple-@/darwin}, @samp{i386-@/sun-@/solaris} and @samp{sparc-"
571 :     "@/sun-@/solaris} as well as perhaps (it is tested less frequently on these "
572 :     "platforms) @samp{i386-@/apple-@/darwin}, @samp{i386-@/*-@/freebsd}, "
573 :     "@samp{x86_64-@/*-@/freebsd}, @samp{i386-@/*-@/netbsd}, @samp{i386-@/*-@/"
574 :     "openbsd} and @samp{powerpc-@/ibm-@/aix6*}"
575 :     msgstr ""
576 :    
577 :     #. type: node
578 :     #: R-admin.texi:244
579 :     #: R-admin.texi:4247
580 :     #: R-admin.texi:4249
581 :     #: R-admin.texi:4337
582 :     #: R-admin.texi:4338
583 :     #: R-admin.texi:4339
584 :     #: R-admin.texi:4447
585 :     #: R-admin.texi:4465
586 :     #: R-admin.texi:4503
587 :     #: R-admin.texi:4542
588 :     #, no-wrap
589 :     msgid "Linux"
590 :     msgstr ""
591 :    
592 :     #. type: node
593 :     #: R-admin.texi:245
594 :     #: R-admin.texi:1567
595 :     #: R-admin.texi:2059
596 :     #: R-admin.texi:4247
597 :     #: R-admin.texi:4337
598 :     #: R-admin.texi:4542
599 :     #: R-admin.texi:4543
600 :     #: R-admin.texi:4544
601 :     #: R-admin.texi:4713
602 :     #: R-admin.texi:4726
603 :     #: R-admin.texi:4732
604 :     #: R-admin.texi:4763
605 :     #: R-admin.texi:4805
606 :     #: R-admin.texi:4821
607 :     #: R-admin.texi:4865
608 :     #: R-admin.texi:4927
609 :     #: R-admin.texi:4957
610 :     #: R-admin.texi:4985
611 :     #, no-wrap
612 :     msgid "OS X"
613 :     msgstr ""
614 :    
615 :     #. type: Plain text
616 :     #: R-admin.texi:250
617 :     msgid ""
618 :     "In addition, binary distributions are available for some common Linux "
619 :     "distributions and for OS X (formerly Mac OS). See the @acronym{FAQ} for "
620 :     "current details. These are installed in platform-specific ways, so for the "
621 :     "rest of this chapter we consider only building from the sources."
622 :     msgstr ""
623 :    
624 :     #. type: node
625 :     #: R-admin.texi:260
626 :     #: R-admin.texi:262
627 :     #: R-admin.texi:263
628 :     #: R-admin.texi:394
629 :     #, no-wrap
630 :     msgid "Simple compilation"
631 :     msgstr ""
632 :    
633 :     #. type: node
634 :     #: R-admin.texi:260
635 :     #: R-admin.texi:262
636 :     #: R-admin.texi:394
637 :     #: R-admin.texi:395
638 :     #: R-admin.texi:419
639 :     #, no-wrap
640 :     msgid "Help options"
641 :     msgstr ""
642 :    
643 :     #. type: node
644 :     #: R-admin.texi:260
645 :     #: R-admin.texi:394
646 :     #: R-admin.texi:419
647 :     #: R-admin.texi:420
648 :     #: R-admin.texi:572
649 :     #, no-wrap
650 :     msgid "Making the manuals"
651 :     msgstr ""
652 :    
653 :     #. type: node
654 :     #: R-admin.texi:260
655 :     #: R-admin.texi:419
656 :     #: R-admin.texi:572
657 :     #: R-admin.texi:573
658 :     #: R-admin.texi:574
659 :     #: R-admin.texi:749
660 :     #, no-wrap
661 :     msgid "Installation"
662 :     msgstr ""
663 :    
664 :     #. type: node
665 :     #: R-admin.texi:260
666 :     #: R-admin.texi:572
667 :     #: R-admin.texi:749
668 :     #: R-admin.texi:750
669 :     #: R-admin.texi:776
670 :     #, no-wrap
671 :     msgid "Uninstallation"
672 :     msgstr ""
673 :    
674 :     #. type: node
675 :     #: R-admin.texi:260
676 :     #: R-admin.texi:749
677 :     #: R-admin.texi:776
678 :     #: R-admin.texi:777
679 :     #: R-admin.texi:859
680 :     #: R-admin.texi:905
681 :     #, no-wrap
682 :     msgid "Sub-architectures"
683 :     msgstr ""
684 :    
685 :     #. type: node
686 :     #: R-admin.texi:260
687 :     #: R-admin.texi:776
688 :     #: R-admin.texi:905
689 :     #: R-admin.texi:906
690 :     #: R-admin.texi:932
691 :     #, no-wrap
692 :     msgid "Other Options"
693 :     msgstr ""
694 :    
695 :     #. type: node
696 :     #: R-admin.texi:260
697 :     #: R-admin.texi:905
698 :     #: R-admin.texi:932
699 :     #, no-wrap
700 :     msgid "Testing a Unix-alike Installation"
701 :     msgstr ""
702 :    
703 :     #. type: Plain text
704 :     #: R-admin.texi:268
705 :     msgid ""
706 :     "First review the essential and useful tools and libraries in @ref{Essential "
707 :     "and useful other programs under a Unix-alike}, and install those you"
708 :     msgstr ""
709 :    
710 :     #. type: enindex
711 :     #: R-admin.texi:268
712 :     #: R-admin.texi:1198
713 :     #: R-admin.texi:1767
714 :     #: R-admin.texi:1780
715 :     #: R-admin.texi:1908
716 :     #, no-wrap
717 :     msgid "TMPDIR"
718 :     msgstr ""
719 :    
720 :     #. type: Plain text
721 :     #: R-admin.texi:276
722 :     msgid ""
723 :     "want or need. Ensure that the environment variable @env{TMPDIR} is either "
724 :     "unset (and @file{/tmp} exists and can be written in and scripts can be "
725 :     "executed from) or points to the absolute path to a valid temporary directory "
726 :     "(one from which execution of scripts is allowed) which does not contain "
727 :     "spaces.@footnote{Most aspects will work with paths containing spaces, but "
728 :     "external software used by @R{}, e.g.@: @command{texi2dvi} version "
729 :     "@code{4.8}, may not.}"
730 :     msgstr ""
731 :    
732 :     #. type: findex
733 :     #: R-admin.texi:277
734 :     #, no-wrap
735 :     msgid "R_HOME"
736 :     msgstr ""
737 :    
738 :     #. type: Plain text
739 :     #: R-admin.texi:285
740 :     msgid ""
741 :     "Choose a directory to install the @R{} tree (@R{} is not just a binary, but "
742 :     "has additional data sets, help files, font metrics etc). Let us call this "
743 :     "place @var{R_HOME}. Untar the source code. This should create directories "
744 :     "@file{src}, @file{doc}, and several more under a top-level directory: change "
745 :     "to that top-level directory (At this point North American readers should "
746 :     "consult @ref{Setting paper size}.) Issue the following commands:"
747 :     msgstr ""
748 :    
749 :     #. type: findex
750 :     #: R-admin.texi:286
751 :     #: R-admin.texi:353
752 :     #: R-admin.texi:582
753 :     #: R-admin.texi:622
754 :     #: R-admin.texi:3830
755 :     #: R-admin.texi:3977
756 :     #, no-wrap
757 :     msgid "configure"
758 :     msgstr ""
759 :    
760 :     #. type: example
761 :     #: R-admin.texi:291
762 :     #, no-wrap
763 :     msgid ""
764 :     "./configure\n"
765 :     "make\n"
766 :     msgstr ""
767 :    
768 :     #. type: Plain text
769 :     #: R-admin.texi:297
770 :     msgid ""
771 :     "(See @ref{Using make} if your make is not called @samp{make}.) Users of "
772 :     "Debian-based 64-bit systems@footnote{which use @file{lib} rather than "
773 :     "@file{lib64} for their primary 64-bit library directories.} may need"
774 :     msgstr ""
775 :    
776 :     #. type: example
777 :     #: R-admin.texi:301
778 :     #, no-wrap
779 :     msgid ""
780 :     "./configure LIBnn=lib\n"
781 :     "make\n"
782 :     msgstr ""
783 :    
784 :     #. type: Plain text
785 :     #: R-admin.texi:305
786 :     msgid "Then check the built system works correctly by"
787 :     msgstr ""
788 :    
789 :     #. type: example
790 :     #: R-admin.texi:308
791 :     #: R-admin.texi:1298
792 :     #, no-wrap
793 :     msgid "make check\n"
794 :     msgstr ""
795 :    
796 :     #. type: Plain text
797 :     #: R-admin.texi:319
798 :     msgid ""
799 :     "Failures are not necessarily problems as they might be caused by missing "
800 :     "functionality,@footnote{for example, if you configured @R{} with @option{--"
801 :     "without-recommended}.} but you should look carefully at any reported "
802 :     "discrepancies. (Some non-fatal errors are expected in locales that do not "
803 :     "support Latin-1, in particular in true @code{C} locales and non-UTF-8 non-"
804 :     "Western-European locales.) A failure in @file{tests/ok-errors.R} may "
805 :     "indicate inadequate resource limits (@pxref{Running R})."
806 :     msgstr ""
807 :    
808 :     #. type: Plain text
809 :     #: R-admin.texi:321
810 :     msgid "More comprehensive testing can be done by"
811 :     msgstr ""
812 :    
813 :     #. type: example
814 :     #: R-admin.texi:324
815 :     #: R-admin.texi:1312
816 :     #, no-wrap
817 :     msgid "make check-devel\n"
818 :     msgstr ""
819 :    
820 :     #. type: Plain text
821 :     #: R-admin.texi:328
822 :     #: R-admin.texi:547
823 :     #: R-admin.texi:4833
824 :     msgid "or"
825 :     msgstr ""
826 :    
827 :     #. type: example
828 :     #: R-admin.texi:331
829 :     #: R-admin.texi:1319
830 :     #, no-wrap
831 :     msgid "make check-all\n"
832 :     msgstr ""
833 :    
834 :     #. type: Plain text
835 :     #: R-admin.texi:337
836 :     msgid ""
837 :     "see file @file{tests/README} and @ref{Testing a Unix-alike Installation} for "
838 :     "the possibilities of doing this in parallel. Note that these checks need "
839 :     "the recommended packages to be installed."
840 :     msgstr ""
841 :    
842 :     #. type: Plain text
843 :     #: R-admin.texi:348
844 :     msgid ""
845 :     "If the command @command{configure} and @command{make} commands execute "
846 :     "successfully, a shell-script front-end called @file{R} will be created and "
847 :     "copied to @file{@var{R_HOME}/bin}. You can link or copy this script to a "
848 :     "place where users can invoke it, for example to @file{/usr/local/bin/R}. "
849 :     "You could also copy the man page @file{R.1} to a place where your "
850 :     "@command{man} reader finds it, such as @file{/usr/local/man/man1}. If you "
851 :     "want to install the complete @R{} tree to, e.g., @file{/usr/local/lib/R}, "
852 :     "see @ref{Installation}. Note: you do not @emph{need} to install @R{}: you "
853 :     "can run it from where it was built."
854 :     msgstr ""
855 :    
856 :     #. type: Plain text
857 :     #: R-admin.texi:352
858 :     msgid ""
859 :     "You do not necessarily have to build @R{} in the top-level source directory "
860 :     "(say, @file{@var{TOP_SRCDIR}}). To build in @file{@var{BUILDDIR}}, run"
861 :     msgstr ""
862 :    
863 :     #. type: example
864 :     #: R-admin.texi:359
865 :     #, no-wrap
866 :     msgid ""
867 :     "cd @var{BUILDDIR}\n"
868 :     "@var{TOP_SRCDIR}/configure\n"
869 :     "make\n"
870 :     msgstr ""
871 :    
872 :     #. type: Plain text
873 :     #: R-admin.texi:367
874 :     msgid ""
875 :     "and so on, as described further below. This has the advantage of always "
876 :     "keeping your source tree clean and is particularly recommended when you work "
877 :     "with a version of @R{} from Subversion. (You may need @acronym{GNU} "
878 :     "@command{make} to allow this, and you will need no spaces in the path to the "
879 :     "build directory.)"
880 :     msgstr ""
881 :    
882 :     #. type: Plain text
883 :     #: R-admin.texi:386
884 :     msgid ""
885 :     "Now @code{rehash} if necessary, type @kbd{R}, and read the @R{} manuals and "
886 :     "the @R{} @acronym{FAQ} (files @file{FAQ} or @file{doc/manual/R-FAQ.html}, or "
887 :     "@uref{http://CRAN.R-project.org/@/doc/@/FAQ/@/R-FAQ.html} which always has "
888 :     "the version for the latest release of @R{})."
889 :     msgstr ""
890 :    
891 :     #. type: Plain text
892 :     #: R-admin.texi:393
893 :     msgid ""
894 :     "Note: if you already have @R{} installed, check that where you installed "
895 :     "@R{} replaces or comes earlier in your path than the previous installation. "
896 :     "Some systems are set up to have @file{/usr/bin} (the standard place for a "
897 :     "system installation) ahead of @file{/usr/local/bin} (the default place for "
898 :     "installation of @R{}) in their default path, and some do not have @file{/usr/"
899 :     "local/bin} on the default path."
900 :     msgstr ""
901 :    
902 :     #. type: Plain text
903 :     #: R-admin.texi:399
904 :     msgid ""
905 :     "By default @HTML{} help pages are created when needed rather than being "
906 :     "built at install time."
907 :     msgstr ""
908 :    
909 :     #. type: Plain text
910 :     #: R-admin.texi:409
911 :     msgid ""
912 :     "If you need to disable the server and want @HTML{} help, there is the option "
913 :     "to build @HTML{} pages when packages are installed (including those "
914 :     "installed with @R{}). This is enabled by the @command{configure} option "
915 :     "@option{--enable-prebuilt-html}. Whether @command{R CMD INSTALL} (and hence "
916 :     "@code{install.packages}) pre-builds @HTML{} pages is determined by looking "
917 :     "at the @R{} installation and is reported by @command{R CMD INSTALL --help}: "
918 :     "it can be overridden by specifying one of the @command{INSTALL} options "
919 :     "@option{--html} or @option{--no-html}."
920 :     msgstr ""
921 :    
922 :     #. type: Plain text
923 :     #: R-admin.texi:411
924 :     msgid "The server is disabled by setting the environment variable"
925 :     msgstr ""
926 :    
927 :     #. type: enindex
928 :     #: R-admin.texi:411
929 :     #, no-wrap
930 :     msgid "R_DISABLE_HTTPD"
931 :     msgstr ""
932 :    
933 :     #. type: Plain text
934 :     #: R-admin.texi:418
935 :     msgid ""
936 :     "@env{R_DISABLE_HTTPD} to a non-empty value, either before @R{} is started or "
937 :     "within the @R{} session before @HTML{} help (including @code{help.start}) is "
938 :     "used. It is also possible that system security measures will prevent the "
939 :     "server from being started, for example if the loopback interface has been "
940 :     "disabled. See @code{?tools::startDynamicHelp} for more details."
941 :     msgstr ""
942 :    
943 :     #. type: cindex
944 :     #: R-admin.texi:421
945 :     #, no-wrap
946 :     msgid "Manuals"
947 :     msgstr ""
948 :    
949 :     #. type: Plain text
950 :     #: R-admin.texi:424
951 :     msgid "There is a set of manuals that can be built from the sources,"
952 :     msgstr ""
953 :    
954 :     #. type: item
955 :     #: R-admin.texi:426
956 :     #, no-wrap
957 :     msgid "fullrefman"
958 :     msgstr ""
959 :    
960 :     #. type: table
961 :     #: R-admin.texi:429
962 :     msgid ""
963 :     "Printed versions of all the help pages for base and recommended packages "
964 :     "(over 3300 pages)."
965 :     msgstr ""
966 :    
967 :     #. type: item
968 :     #: R-admin.texi:429
969 :     #, no-wrap
970 :     msgid "refman"
971 :     msgstr ""
972 :    
973 :     #. type: table
974 :     #: R-admin.texi:431
975 :     msgid ""
976 :     "Printed versions of the help pages for selected base packages (over 1900 "
977 :     "pages)"
978 :     msgstr ""
979 :    
980 :     #. type: item
981 :     #: R-admin.texi:431
982 :     #, no-wrap
983 :     msgid "R-FAQ"
984 :     msgstr ""
985 :    
986 :     #. type: table
987 :     #: R-admin.texi:433
988 :     msgid "R @acronym{FAQ}"
989 :     msgstr ""
990 :    
991 :     #. type: item
992 :     #: R-admin.texi:433
993 :     #, no-wrap
994 :     msgid "R-intro"
995 :     msgstr ""
996 :    
997 :     #. type: table
998 :     #: R-admin.texi:435
999 :     msgid "``An Introduction to R''."
1000 :     msgstr ""
1001 :    
1002 :     #. type: item
1003 :     #: R-admin.texi:435
1004 :     #, no-wrap
1005 :     msgid "R-data"
1006 :     msgstr ""
1007 :    
1008 :     #. type: table
1009 :     #: R-admin.texi:437
1010 :     msgid "``R Data Import/Export''."
1011 :     msgstr ""
1012 :    
1013 :     #. type: item
1014 :     #: R-admin.texi:437
1015 :     #, no-wrap
1016 :     msgid "R-admin"
1017 :     msgstr ""
1018 :    
1019 :     #. type: table
1020 :     #: R-admin.texi:439
1021 :     msgid "``R Installation and Administration'', this manual."
1022 :     msgstr ""
1023 :    
1024 :     #. type: item
1025 :     #: R-admin.texi:439
1026 :     #, no-wrap
1027 :     msgid "R-exts"
1028 :     msgstr ""
1029 :    
1030 :     #. type: table
1031 :     #: R-admin.texi:441
1032 :     msgid "``Writing R Extensions''."
1033 :     msgstr ""
1034 :    
1035 :     #. type: item
1036 :     #: R-admin.texi:441
1037 :     #, no-wrap
1038 :     msgid "R-lang"
1039 :     msgstr ""
1040 :    
1041 :     #. type: table
1042 :     #: R-admin.texi:443
1043 :     msgid "``The R Language Definition''."
1044 :     msgstr ""
1045 :    
1046 :     #. type: Plain text
1047 :     #: R-admin.texi:447
1048 :     msgid "To make these (with @samp{fullrefman} rather than @samp{refman}), use"
1049 :     msgstr ""
1050 :    
1051 :     #. type: example
1052 :     #: R-admin.texi:451
1053 :     #, no-wrap
1054 :     msgid ""
1055 :     "make pdf @r{to create PDF versions}\n"
1056 :     "make info @r{to create info files (not @samp{refman} nor @samp{fullrefman}).}\n"
1057 :     msgstr ""
1058 :    
1059 :     #. type: Plain text
1060 :     #: R-admin.texi:459
1061 :     msgid ""
1062 :     "You will not be able to build any of these unless you have "
1063 :     "@command{makeinfo} version 4.7 or later installed, and for PDF you must have "
1064 :     "@command{texi2dvi} and @file{texinfo.tex} installed (which are part of the "
1065 :     "@acronym{GNU} @pkg{texinfo} distribution but are, especially @file{texinfo."
1066 :     "tex}, often made part of the @TeX{} package in re-distributions)."
1067 :     msgstr ""
1068 :    
1069 :     #. type: Plain text
1070 :     #: R-admin.texi:466
1071 :     msgid ""
1072 :     "The PDF versions can be viewed using any recent PDF viewer: they have "
1073 :     "hyperlinks that can be followed. The info files are suitable for reading "
1074 :     "online with Emacs or the standalone @acronym{GNU} @command{info} program. "
1075 :     "The PDF versions will be created using the paper size selected at "
1076 :     "configuration (default ISO a4): this can be overridden by setting "
1077 :     "@env{R_PAPERSIZE}"
1078 :     msgstr ""
1079 :    
1080 :     #. type: enindex
1081 :     #: R-admin.texi:466
1082 :     #: R-admin.texi:1757
1083 :     #: R-admin.texi:3882
1084 :     #: R-admin.texi:3943
1085 :     #, no-wrap
1086 :     msgid "R_PAPERSIZE"
1087 :     msgstr ""
1088 :    
1089 :     #. type: Plain text
1090 :     #: R-admin.texi:472
1091 :     msgid ""
1092 :     "on the @command{make} command line, or setting @env{R_PAPERSIZE} in the "
1093 :     "environment and using @command{make -e}. (If re-making the manuals for a "
1094 :     "different paper size, you should first delete the file @file{doc/manual/"
1095 :     "version.texi}. The usual value for North America would be @samp{letter}.)"
1096 :     msgstr ""
1097 :    
1098 :     #. type: Plain text
1099 :     #: R-admin.texi:478
1100 :     msgid ""
1101 :     "There are some issues with making the PDF reference manual, @file{fullrefman."
1102 :     "pdf} or @file{refman.pdf}. The help files contain both ISO Latin1 "
1103 :     "characters (e.g.@: in @file{text.Rd}) and upright quotes, neither of which "
1104 :     "are contained in the standard @LaTeX{} Computer Modern fonts. We have "
1105 :     "provided four alternatives:"
1106 :     msgstr ""
1107 :    
1108 :     #. type: item
1109 :     #: R-admin.texi:480
1110 :     #, no-wrap
1111 :     msgid "times"
1112 :     msgstr ""
1113 :    
1114 :     #. type: table
1115 :     #: R-admin.texi:493
1116 :     msgid ""
1117 :     "(The default.) Using standard PostScript fonts, Times Roman, Helvetica and "
1118 :     "Courier. This works well both for on-screen viewing and for printing. One "
1119 :     "disadvantage is that the Usage and Examples sections may come out rather "
1120 :     "wide: this can be overcome by using @emph{in addition} either of the options "
1121 :     "@code{inconsolata}, on a Unix-alike only if found by @command{configure}) or "
1122 :     "@code{beramono}, which replace the Courier monospaced font by Inconsolata or "
1123 :     "Bera Sans mono respectively. (You will need a recent version of the "
1124 :     "appropriate @LaTeX{} package @pkg{inconsolata}@footnote{Instructions on how "
1125 :     "to install the latest version are at @uref{http://www.ctan.org/tex-archive/"
1126 :     "fonts/inconsolata/}.} or @pkg{bera} installed.)"
1127 :     msgstr ""
1128 :    
1129 :     #. type: table
1130 :     #: R-admin.texi:497
1131 :     msgid ""
1132 :     "Note that in most @LaTeX{} installations this will not actually use the "
1133 :     "standard fonts for PDF, but rather embed the URW clones NimbusRom, "
1134 :     "NimbusSans and (for Courier, if used) NimbusMon."
1135 :     msgstr ""
1136 :    
1137 :     #. type: table
1138 :     #: R-admin.texi:500
1139 :     msgid ""
1140 :     "This needs @LaTeX{} packages @pkg{times}, @pkg{helvetic} and (if used) "
1141 :     "@pkg{courier} installed."
1142 :     msgstr ""
1143 :    
1144 :     #. type: item
1145 :     #: R-admin.texi:501
1146 :     #, no-wrap
1147 :     msgid "lm"
1148 :     msgstr ""
1149 :    
1150 :     #. type: table
1151 :     #: R-admin.texi:507
1152 :     msgid ""
1153 :     "Using the @emph{Latin Modern} fonts. These are not often installed as part "
1154 :     "of a @TeX{} distribution, but can obtained from @uref{http://www.ctan.org/@/"
1155 :     "tex-archive/@/fonts/@/ps-type1/@/lm/} and mirrors. This uses fonts rather "
1156 :     "similar to Computer Modern, but is not so good on-screen as @code{times}."
1157 :     msgstr ""
1158 :    
1159 :     #. type: item
1160 :     #: R-admin.texi:508
1161 :     #, no-wrap
1162 :     msgid "cm-super"
1163 :     msgstr ""
1164 :    
1165 :     #. type: table
1166 :     #: R-admin.texi:514
1167 :     msgid ""
1168 :     "Using type-1 versions of the Computer Modern fonts by Vladimir Volovich. "
1169 :     "This is a large installation, obtainable from @uref{http://www.ctan.org/@/"
1170 :     "tex-archive/@/fonts/@/ps-type1/@/cm-super/} and its mirrors. These type-1 "
1171 :     "fonts have poor hinting and so are nowhere near as readable on-screen as the "
1172 :     "other three options."
1173 :     msgstr ""
1174 :    
1175 :     #. type: item
1176 :     #: R-admin.texi:515
1177 :     #, no-wrap
1178 :     msgid "ae"
1179 :     msgstr ""
1180 :    
1181 :     #. type: table
1182 :     #: R-admin.texi:523
1183 :     msgid ""
1184 :     "A package to use composites of Computer Modern fonts. This works well most "
1185 :     "of the time, and its PDF is more readable on-screen than the previous two "
1186 :     "options. There are three fonts for which it will need to use bitmapped "
1187 :     "fonts, @file{tctt0900.600pk}, @file{tctt1000.600pk} and "
1188 :     "@file{tcrm1000.600pk}. Unfortunately, if those files are not available, "
1189 :     "Acrobat Reader will substitute completely incorrect glyphs so you need to "
1190 :     "examine the logs carefully."
1191 :     msgstr ""
1192 :    
1193 :     #. type: Plain text
1194 :     #: R-admin.texi:526
1195 :     msgid "The default can be overridden by setting the environment variable"
1196 :     msgstr ""
1197 :    
1198 :     #. type: enindex
1199 :     #: R-admin.texi:526
1200 :     #: R-admin.texi:3942
1201 :     #: R-admin.texi:5662
1202 :     #, no-wrap
1203 :     msgid "R_RD4PDF"
1204 :     msgstr ""
1205 :    
1206 :     #. type: Plain text
1207 :     #: R-admin.texi:536
1208 :     msgid ""
1209 :     "@env{R_RD4PDF}. (On Unix-alikes, this will be picked up at install time and "
1210 :     "stored in @file{etc/Renviron}, but can still be overridden when the manuals "
1211 :     "are built, using @command{make -e}.) The usual @footnote{on a Unix-alike, "
1212 :     "@samp{inconsolata} is omitted if not found by @command{configure}.} default "
1213 :     "value for @env{R_RD4PDF} is @samp{times,inconsolata,hyper}: omit "
1214 :     "@samp{hyper} if you do not want hyperlinks (e.g.@: for printing the manual) "
1215 :     "or do not have @LaTeX{} package @pkg{hyperref}, and omit @samp{inconsolata} "
1216 :     "if you do not have @LaTeX{} package @pkg{inconsolata} installed."
1217 :     msgstr ""
1218 :    
1219 :     #. type: Plain text
1220 :     #: R-admin.texi:541
1221 :     msgid ""
1222 :     "Further options, e.g@: for @pkg{hyperref}, can be included in a file "
1223 :     "@file{Rd.cfg} somewhere on your @LaTeX{} search path. For example if you "
1224 :     "prefer the text and not the page number in the table of contents to be "
1225 :     "hyperlinked, use"
1226 :     msgstr ""
1227 :    
1228 :     #. type: example
1229 :     #: R-admin.texi:543
1230 :     #, no-wrap
1231 :     msgid "\\ifthenelse@{\\boolean@{Rd@@use@@hyper@}@}@{\\hypersetup@{linktoc=section@}@}@{@}\n"
1232 :     msgstr ""
1233 :    
1234 :     #. type: example
1235 :     #: R-admin.texi:549
1236 :     #, no-wrap
1237 :     msgid "\\ifthenelse@{\\boolean@{Rd@@use@@hyper@}@}@{\\hypersetup@{linktoc=all@}@}@{@}\n"
1238 :     msgstr ""
1239 :    
1240 :     #. type: Plain text
1241 :     #: R-admin.texi:555
1242 :     msgid ""
1243 :     "to hyperlink both text and page number@footnote{The @code{linktoc} settings "
1244 :     "require @pkg{hyperref} version 6.78f or newer; with older versions of "
1245 :     "@pkg{hyperref} use @code{linktocpage=false} to hyperlink the text.}."
1246 :     msgstr ""
1247 :    
1248 :     #. type: Plain text
1249 :     #: R-admin.texi:558
1250 :     msgid ""
1251 :     "Ebook versions in one or both of @file{.epub} and @file{.mobi} formats can "
1252 :     "be made by running in @file{doc/manual} one of"
1253 :     msgstr ""
1254 :    
1255 :     #. type: example
1256 :     #: R-admin.texi:562
1257 :     #, no-wrap
1258 :     msgid ""
1259 :     "make ebooks\n"
1260 :     "make epub\n"
1261 :     "make mobi\n"
1262 :     msgstr ""
1263 :    
1264 :     #. type: Plain text
1265 :     #: R-admin.texi:570
1266 :     msgid ""
1267 :     "This requires @command{ebook-convert} from @command{Calibre} (@uref{http://"
1268 :     "calibre-ebook.com/download}), or from most Linux distributions). If "
1269 :     "necessary the path to @command{ebook-convert} can be set as make macro "
1270 :     "@env{EBOOK} to by editing @file{doc/manual/Makefile} (which contains a "
1271 :     "commented value suitable for OS X)."
1272 :     msgstr ""
1273 :    
1274 :     #. type: Plain text
1275 :     #: R-admin.texi:579
1276 :     msgid ""
1277 :     "To ensure that the installed tree is usable by the right group of users, set "
1278 :     "@code{umask} appropriately (perhaps to @samp{022}) before unpacking the "
1279 :     "sources and throughout the build process."
1280 :     msgstr ""
1281 :    
1282 :     #. type: Plain text
1283 :     #: R-admin.texi:581
1284 :     msgid "After"
1285 :     msgstr ""
1286 :    
1287 :     #. type: example
1288 :     #: R-admin.texi:587
1289 :     #, no-wrap
1290 :     msgid ""
1291 :     "./configure\n"
1292 :     "make\n"
1293 :     "make check\n"
1294 :     msgstr ""
1295 :    
1296 :     #. type: Plain text
1297 :     #: R-admin.texi:594
1298 :     msgid ""
1299 :     "(or, when building outside the source, @code{@var{TOP_SRCDIR}/configure}, "
1300 :     "etc) have been completed successfully, you can install the complete @R{} "
1301 :     "tree to your system by typing"
1302 :     msgstr ""
1303 :    
1304 :     #. type: example
1305 :     #: R-admin.texi:597
1306 :     #, no-wrap
1307 :     msgid "make install\n"
1308 :     msgstr ""
1309 :    
1310 :     #. type: Plain text
1311 :     #: R-admin.texi:603
1312 :     msgid ""
1313 :     "A parallel make can be used (but run @command{make} before @command{make "
1314 :     "install}). Those using GNU @command{make} 4.0 or later may want to use "
1315 :     "@command{make -j @var{n} -O} to avoid interleaving of output."
1316 :     msgstr ""
1317 :    
1318 :     #. type: Plain text
1319 :     #: R-admin.texi:605
1320 :     msgid "This will install to the following directories:"
1321 :     msgstr ""
1322 :    
1323 :     #. type: item
1324 :     #: R-admin.texi:607
1325 :     #, no-wrap
1326 :     msgid "@file{@var{prefix}/bin} or @file{@var{bindir}}"
1327 :     msgstr ""
1328 :    
1329 :     #. type: table
1330 :     #: R-admin.texi:609
1331 :     msgid "the front-end shell script and other scripts and executables"
1332 :     msgstr ""
1333 :    
1334 :     #. type: item
1335 :     #: R-admin.texi:609
1336 :     #, no-wrap
1337 :     msgid "@file{@var{prefix}/man/man1} or @file{@var{mandir}/man1}"
1338 :     msgstr ""
1339 :    
1340 :     #. type: table
1341 :     #: R-admin.texi:611
1342 :     msgid "the man page"
1343 :     msgstr ""
1344 :    
1345 :     #. type: item
1346 :     #: R-admin.texi:611
1347 :     #, no-wrap
1348 :     msgid "@file{@var{prefix}/@var{LIBnn}/R} or @file{@var{libdir}/R}"
1349 :     msgstr ""
1350 :    
1351 :     #. type: table
1352 :     #: R-admin.texi:615
1353 :     msgid ""
1354 :     "all the rest (libraries, on-line help system, @dots{}). Here @var{LIBnn} is "
1355 :     "usually @samp{lib}, but may be @samp{lib64} on some 64-bit Linux systems. "
1356 :     "This is known as the @R{} home directory."
1357 :     msgstr ""
1358 :    
1359 :     #. type: Plain text
1360 :     #: R-admin.texi:621
1361 :     msgid ""
1362 :     "where @var{prefix} is determined during configuration (typically @file{/usr/"
1363 :     "local}) and can be set by running @command{configure} with the option "
1364 :     "@option{--prefix}, as in"
1365 :     msgstr ""
1366 :    
1367 :     #. type: example
1368 :     #: R-admin.texi:625
1369 :     #, no-wrap
1370 :     msgid "./configure --prefix=/where/you/want/R/to/go\n"
1371 :     msgstr ""
1372 :    
1373 :     #. type: Plain text
1374 :     #: R-admin.texi:633
1375 :     msgid ""
1376 :     "This causes @command{make install} to install the @R{} script to @file{/"
1377 :     "where/you/want/R/to/go/bin}, and so on. The prefix of the installation "
1378 :     "directories can be seen in the status message that is displayed at the end "
1379 :     "of @command{configure}. The installation may need to be done by the owner "
1380 :     "of @file{@var{prefix}}, often a root account."
1381 :     msgstr ""
1382 :    
1383 :     #. type: Plain text
1384 :     #: R-admin.texi:635
1385 :     msgid "You can install into another directory tree by using"
1386 :     msgstr ""
1387 :    
1388 :     #. type: example
1389 :     #: R-admin.texi:638
1390 :     #, no-wrap
1391 :     msgid "make prefix=/path/to/here install\n"
1392 :     msgstr ""
1393 :    
1394 :     #. type: Plain text
1395 :     #: R-admin.texi:643
1396 :     msgid ""
1397 :     "at least with @acronym{GNU} @command{make} (and current Solaris "
1398 :     "@command{make}, but not some older Unix makes)."
1399 :     msgstr ""
1400 :    
1401 :     #. type: Plain text
1402 :     #: R-admin.texi:647
1403 :     msgid ""
1404 :     "More precise control is available at configure time via options: see "
1405 :     "@command{configure --help} for details. (However, most of the `Fine tuning "
1406 :     "of the installation directories' options are not used by @R{}.)"
1407 :     msgstr ""
1408 :    
1409 :     #. type: Plain text
1410 :     #: R-admin.texi:651
1411 :     msgid ""
1412 :     "Configure options @option{--bindir} and @option{--mandir} are supported and "
1413 :     "govern where a copy of the @command{R} script and the @command{man} page are "
1414 :     "installed."
1415 :     msgstr ""
1416 :    
1417 :     #. type: Plain text
1418 :     #: R-admin.texi:657
1419 :     msgid ""
1420 :     "The configure option @option{--libdir} controls where the main @R{} files "
1421 :     "are installed: the default is @samp{@var{eprefix}/@var{LIBnn}}, where "
1422 :     "@var{eprefix} is the prefix used for installing architecture-dependent "
1423 :     "files, defaults to @var{prefix}, and can be set via the configure option "
1424 :     "@option{--exec-prefix}."
1425 :     msgstr ""
1426 :    
1427 :     #. type: Plain text
1428 :     #: R-admin.texi:661
1429 :     msgid ""
1430 :     "Each of @code{bindir}, @code{mandir} and @code{libdir} can also be specified "
1431 :     "on the @command{make install} command line (at least for @acronym{GNU} "
1432 :     "@command{make})."
1433 :     msgstr ""
1434 :    
1435 :     #. type: Plain text
1436 :     #: R-admin.texi:669
1437 :     msgid ""
1438 :     "The @command{configure} or @command{make} variables @code{rdocdir} and "
1439 :     "@code{rsharedir} can be used to install the system-independent @file{doc} "
1440 :     "and @file{share} directories to somewhere other than @code{libdir}. The C "
1441 :     "header files can be installed to the value of @code{rincludedir}: note that "
1442 :     "as the headers are not installed into a subdirectory you probably want "
1443 :     "something like @code{rincludedir=/usr/local/include/R-@value{VERSIONno}}."
1444 :     msgstr ""
1445 :    
1446 :     #. type: Plain text
1447 :     #: R-admin.texi:672
1448 :     msgid ""
1449 :     "If you want the @R{} home to be something other than @file{@var{libdir}/R}, "
1450 :     "use @option{rhome}: for example"
1451 :     msgstr ""
1452 :    
1453 :     #. type: example
1454 :     #: R-admin.texi:675
1455 :     #, no-wrap
1456 :     msgid "make install rhome=/usr/local/lib64/R-@value{VERSIONno}\n"
1457 :     msgstr ""
1458 :    
1459 :     #. type: Plain text
1460 :     #: R-admin.texi:680
1461 :     msgid ""
1462 :     "will use a version-specific @R{} home on a non-Debian Linux 64-bit system."
1463 :     msgstr ""
1464 :    
1465 :     #. type: Plain text
1466 :     #: R-admin.texi:683
1467 :     msgid ""
1468 :     "If you have made @R{} as a shared/static library you can install it in your "
1469 :     "system's library directory by"
1470 :     msgstr ""
1471 :    
1472 :     #. type: example
1473 :     #: R-admin.texi:686
1474 :     #, no-wrap
1475 :     msgid "make prefix=/path/to/here install-libR\n"
1476 :     msgstr ""
1477 :    
1478 :     #. type: Plain text
1479 :     #: R-admin.texi:696
1480 :     msgid ""
1481 :     "where @code{prefix} is optional, and @code{libdir} will give more precise "
1482 :     "control.@footnote{This will be needed if more than one sub-architecture is "
1483 :     "to be installed.} However, you should not install to a directory mentioned "
1484 :     "in @env{LDPATHS} (e.g.@: @file{/usr/local/lib64}) if you intend to work with "
1485 :     "multiple versions of @R{}, since that directory may be given precedence over "
1486 :     "the @file{lib} directory of other @R{} installations."
1487 :     msgstr ""
1488 :    
1489 :     #. type: example
1490 :     #: R-admin.texi:699
1491 :     #, no-wrap
1492 :     msgid "make install-strip\n"
1493 :     msgstr ""
1494 :    
1495 :     #. type: Plain text
1496 :     #: R-admin.texi:705
1497 :     msgid ""
1498 :     "will install stripped executables, and on platforms where this is supported, "
1499 :     "stripped libraries in directories @file{lib} and @file{modules} and in the "
1500 :     "standard packages."
1501 :     msgstr ""
1502 :    
1503 :     #. type: Plain text
1504 :     #: R-admin.texi:710
1505 :     msgid ""
1506 :     "Note that installing @R{} into a directory whose path contains spaces is not "
1507 :     "supported, and some aspects (such as installing source packages) will not "
1508 :     "work."
1509 :     msgstr ""
1510 :    
1511 :     #. type: cindex
1512 :     #: R-admin.texi:711
1513 :     #, no-wrap
1514 :     msgid "Manuals, installing"
1515 :     msgstr ""
1516 :    
1517 :     #. type: Plain text
1518 :     #: R-admin.texi:714
1519 :     msgid "To install info and PDF versions of the manuals, use one or both of"
1520 :     msgstr ""
1521 :    
1522 :     #. type: example
1523 :     #: R-admin.texi:718
1524 :     #, no-wrap
1525 :     msgid ""
1526 :     "make install-info\n"
1527 :     "make install-pdf\n"
1528 :     msgstr ""
1529 :    
1530 :     #. type: Plain text
1531 :     #: R-admin.texi:725
1532 :     msgid ""
1533 :     "Once again, it is optional to specify @code{prefix}, @code{libdir} or "
1534 :     "@code{rhome} (the PDF manuals are installed under the @R{} home directory). "
1535 :     "(@command{make install-info} needs Perl installed if there is no command "
1536 :     "@command{install-info} on the system.)"
1537 :     msgstr ""
1538 :    
1539 :     #. type: Plain text
1540 :     #: R-admin.texi:730
1541 :     msgid ""
1542 :     "More precise control is possible. For info, the setting used is that of "
1543 :     "@code{infodir} (default @file{@var{prefix}/info}, set by configure option "
1544 :     "@option{--infodir}). The PDF files are installed into the @R{} @file{doc} "
1545 :     "tree, set by the @command{make} variable @code{rdocdir}."
1546 :     msgstr ""
1547 :    
1548 :     #. type: Plain text
1549 :     #: R-admin.texi:734
1550 :     msgid ""
1551 :     "A staged installation is possible, that it is installing @R{} into a "
1552 :     "temporary directory in order to move the installed tree to its final "
1553 :     "destination. In this case @code{prefix} (and so on) should reflect the"
1554 :     msgstr ""
1555 :    
1556 :     #. type: enindex
1557 :     #: R-admin.texi:734
1558 :     #: R-admin.texi:2832
1559 :     #, no-wrap
1560 :     msgid "DESTDIR"
1561 :     msgstr ""
1562 :    
1563 :     #. type: Plain text
1564 :     #: R-admin.texi:737
1565 :     msgid ""
1566 :     "final destination, and @env{DESTDIR} should be used: see @uref{http://www."
1567 :     "gnu.org/@/prep/@/standards/@/html_node/@/DESTDIR.html}."
1568 :     msgstr ""
1569 :    
1570 :     #. type: Plain text
1571 :     #: R-admin.texi:740
1572 :     msgid ""
1573 :     "You can optionally install the run-time tests that are part of @command{make "
1574 :     "check-all} by"
1575 :     msgstr ""
1576 :    
1577 :     #. type: example
1578 :     #: R-admin.texi:743
1579 :     #: R-admin.texi:939
1580 :     #, no-wrap
1581 :     msgid "make install-tests\n"
1582 :     msgstr ""
1583 :    
1584 :     #. type: Plain text
1585 :     #: R-admin.texi:747
1586 :     #: R-admin.texi:943
1587 :     msgid "which populates a @file{tests} directory in the installation."
1588 :     msgstr ""
1589 :    
1590 :     #. type: Plain text
1591 :     #: R-admin.texi:753
1592 :     msgid "You can uninstall @R{} by"
1593 :     msgstr ""
1594 :    
1595 :     #. type: example
1596 :     #: R-admin.texi:756
1597 :     #, no-wrap
1598 :     msgid "make uninstall\n"
1599 :     msgstr ""
1600 :    
1601 :     #. type: Plain text
1602 :     #: R-admin.texi:761
1603 :     msgid ""
1604 :     "optionally specifying @code{prefix} etc in the same way as specified for "
1605 :     "installation."
1606 :     msgstr ""
1607 :    
1608 :     #. type: Plain text
1609 :     #: R-admin.texi:765
1610 :     msgid ""
1611 :     "This will also uninstall any installed manuals. There are specific targets "
1612 :     "to uninstall info and PDF manuals in file @file{doc/manual/Makefile}."
1613 :     msgstr ""
1614 :    
1615 :     #. type: Plain text
1616 :     #: R-admin.texi:768
1617 :     msgid ""
1618 :     "Target @code{uninstall-tests} will uninstall any installed tests, as well as "
1619 :     "removing the directory @file{tests} containing the test results."
1620 :     msgstr ""
1621 :    
1622 :     #. type: Plain text
1623 :     #: R-admin.texi:770
1624 :     msgid "An installed shared/static @code{libR} can be uninstalled by"
1625 :     msgstr ""
1626 :    
1627 :     #. type: example
1628 :     #: R-admin.texi:773
1629 :     #, no-wrap
1630 :     msgid "make prefix=/path/to/here uninstall-libR\n"
1631 :     msgstr ""
1632 :    
1633 :     #. type: Plain text
1634 :     #: R-admin.texi:783
1635 :     msgid ""
1636 :     "Some platforms can support closely related builds of @R{} which can share "
1637 :     "all but the executables and dynamic objects. Examples include builds under "
1638 :     "Linux and Solaris for different @acronym{CPU}s or 32- and 64-bit builds."
1639 :     msgstr ""
1640 :    
1641 :     #. type: Plain text
1642 :     #: R-admin.texi:791
1643 :     msgid ""
1644 :     "@R{} supports the idea of architecture-specific builds, specified by adding "
1645 :     "@samp{r_arch=@var{name}} to the @command{configure} line. Here @var{name} "
1646 :     "can be anything non-empty, and is used to name subdirectories of @file{lib}, "
1647 :     "@file{etc}, @file{include} and the package @file{libs} subdirectories. "
1648 :     "Example names from other software are the use of @file{sparcv9} on Sparc "
1649 :     "Solaris and @file{32} by @command{gcc} on @cputype{x86_64} Linux."
1650 :     msgstr ""
1651 :    
1652 :     #. type: Plain text
1653 :     #: R-admin.texi:798
1654 :     msgid ""
1655 :     "If you have two or more such builds you can install them over each other "
1656 :     "(and for 32/64-bit builds on one architecture, one build can be done without "
1657 :     "@samp{r_arch}). The space savings can be considerable: on @cputype{x86_64} "
1658 :     "Linux a basic install (without debugging symbols) took 63Mb, and adding a 32-"
1659 :     "bit build added 6Mb. If you have installed multiple builds you can select "
1660 :     "which build to run by"
1661 :     msgstr ""
1662 :    
1663 :     #. type: example
1664 :     #: R-admin.texi:801
1665 :     #, no-wrap
1666 :     msgid "R --arch=@var{name}\n"
1667 :     msgstr ""
1668 :    
1669 :     #. type: Plain text
1670 :     #: R-admin.texi:805
1671 :     msgid "and just running @samp{R} will run the last build that was installed."
1672 :     msgstr ""
1673 :    
1674 :     #. type: Plain text
1675 :     #: R-admin.texi:811
1676 :     msgid ""
1677 :     "@code{R CMD INSTALL} will detect if more than one build is installed and try "
1678 :     "to install packages with the appropriate library objects for each. This "
1679 :     "will not be done if the package has an executable @code{configure} script or "
1680 :     "a @file{src/Makefile} file. In such cases you can install for extra builds "
1681 :     "by"
1682 :     msgstr ""
1683 :    
1684 :     #. type: example
1685 :     #: R-admin.texi:814
1686 :     #, no-wrap
1687 :     msgid "R --arch=@var{name} CMD INSTALL --libs-only @var{pkg1} @var{pkg2} @dots{}\n"
1688 :     msgstr ""
1689 :    
1690 :     #. type: Plain text
1691 :     #: R-admin.texi:820
1692 :     msgid ""
1693 :     "If you want to mix sub-architectures compiled on different platforms (for "
1694 :     "example @cputype{x86_64} Linux and @cputype{i686} Linux), it is wise to use "
1695 :     "explicit names for each, and you may also need to set @option{libdir} to "
1696 :     "ensure that they install into the same place."
1697 :     msgstr ""
1698 :    
1699 :     #. type: Plain text
1700 :     #: R-admin.texi:828
1701 :     msgid ""
1702 :     "When sub-architectures are used the version of @command{Rscript} in e.g.@: "
1703 :     "@file{/usr/bin} will be the last installed, but architecture-specific "
1704 :     "versions will be available in e.g.@: @file{/usr/lib64/R/bin/exec"
1705 :     "$@{@var{R_ARCH}@}}. Normally all installed architectures will run on the "
1706 :     "platform so the architecture of @command{Rscript} itself does not matter. "
1707 :     "The executable @command{Rscript} will run the @command{R} script, and at "
1708 :     "that time the"
1709 :     msgstr ""
1710 :    
1711 :     #. type: enindex
1712 :     #: R-admin.texi:828
1713 :     #: R-admin.texi:848
1714 :     #, no-wrap
1715 :     msgid "R_ARCH"
1716 :     msgstr ""
1717 :    
1718 :     #. type: Plain text
1719 :     #: R-admin.texi:831
1720 :     msgid ""
1721 :     "setting of the @env{R_ARCH} environment variable determines the architecture "
1722 :     "which is run."
1723 :     msgstr ""
1724 :    
1725 :     #. type: Plain text
1726 :     #: R-admin.texi:833
1727 :     msgid "When running post-install tests with sub-architectures, use"
1728 :     msgstr ""
1729 :    
1730 :     #. type: example
1731 :     #: R-admin.texi:836
1732 :     #, no-wrap
1733 :     msgid "R --arch=@var{name} CMD make check[-devel|all]\n"
1734 :     msgstr ""
1735 :    
1736 :     #. type: Plain text
1737 :     #: R-admin.texi:840
1738 :     msgid "to select a sub-architecture to check."
1739 :     msgstr ""
1740 :    
1741 :     #. type: Plain text
1742 :     #: R-admin.texi:848
1743 :     msgid ""
1744 :     "Sub-architectures are also used on Windows, but by selecting executables "
1745 :     "within the appropriate @file{bin} directory, @file{@var{R_HOME}/bin/i386} or "
1746 :     "@file{@var{R_HOME}/bin/x64}. For backwards compatibility with @R{} < "
1747 :     "2.12.0, there are executables @file{@var{R_HOME}/bin/R.exe} or "
1748 :     "@file{@var{R_HOME}/bin/Rscript.exe}: these will run an executable from one "
1749 :     "of the subdirectories, which one being taken first from the"
1750 :     msgstr ""
1751 :    
1752 :     #. type: Plain text
1753 :     #: R-admin.texi:854
1754 :     msgid ""
1755 :     "@env{R_ARCH} environment variable, then from the @option{--arch} command-"
1756 :     "line option@footnote{with possible values @samp{i386}, @samp{x64}, @samp{32} "
1757 :     "and @samp{64}.} and finally from the installation default (which is 32-bit "
1758 :     "for a combined 32/64 bit @R{} installation)."
1759 :     msgstr ""
1760 :    
1761 :     #. type: subsection
1762 :     #: R-admin.texi:857
1763 :     #: R-admin.texi:859
1764 :     #: R-admin.texi:860
1765 :     #, no-wrap
1766 :     msgid "Multilib"
1767 :     msgstr ""
1768 :    
1769 :     #. type: Plain text
1770 :     #: R-admin.texi:869
1771 :     msgid ""
1772 :     "On Linux@footnote{mainly on RedHat and Fedora, whose layout is described "
1773 :     "here.}, there is an alternative mechanism for mixing 32-bit and 64-bit "
1774 :     "libraries known as @emph{multilib}. If a Linux distribution supports "
1775 :     "multilib, then parallel builds of @R{} may be installed in the sub-"
1776 :     "directories @file{lib} (32-bit) and @file{lib64} (64-bit). The build to be "
1777 :     "run may then be selected using the @command{setarch} command. For example, a "
1778 :     "32-bit build may be run by"
1779 :     msgstr ""
1780 :    
1781 :     #. type: example
1782 :     #: R-admin.texi:872
1783 :     #, no-wrap
1784 :     msgid "setarch i686 R\n"
1785 :     msgstr ""
1786 :    
1787 :     #. type: Plain text
1788 :     #: R-admin.texi:878
1789 :     msgid ""
1790 :     "The @command{setarch} command is only operational if both 32-bit and 64-bit "
1791 :     "builds are installed. If there is only one installation of @R{}, then this "
1792 :     "will always be run regardless of the architecture specified by the "
1793 :     "@command{setarch} command."
1794 :     msgstr ""
1795 :    
1796 :     #. type: Plain text
1797 :     #: R-admin.texi:884
1798 :     msgid ""
1799 :     "There can be problems with installing packages on the non-native "
1800 :     "architecture. It is a good idea to run e.g.@: @code{setarch i686 R} for "
1801 :     "sessions in which packages are to be installed, even if that is the only "
1802 :     "version of @R{} installed (since this tells the package installation code "
1803 :     "the architecture needed)."
1804 :     msgstr ""
1805 :    
1806 :     #. type: Plain text
1807 :     #: R-admin.texi:889
1808 :     msgid ""
1809 :     "At present there is a potential problem with packages using Java, as the "
1810 :     "post-install for a @cputype{i686} RPM on @cputype{x86_64} Linux reconfigures "
1811 :     "Java and will find the @cputype{x86_64} Java. If you know where a 32-bit "
1812 :     "Java is installed you may be able to run (as root)"
1813 :     msgstr ""
1814 :    
1815 :     #. type: example
1816 :     #: R-admin.texi:893
1817 :     #, no-wrap
1818 :     msgid ""
1819 :     "export JAVA_HOME=<path to jre directory of 32-bit Java>\n"
1820 :     "setarch i686 R CMD javareconf\n"
1821 :     msgstr ""
1822 :    
1823 :     #. type: Plain text
1824 :     #: R-admin.texi:897
1825 :     msgid "to get a suitable setting."
1826 :     msgstr ""
1827 :    
1828 :     #. type: Plain text
1829 :     #: R-admin.texi:904
1830 :     msgid ""
1831 :     "When this mechanism is used, the version of @command{Rscript} in e.g.@: "
1832 :     "@file{/usr/bin} will be the last installed, but an architecture-specific "
1833 :     "version will be available in e.g.@: @file{/usr/lib64/R/bin}. Normally all "
1834 :     "installed architectures will run on the platform so the architecture of "
1835 :     "@command{Rscript} does not matter."
1836 :     msgstr ""
1837 :    
1838 :     #. type: Plain text
1839 :     #: R-admin.texi:912
1840 :     msgid ""
1841 :     "There are many other installation options, most of which are listed by "
1842 :     "@command{configure --help}. Almost all of those not listed elsewhere in "
1843 :     "this manual are either standard @command{autoconf} options not relevant to "
1844 :     "@R{} or intended for specialist uses by the @R{} developers."
1845 :     msgstr ""
1846 :    
1847 :     #. type: Plain text
1848 :     #: R-admin.texi:919
1849 :     msgid ""
1850 :     "One that may be useful when working on @R{} itself is the option @option{--"
1851 :     "disable-byte-compiled-packages}, which ensures that the base and recommended "
1852 :     "packages are lazyloaded but not byte-compiled. (Alternatively the (make or "
1853 :     "environment) variable @env{R_NO_BASE_COMPILE} can be set to a non-empty "
1854 :     "value for the duration of the build.)"
1855 :     msgstr ""
1856 :    
1857 :     #. type: Plain text
1858 :     #: R-admin.texi:930
1859 :     msgid ""
1860 :     "Option @option{--with-internal-tzcode} makes use of @R{}'s own code and copy "
1861 :     "of the Olson database for managing timezones. This will be preferred where "
1862 :     "there are issues with the system implementation, usually involving times "
1863 :     "after 2037 or before 1916. An alternative time-zone directory@footnote{How "
1864 :     "to prepare such a directory is described in file @file{src/extra/tzone/"
1865 :     "Notes} in the @R{} sources.} can be used, pointed to by environment variable "
1866 :     "@env{TZDIR}: this should contain files such as @file{Europe/London}. On all "
1867 :     "tested OSes the system timezone was deduced correctly, but if necessary it "
1868 :     "can be set as the value of environment variable @env{TZ}."
1869 :     msgstr ""
1870 :    
1871 :     #. type: section
1872 :     #: R-admin.texi:933
1873 :     #: R-admin.texi:1533
1874 :     #, no-wrap
1875 :     msgid "Testing an Installation"
1876 :     msgstr ""
1877 :    
1878 :     #. type: Plain text
1879 :     #: R-admin.texi:936
1880 :     msgid ""
1881 :     "Full testing is possible only if the test files have been installed with"
1882 :     msgstr ""
1883 :    
1884 :     #. type: Plain text
1885 :     #: R-admin.texi:947
1886 :     msgid ""
1887 :     "If this has been done, two testing routes are available. The first is to "
1888 :     "move to the home directory of the @R{} installation (as given by @code{R."
1889 :     "home()}) and run"
1890 :     msgstr ""
1891 :    
1892 :     #. type: example
1893 :     #: R-admin.texi:954
1894 :     #, no-wrap
1895 :     msgid ""
1896 :     "cd tests\n"
1897 :     "## followed by one of\n"
1898 :     "../bin/R CMD make check\n"
1899 :     "../bin/R CMD make check-devel\n"
1900 :     "../bin/R CMD make check-all\n"
1901 :     msgstr ""
1902 :    
1903 :     #. type: Plain text
1904 :     #: R-admin.texi:960
1905 :     msgid ""
1906 :     "and other useful targets are @code{test-BasePackages} and @code{test-"
1907 :     "Recommended} to the run tests of the standard and recommended packages (if "
1908 :     "installed) respectively."
1909 :     msgstr ""
1910 :    
1911 :     #. type: Plain text
1912 :     #: R-admin.texi:967
1913 :     msgid ""
1914 :     "This re-runs all the tests relevant to the installed @R{} (including for "
1915 :     "example code in the package vignettes), but not for example the ones "
1916 :     "checking the example code in the manuals nor making the standalone Rmath "
1917 :     "library. This can occasionally be useful when the operating environment has "
1918 :     "been changed, for example by OS updates or by substituting the "
1919 :     "@acronym{BLAS} (@pxref{Shared BLAS})."
1920 :     msgstr ""
1921 :    
1922 :     #. type: Plain text
1923 :     #: R-admin.texi:978
1924 :     msgid ""
1925 :     "Parallel checking of packages may be possible: set the environment variable "
1926 :     "@env{TEST_MC_CORES} to the maximum number of processes to be run in "
1927 :     "parallel. This affects both checking the package examples (part of "
1928 :     "@command{make check}) and package sources (part of @command{make check-"
1929 :     "devel} and @command{make check-recommended}). It does require a "
1930 :     "@command{make} command which supports the @command{make -j @var{n}} option: "
1931 :     "most do but on Solaris you need to select GNU @code{make} or @code{dmake}. "
1932 :     "Where parallel checking of package sources is done, a log file "
1933 :     "@file{@var{pngname}.log} is left in the @code{tests} directory for "
1934 :     "inspection."
1935 :     msgstr ""
1936 :    
1937 :     #. type: Plain text
1938 :     #: R-admin.texi:982
1939 :     msgid ""
1940 :     "Alternatively, the installed @R{} can be run, preferably with @option{--"
1941 :     "vanilla}. Then"
1942 :     msgstr ""
1943 :    
1944 :     #. type: enindex
1945 :     #: R-admin.texi:982
1946 :     #, no-wrap
1947 :     msgid "LC_COLLATE"
1948 :     msgstr ""
1949 :    
1950 :     #. type: example
1951 :     #: R-admin.texi:990
1952 :     #, no-wrap
1953 :     msgid ""
1954 :     "Sys.setenv(LC_COLLATE = \"C\", LC_TIME = \"C\", LANGUAGE = \"en\")\n"
1955 :     "library(\"tools\")\n"
1956 :     "testInstalledBasic(\"both\")\n"
1957 :     "testInstalledPackages(scope = \"base\")\n"
1958 :     "testInstalledPackages(scope = \"recommended\")\n"
1959 :     msgstr ""
1960 :    
1961 :     #. type: Plain text
1962 :     #: R-admin.texi:998
1963 :     msgid ""
1964 :     "runs the basic tests and then all the tests on the standard and recommended "
1965 :     "packages. These tests can be run from anywhere: the basic tests write their "
1966 :     "results in the @file{tests} folder of the @R{} home directory and run "
1967 :     "slightly fewer tests than the first approach: in particular they do not test "
1968 :     "Internet access."
1969 :     msgstr ""
1970 :    
1971 :     #. type: Plain text
1972 :     #: R-admin.texi:1001
1973 :     msgid ""
1974 :     "These tests work best if @command{diff} (in @file{Rtools*.exe} for Windows "
1975 :     "users) is in the path."
1976 :     msgstr ""
1977 :    
1978 :     #. type: Plain text
1979 :     #: R-admin.texi:1005
1980 :     msgid ""
1981 :     "It is possible to test the installed packages (but not the package-specific "
1982 :     "tests) by @code{testInstalledPackages} even if @command{make install-tests} "
1983 :     "was not run."
1984 :     msgstr ""
1985 :    
1986 :     #. type: Plain text
1987 :     #: R-admin.texi:1009
1988 :     msgid ""
1989 :     "Note that the results may depend on the language set for times and messages: "
1990 :     "for maximal similarity to reference results you may want to try setting "
1991 :     "(before starting the @R{} session)"
1992 :     msgstr ""
1993 :    
1994 :     #. type: example
1995 :     #: R-admin.texi:1012
1996 :     #, no-wrap
1997 :     msgid "LANGUAGE=en\n"
1998 :     msgstr ""
1999 :    
2000 :     #. type: Plain text
2001 :     #: R-admin.texi:1016
2002 :     msgid "but use a UTF-8 or Latin-1 locale."
2003 :     msgstr ""
2004 :    
2005 :     #. type: cindex
2006 :     #: R-admin.texi:1020
2007 :     #, no-wrap
2008 :     msgid "Installing under Windows"
2009 :     msgstr ""
2010 :    
2011 :     #. type: Plain text
2012 :     #: R-admin.texi:1026
2013 :     msgid ""
2014 :     "The @file{bin/windows} directory of a @acronym{CRAN} site contains binaries "
2015 :     "for a base distribution and a large number of add-on packages from "
2016 :     "@acronym{CRAN} to run on 32- or 64-bit Windows (XP or later) on "
2017 :     "@cputype{ix86} and @cputype{x86_64} @acronym{CPU}s."
2018 :     msgstr ""
2019 :    
2020 :     #. type: Plain text
2021 :     #: R-admin.texi:1029
2022 :     msgid ""
2023 :     "Your file system must allow long file names (as is likely except perhaps for "
2024 :     "some network-mounted systems)."
2025 :     msgstr ""
2026 :    
2027 :     #. type: Plain text
2028 :     #: R-admin.texi:1035
2029 :     msgid ""
2030 :     "Installation is @emph{via} the installer @file{@value{RWVERSION}-win.exe}. "
2031 :     "Just double-click on the icon and follow the instructions. When installing "
2032 :     "on a 64-bit version of Windows the options will include 32- or 64-bit "
2033 :     "versions of R (and the default is to install both). You can uninstall @R{} "
2034 :     "from the Control Panel."
2035 :     msgstr ""
2036 :    
2037 :     #. type: Plain text
2038 :     #: R-admin.texi:1039
2039 :     msgid ""
2040 :     "Note that you will be asked to choose a language for installation, and that "
2041 :     "choice applies to both installation and un-installation but not to running "
2042 :     "@R{} itself."
2043 :     msgstr ""
2044 :    
2045 :     #. type: Plain text
2046 :     #: R-admin.texi:1042
2047 :     msgid ""
2048 :     "See the @uref{http://CRAN.R-project.org/@/bin/@/windows/@/base/@/rw-FAQ."
2049 :     "html, R Windows @acronym{FAQ}} for more details on the binary installer."
2050 :     msgstr ""
2051 :    
2052 :     #. type: node
2053 :     #: R-admin.texi:1046
2054 :     #: R-admin.texi:1048
2055 :     #: R-admin.texi:1049
2056 :     #: R-admin.texi:1084
2057 :     #: R-admin.texi:1100
2058 :     #: R-admin.texi:1195
2059 :     #: R-admin.texi:1247
2060 :     #: R-admin.texi:1265
2061 :     #: R-admin.texi:1291
2062 :     #: R-admin.texi:1334
2063 :     #: R-admin.texi:1368
2064 :     #: R-admin.texi:1468
2065 :     #: R-admin.texi:1514
2066 :     #: R-admin.texi:1532
2067 :     #, no-wrap
2068 :     msgid "Building from source"
2069 :     msgstr ""
2070 :    
2071 :     #. type: node
2072 :     #: R-admin.texi:1046
2073 :     #: R-admin.texi:1048
2074 :     #: R-admin.texi:1532
2075 :     #, no-wrap
2076 :     msgid "Testing a Windows Installation"
2077 :     msgstr ""
2078 :    
2079 :     #. type: Plain text
2080 :     #: R-admin.texi:1054
2081 :     msgid ""
2082 :     "@R{} can be built as either a 32-bit or 64-bit application on Windows: to "
2083 :     "build the 64-bit application you need a 64-bit edition of Windows: such an "
2084 :     "OS can also be used to build 32-bit @R{}."
2085 :     msgstr ""
2086 :    
2087 :     #. type: Plain text
2088 :     #: R-admin.texi:1059
2089 :     msgid ""
2090 :     "The standard installer combines 32-bit and 64-bit builds into a single "
2091 :     "executable which can then be installed into the same location and share all "
2092 :     "the files except the @file{.exe} and @file{.dll} files and some "
2093 :     "configuration files in the @file{etc} directory."
2094 :     msgstr ""
2095 :    
2096 :     #. type: Plain text
2097 :     #: R-admin.texi:1063
2098 :     msgid ""
2099 :     "Building is only tested in a 8-bit locale: using a multi-byte locale (as "
2100 :     "used for CJK languages) is unsupported and may not work (the scripts do try "
2101 :     "to select a @samp{C} locale; Windows may not honour this)."
2102 :     msgstr ""
2103 :    
2104 :     #. type: Plain text
2105 :     #: R-admin.texi:1070
2106 :     msgid ""
2107 :     "@strong{NB:} The build process is currently being changed to require "
2108 :     "external binary distributions of third-party software. Their location must "
2109 :     "be set using macro @code{EXT_LIBS} in @file{src/gnuwin32/MkRules.local}: a "
2110 :     "suitable distribution can be obtained from @uref{http://www.stats.ox.ac.uk/@/"
2111 :     "pub/@/Rtools/@/libs.html}."
2112 :     msgstr ""
2113 :    
2114 :     #. type: node
2115 :     #: R-admin.texi:1082
2116 :     #: R-admin.texi:1084
2117 :     #: R-admin.texi:1085
2118 :     #: R-admin.texi:1100
2119 :     #, no-wrap
2120 :     msgid "Getting the tools"
2121 :     msgstr ""
2122 :    
2123 :     #. type: node
2124 :     #: R-admin.texi:1082
2125 :     #: R-admin.texi:1084
2126 :     #: R-admin.texi:1100
2127 :     #: R-admin.texi:1101
2128 :     #: R-admin.texi:1195
2129 :     #, no-wrap
2130 :     msgid "Getting the source files"
2131 :     msgstr ""
2132 :    
2133 :     #. type: node
2134 :     #: R-admin.texi:1082
2135 :     #: R-admin.texi:1100
2136 :     #: R-admin.texi:1195
2137 :     #: R-admin.texi:1196
2138 :     #: R-admin.texi:1247
2139 :     #, no-wrap
2140 :     msgid "Building the core files"
2141 :     msgstr ""
2142 :    
2143 :     #. type: node
2144 :     #: R-admin.texi:1082
2145 :     #: R-admin.texi:1195
2146 :     #: R-admin.texi:1247
2147 :     #: R-admin.texi:1265
2148 :     #, no-wrap
2149 :     msgid "Building the cairo devices files"
2150 :     msgstr ""
2151 :    
2152 :     #. type: node
2153 :     #: R-admin.texi:1082
2154 :     #: R-admin.texi:1247
2155 :     #: R-admin.texi:1265
2156 :     #: R-admin.texi:1266
2157 :     #: R-admin.texi:1291
2158 :     #, no-wrap
2159 :     msgid "Using ICU for collation"
2160 :     msgstr ""
2161 :    
2162 :     #. type: node
2163 :     #: R-admin.texi:1082
2164 :     #: R-admin.texi:1265
2165 :     #: R-admin.texi:1291
2166 :     #: R-admin.texi:1292
2167 :     #: R-admin.texi:1334
2168 :     #, no-wrap
2169 :     msgid "Checking the build"
2170 :     msgstr ""
2171 :    
2172 :     #. type: node
2173 :     #: R-admin.texi:1082
2174 :     #: R-admin.texi:1291
2175 :     #: R-admin.texi:1334
2176 :     #: R-admin.texi:1335
2177 :     #: R-admin.texi:1368
2178 :     #, no-wrap
2179 :     msgid "Building the manuals"
2180 :     msgstr ""
2181 :    
2182 :     #. type: node
2183 :     #: R-admin.texi:1082
2184 :     #: R-admin.texi:1334
2185 :     #: R-admin.texi:1368
2186 :     #: R-admin.texi:1369
2187 :     #: R-admin.texi:1468
2188 :     #, no-wrap
2189 :     msgid "Building the Inno Setup installer"
2190 :     msgstr ""
2191 :    
2192 :     #. type: node
2193 :     #: R-admin.texi:1082
2194 :     #: R-admin.texi:1368
2195 :     #: R-admin.texi:1468
2196 :     #: R-admin.texi:1469
2197 :     #: R-admin.texi:1514
2198 :     #, no-wrap
2199 :     msgid "Building the MSI installer"
2200 :     msgstr ""
2201 :    
2202 :     #. type: subsection
2203 :     #: R-admin.texi:1082
2204 :     #: R-admin.texi:1468
2205 :     #: R-admin.texi:1514
2206 :     #: R-admin.texi:1515
2207 :     #, no-wrap
2208 :     msgid "64-bit Windows builds"
2209 :     msgstr ""
2210 :    
2211 :     #. type: Plain text
2212 :     #: R-admin.texi:1091
2213 :     msgid ""
2214 :     "If you want to build @R{} from the sources, you will first need to collect, "
2215 :     "install and test an extensive set of tools. See @ref{The Windows toolset} "
2216 :     "(and perhaps updates in @uref{http://CRAN.R-project.org/bin/@/windows/@/"
2217 :     "Rtools/}) for details."
2218 :     msgstr ""
2219 :    
2220 :     #. type: Plain text
2221 :     #: R-admin.texi:1099
2222 :     msgid ""
2223 :     "The @file{Rtools*.exe} executable installer described in @ref{The Windows "
2224 :     "toolset} also includes some source files in addition to the @R{} source as "
2225 :     "noted below. You should run it first, to obtain a working @code{tar} and "
2226 :     "other necessities. Choose a ``Full installation'', and install the extra "
2227 :     "files into your intended @R{} source directory, e.g.@: @file{C:/R}. The "
2228 :     "directory name @emph{should not contain spaces}. We will call this directory "
2229 :     "@file{@var{R_HOME}} below."
2230 :     msgstr ""
2231 :    
2232 :     #. type: Plain text
2233 :     #: R-admin.texi:1104
2234 :     msgid "You need to collect the following sets of files:"
2235 :     msgstr ""
2236 :    
2237 :     #. type: itemize
2238 :     #: R-admin.texi:1110
2239 :     msgid ""
2240 :     "Get the @R{} source code tarball @file{R-@value{VERSIONno}.tar.gz} from "
2241 :     "@acronym{CRAN}. Open a command window (or another shell) at directory "
2242 :     "@var{R_HOME}, and run"
2243 :     msgstr ""
2244 :    
2245 :     #. type: example
2246 :     #: R-admin.texi:1113
2247 :     #, no-wrap
2248 :     msgid "tar -xf R-@value{VERSIONno}.tar.gz\n"
2249 :     msgstr ""
2250 :    
2251 :     #. type: itemize
2252 :     #: R-admin.texi:1120
2253 :     msgid ""
2254 :     "to create the source tree in @var{R_HOME}. @strong{Beware}: do use "
2255 :     "@command{tar} to extract the sources rather than tools such as WinZip. If "
2256 :     "you are using an account with administrative privileges you may get a lot of "
2257 :     "messages which can be suppressed by"
2258 :     msgstr ""
2259 :    
2260 :     #. type: example
2261 :     #: R-admin.texi:1123
2262 :     #, no-wrap
2263 :     msgid "tar --no-same-owner -xf R-@value{VERSIONno}.tar.gz\n"
2264 :     msgstr ""
2265 :    
2266 :     #. type: itemize
2267 :     #: R-admin.texi:1129
2268 :     msgid ""
2269 :     "or perhaps better, set the environment variable @env{TAR_OPTIONS} to the "
2270 :     "value @samp{--no-same-owner --no-same-permissions}."
2271 :     msgstr ""
2272 :    
2273 :     #. type: itemize
2274 :     #: R-admin.texi:1132
2275 :     msgid ""
2276 :     "It is also possible to obtain the source code using Subversion; see "
2277 :     "@ref{Obtaining R} for details."
2278 :     msgstr ""
2279 :    
2280 :     #. type: itemize
2281 :     #: R-admin.texi:1140
2282 :     msgid ""
2283 :     "If you are not using a tarball you need to obtain copies of the recommended "
2284 :     "packages from @acronym{CRAN}. Put the @file{.tar.gz} files in "
2285 :     "@file{@var{R_HOME}/src/library/Recommended} and run @code{make link-"
2286 :     "recommended}. If you have an Internet connection, you can do this "
2287 :     "automatically by running in @file{@var{R_HOME}/src/gnuwin32}"
2288 :     msgstr ""
2289 :    
2290 :     #. type: example
2291 :     #: R-admin.texi:1143
2292 :     #, no-wrap
2293 :     msgid "make rsync-recommended\n"
2294 :     msgstr ""
2295 :    
2296 :     #. type: itemize
2297 :     #: R-admin.texi:1147
2298 :     msgid "The binary distributions of external software. Download"
2299 :     msgstr ""
2300 :    
2301 :     #. type: example
2302 :     #: R-admin.texi:1150
2303 :     #, no-wrap
2304 :     msgid "http://www.stats.ox.ac.uk/pub/Rtools/goodies/multilib/local320.zip\n"
2305 :     msgstr ""
2306 :    
2307 :     #. type: itemize
2308 :     #: R-admin.texi:1155
2309 :     msgid ""
2310 :     "create an empty directory, say @file{c:/R/extsoft}, and unpack it in that "
2311 :     "directory by e.g.@:"
2312 :     msgstr ""
2313 :    
2314 :     #. type: example
2315 :     #: R-admin.texi:1158
2316 :     #, no-wrap
2317 :     msgid "unzip local320.zip -d c:/R/extsoft\n"
2318 :     msgstr ""
2319 :    
2320 :     #. type: itemize
2321 :     #: R-admin.texi:1162
2322 :     msgid "Make a local copy of the configuration rules by"
2323 :     msgstr ""
2324 :    
2325 :     #. type: example
2326 :     #: R-admin.texi:1166
2327 :     #, no-wrap
2328 :     msgid ""
2329 :     "cd @var{R_HOME}/src/gnuwin32\n"
2330 :     "cp MkRules.dist MkRules.local\n"
2331 :     msgstr ""
2332 :    
2333 :     #. type: itemize
2334 :     #: R-admin.texi:1171
2335 :     msgid ""
2336 :     "and edit @file{MkRules.local}, uncommenting @code{EXT_LIBS} and setting it "
2337 :     "to the appropriate path (in our example @file{c:/R/extsoft})."
2338 :     msgstr ""
2339 :    
2340 :     #. type: itemize
2341 :     #: R-admin.texi:1176
2342 :     msgid ""
2343 :     "Look through the file @file{MkRules.local} and make any other changes "
2344 :     "needed: in particular, this is where a 64-bit build is selected and the "
2345 :     "locations are set of external software for ICU collation and the cairo-based "
2346 :     "devices."
2347 :     msgstr ""
2348 :    
2349 :     #. type: Plain text
2350 :     #: R-admin.texi:1182
2351 :     msgid ""
2352 :     "The following additional item is normally installed by @file{Rtools31.exe}. "
2353 :     "If instead you choose to do a completely manual build you will also need"
2354 :     msgstr ""
2355 :    
2356 :     #. type: itemize
2357 :     #: R-admin.texi:1192
2358 :     msgid ""
2359 :     "The Tcl/Tk support files are contained in @file{Rtools31.exe} and available "
2360 :     "as @file{.zip} files from @uref{http://www.stats.ox.ac.uk/pub/Rtools}. "
2361 :     "Please make sure you install the right version: there is a 32-bit version "
2362 :     "and a 64-bit version. They should be installed to @file{@var{R_HOME}}, "
2363 :     "creating directory @file{Tcl} there."
2364 :     msgstr ""
2365 :    
2366 :     #. type: Plain text
2367 :     #: R-admin.texi:1203
2368 :     msgid ""
2369 :     "Set the environment variable @env{TMPDIR} to the absolute path to a writable "
2370 :     "directory, with a path specified with forward slashes and no spaces. (The "
2371 :     "default is @file{/tmp}, which may not be useful on Windows.)"
2372 :     msgstr ""
2373 :    
2374 :     #. type: Plain text
2375 :     #: R-admin.texi:1207
2376 :     msgid ""
2377 :     "You may need to compile under a case-honouring file system: we found that a "
2378 :     "@command{samba}-mounted file system (which maps all file names to lower "
2379 :     "case) did not work."
2380 :     msgstr ""
2381 :    
2382 :     #. type: Plain text
2383 :     #: R-admin.texi:1209
2384 :     msgid "Open a command window at @file{@var{R_HOME}/src/gnuwin32}, then run"
2385 :     msgstr ""
2386 :    
2387 :     #. type: example
2388 :     #: R-admin.texi:1212
2389 :     #, no-wrap
2390 :     msgid "make all recommended vignettes\n"
2391 :     msgstr ""
2392 :    
2393 :     #. type: Plain text
2394 :     #: R-admin.texi:1216
2395 :     msgid "and sit back and wait while the basic compile takes place."
2396 :     msgstr ""
2397 :    
2398 :     #. type: Plain text
2399 :     #: R-admin.texi:1218
2400 :     msgid "Notes:"
2401 :     msgstr ""
2402 :    
2403 :     #. type: itemize
2404 :     #: R-admin.texi:1225
2405 :     msgid ""
2406 :     "We have had reports that earlier versions of anti-virus software locking up "
2407 :     "the machine, but not for several years. However, aggressive anti-virus "
2408 :     "checking such as the on-access scanning of Sophos can slow the build down "
2409 :     "several-fold."
2410 :     msgstr ""
2411 :    
2412 :     #. type: itemize
2413 :     #: R-admin.texi:1228
2414 :     msgid "You can run a parallel make by e.g."
2415 :     msgstr ""
2416 :    
2417 :     #. type: example
2418 :     #: R-admin.texi:1233
2419 :     #, no-wrap
2420 :     msgid ""
2421 :     "make -j4 all\n"
2422 :     "make -j4 recommended\n"
2423 :     "make vignettes\n"
2424 :     msgstr ""
2425 :    
2426 :     #. type: itemize
2427 :     #: R-admin.texi:1238
2428 :     msgid ""
2429 :     "but this is only likely to be worthwhile on a multi-core machine with ample "
2430 :     "memory, and is not 100% reliable."
2431 :     msgstr ""
2432 :    
2433 :     #. type: itemize
2434 :     #: R-admin.texi:1244
2435 :     msgid ""
2436 :     "It is possible (mainly for those working on @R{} itself) to set the (make or "
2437 :     "environment) variable @env{R_NO_BASE_COMPILE} to a non-empty value, which "
2438 :     "inhibits the byte-compilation of the base and recommended packages."
2439 :     msgstr ""
2440 :    
2441 :     #. type: subsection
2442 :     #: R-admin.texi:1248
2443 :     #, no-wrap
2444 :     msgid "Building the cairo devices"
2445 :     msgstr ""
2446 :    
2447 :     #. type: cindex
2448 :     #: R-admin.texi:1249
2449 :     #, no-wrap
2450 :     msgid "winCairo.dll"
2451 :     msgstr ""
2452 :    
2453 :     #. type: Plain text
2454 :     #: R-admin.texi:1257
2455 :     msgid ""
2456 :     "The devices based on cairographics (@code{svg}, @code{cairo_pdf}, "
2457 :     "@code{cairo_ps} and the @code{type = \"cairo\"} versions of @code{png}, "
2458 :     "@code{jpeg}, @code{tiff} and @code{bmp}) are implemented in a separate DLL "
2459 :     "@file{winCairo.dll} which is loaded when one of these devices is first "
2460 :     "used. It is not built by default, and needs to be built (after "
2461 :     "@command{make all}) by @command{make cairodevices}."
2462 :     msgstr ""
2463 :    
2464 :     #. type: Plain text
2465 :     #: R-admin.texi:1264
2466 :     msgid ""
2467 :     "To enable the building of these devices you need to install the static "
2468 :     "cairographics libraries built by Simon Urbanek at @uref{http://www.rforge."
2469 :     "net/Cairo/files/cairo-current-win.tar.gz}. Set the macro @samp{CAIRO_HOME} "
2470 :     "in @file{MkRules.local}. (Note that this tarball unpacks with a top-level "
2471 :     "directory @file{src/}: @samp{CAIRO_HOME} needs to include that directory in "
2472 :     "its path.)"
2473 :     msgstr ""
2474 :    
2475 :     #. type: Plain text
2476 :     #: R-admin.texi:1271
2477 :     msgid ""
2478 :     "It is recommended to build @R{} to support ICU (International Components for "
2479 :     "Unicode, @uref{http://site.icu-project.org/}) for collation, as is commonly "
2480 :     "done on Unix-alikes."
2481 :     msgstr ""
2482 :    
2483 :     #. type: Plain text
2484 :     #: R-admin.texi:1273
2485 :     msgid "Two settings are needed in @file{MkRules.local},"
2486 :     msgstr ""
2487 :    
2488 :     #. type: example
2489 :     #: R-admin.texi:1278
2490 :     #, no-wrap
2491 :     msgid ""
2492 :     "# set to use ICU\n"
2493 :     "# USE_ICU = YES\n"
2494 :     "# path to parent of ICU headers\n"
2495 :     "ICU_PATH = /path/to/ICU\n"
2496 :     msgstr ""
2497 :    
2498 :     #. type: Plain text
2499 :     #: R-admin.texi:1286
2500 :     msgid ""
2501 :     "The first should be uncommented and the second set to the top-level "
2502 :     "directory of a suitably packaged binary build of ICU, for example that at "
2503 :     "@url{http://www.stats.ox.ac.uk/pub/Rtools/goodies/ICU_531.zip}. Depending "
2504 :     "on the build, it may be necessary to edit the macro @code{ICU_LIBS}."
2505 :     msgstr ""
2506 :    
2507 :     #. type: Plain text
2508 :     #: R-admin.texi:1290
2509 :     msgid ""
2510 :     "Unlike on a Unix-alike, it is normally necessary to call "
2511 :     "@code{icuSetCollate} to set a locale before ICU is actually used for "
2512 :     "collation, or set the environment variable @env{R_ICU_LOCALE}."
2513 :     msgstr ""
2514 :    
2515 :     #. type: Plain text
2516 :     #: R-admin.texi:1295
2517 :     msgid "You can test a build by running"
2518 :     msgstr ""
2519 :    
2520 :     #. type: Plain text
2521 :     #: R-admin.texi:1302
2522 :     msgid "The recommended packages can be checked by"
2523 :     msgstr ""
2524 :    
2525 :     #. type: example
2526 :     #: R-admin.texi:1305
2527 :     #, no-wrap
2528 :     msgid "make check-recommended\n"
2529 :     msgstr ""
2530 :    
2531 :     #. type: Plain text
2532 :     #: R-admin.texi:1309
2533 :     msgid "Other levels of checking are"
2534 :     msgstr ""
2535 :    
2536 :     #. type: Plain text
2537 :     #: R-admin.texi:1316
2538 :     msgid "for a more thorough check of the @R{} functionality, and"
2539 :     msgstr ""
2540 :    
2541 :     #. type: Plain text
2542 :     #: R-admin.texi:1323
2543 :     msgid "for both @code{check-devel} and @code{check-recommended}."
2544 :     msgstr ""
2545 :    
2546 :     #. type: Plain text
2547 :     #: R-admin.texi:1327
2548 :     msgid ""
2549 :     "If a test fails, there will almost always be a @file{.Rout.fail} file in the "
2550 :     "directory being checked (often @file{tests/Examples} or @file{tests}): "
2551 :     "examine the file to help pinpoint the problem."
2552 :     msgstr ""
2553 :    
2554 :     #. type: Plain text
2555 :     #: R-admin.texi:1332
2556 :     msgid ""
2557 :     "Parallel checking of package sources (part of @command{make check-devel} and "
2558 :     "@command{make check-recommended}) is possible: see the environment variable "
2559 :     "@env{TEST_MC_CORES} to the maximum number of processes to be run in parallel."
2560 :     msgstr ""
2561 :    
2562 :     #. type: Plain text
2563 :     #: R-admin.texi:1338
2564 :     msgid "The PDF manuals can be made by"
2565 :     msgstr ""
2566 :    
2567 :     #. type: example
2568 :     #: R-admin.texi:1341
2569 :     #, no-wrap
2570 :     msgid "make manuals\n"
2571 :     msgstr ""
2572 :    
2573 :     #. type: Plain text
2574 :     #: R-admin.texi:1346
2575 :     msgid ""
2576 :     "If you want to make the info versions (not including the Reference Manual), "
2577 :     "use"
2578 :     msgstr ""
2579 :    
2580 :     #. type: example
2581 :     #: R-admin.texi:1350
2582 :     #, no-wrap
2583 :     msgid ""
2584 :     "cd ../../doc/manual\n"
2585 :     "make -f Makefile.win info\n"
2586 :     msgstr ""
2587 :    
2588 :     #. type: Plain text
2589 :     #: R-admin.texi:1355
2590 :     msgid ""
2591 :     "(all assuming you have @command{pdftex}/@command{pdflatex} installed and in "
2592 :     "your path)."
2593 :     msgstr ""
2594 :    
2595 :     #. type: Plain text
2596 :     #: R-admin.texi:1358
2597 :     msgid ""
2598 :     "See the @ref{Making the manuals} section in the Unix-alike section for "
2599 :     "setting options such as the paper size and the fonts used."
2600 :     msgstr ""
2601 :    
2602 :     #. type: Plain text
2603 :     #: R-admin.texi:1367
2604 :     msgid ""
2605 :     "Version 4.x of @command{makeinfo} from Rtools is assumed by default. If you "
2606 :     "have version 5.x of @pkg{texinfo}, @command{makeinfo} has been replaced by a "
2607 :     "@command{Perl} script @command{texi2any}: file @file{MkRules.dist} contains "
2608 :     "alternative macros to allow that to be used (edit the copy @file{MkRules."
2609 :     "local}). (A package of @pkg{texinfo} 5.x for use on Windows is available at "
2610 :     "@uref{http://www.stats.ox.ac.uk/pub/Rtools/}: you will also need to install "
2611 :     "@command{Perl}.)"
2612 :     msgstr ""
2613 :    
2614 :     #. type: Plain text
2615 :     #: R-admin.texi:1374
2616 :     msgid ""
2617 :     "You need to have the files for a complete R build, including bitmap and Tcl/"
2618 :     "Tk support and the manuals, as well as the recommended packages and Inno "
2619 :     "Setup (@pxref{The Inno Setup installer})."
2620 :     msgstr ""
2621 :    
2622 :     #. type: Plain text
2623 :     #: R-admin.texi:1376
2624 :     msgid "Once everything is set up"
2625 :     msgstr ""
2626 :    
2627 :     #. type: example
2628 :     #: R-admin.texi:1380
2629 :     #, no-wrap
2630 :     msgid ""
2631 :     "make distribution\n"
2632 :     "make check-all\n"
2633 :     msgstr ""
2634 :    
2635 :     #. type: Plain text
2636 :     #: R-admin.texi:1386
2637 :     msgid ""
2638 :     "will make all the pieces and the installer and put them in the "
2639 :     "@file{gnuwin32/cran} subdirectory, then check the build. This works by "
2640 :     "building all the parts in the sequence:"
2641 :     msgstr ""
2642 :    
2643 :     #. type: example
2644 :     #: R-admin.texi:1398
2645 :     #, no-wrap
2646 :     msgid ""
2647 :     "rbuild @r{(the executables, the @acronym{FAQ} docs etc.)}\n"
2648 :     "rpackages @r{(the base packages)}\n"
2649 :     "htmldocs @r{(the HTML documentation)}\n"
2650 :     "cairodevices @r{(the cairo-based graphics devices)}\n"
2651 :     "recommended @r{(the recommended packages)}\n"
2652 :     "vignettes @r{(the vignettes in base packages:}\n"
2653 :     "\t @r{ only needed if building from an @command{svn} checkout)}\n"
2654 :     "manuals @r{(the PDF manuals)}\n"
2655 :     "rinstaller @r{(the install program)}\n"
2656 :     "crandir @r{(the @acronym{CRAN} distribution directory, only for 64-bit builds)}\n"
2657 :     msgstr ""
2658 :    
2659 :     #. type: Plain text
2660 :     #: R-admin.texi:1406
2661 :     msgid ""
2662 :     "The parts can be made individually if a full build is not needed, but "
2663 :     "earlier parts must be built before later ones. (The @file{Makefile} doesn't "
2664 :     "enforce this dependency---some build targets force a lot of computation even "
2665 :     "if all files are up to date.) The first four targets are the default build "
2666 :     "if just @command{make} (or @command{make all}) is run."
2667 :     msgstr ""
2668 :    
2669 :     #. type: Plain text
2670 :     #: R-admin.texi:1408
2671 :     msgid "Parallel make is not supported and likely to fail."
2672 :     msgstr ""
2673 :    
2674 :     #. type: Plain text
2675 :     #: R-admin.texi:1411
2676 :     msgid ""
2677 :     "If you want to customize the installation by adding extra packages, replace "
2678 :     "@code{make rinstaller} by something like"
2679 :     msgstr ""
2680 :    
2681 :     #. type: example
2682 :     #: R-admin.texi:1414
2683 :     #, no-wrap
2684 :     msgid "make rinstaller EXTRA_PKGS='pkg1 pkg2 pkg3'\n"
2685 :     msgstr ""
2686 :    
2687 :     #. type: Plain text
2688 :     #: R-admin.texi:1423
2689 :     msgid ""
2690 :     "An alternative way to customize the installer starting with a binary "
2691 :     "distribution is to first make an installation of R from the standard "
2692 :     "installer, then add packages and make other customizations to that "
2693 :     "installation. Then (after having customized file @file{MkRules}, possibly "
2694 :     "@emph{via} @file{MkRules.local}, and having made R in the source tree) in "
2695 :     "@file{src/gnuwin32/installer} run"
2696 :     msgstr ""
2697 :    
2698 :     #. type: example
2699 :     #: R-admin.texi:1426
2700 :     #, no-wrap
2701 :     msgid "make myR IMAGEDIR=rootdir\n"
2702 :     msgstr ""
2703 :    
2704 :     #. type: Plain text
2705 :     #: R-admin.texi:1431
2706 :     msgid ""
2707 :     "where @file{rootdir} is the path to the root of the customized installation "
2708 :     "(in double quotes if it contains spaces or backslashes)."
2709 :     msgstr ""
2710 :    
2711 :     #. type: Plain text
2712 :     #: R-admin.texi:1441
2713 :     msgid ""
2714 :     "Both methods create an executable with a standard name such as "
2715 :     "@file{@value{RWVERSION}-win.exe}, so please rename it to indicate that it is "
2716 :     "customized. If you intend to @emph{distribute} a customized installer "
2717 :     "please do check that license requirements are met -- note that the installer "
2718 :     "will state that the contents are distributed under GPL and this has a "
2719 :     "requirement for @emph{you} to supply the complete sources (including the R "
2720 :     "sources even if you started with a binary distribution of R, and also the "
2721 :     "sources of any extra packages (including their external software) which are "
2722 :     "included)."
2723 :     msgstr ""
2724 :    
2725 :     #. type: Plain text
2726 :     #: R-admin.texi:1444
2727 :     msgid ""
2728 :     "The defaults for the startup parameters may also be customized. For example"
2729 :     msgstr ""
2730 :    
2731 :     #. type: example
2732 :     #: R-admin.texi:1447
2733 :     #, no-wrap
2734 :     msgid "make myR IMAGEDIR=rootdir MDISDI=1\n"
2735 :     msgstr ""
2736 :    
2737 :     #. type: Plain text
2738 :     #: R-admin.texi:1453
2739 :     msgid ""
2740 :     "will create an installer that defaults to installing @R{} to run in SDI "
2741 :     "mode. See @file{src/@/gnuwin32/installer/Makefile} for the names and values "
2742 :     "that can be set."
2743 :     msgstr ""
2744 :    
2745 :     #. type: Plain text
2746 :     #: R-admin.texi:1456
2747 :     msgid ""
2748 :     "The standard @acronym{CRAN} distribution of a 32/64-bit installer is made by "
2749 :     "first building 32-bit R (just"
2750 :     msgstr ""
2751 :    
2752 :     #. type: example
2753 :     #: R-admin.texi:1459
2754 :     #, no-wrap
2755 :     msgid "make 32-bit\n"
2756 :     msgstr ""
2757 :    
2758 :     #. type: Plain text
2759 :     #: R-admin.texi:1467
2760 :     msgid ""
2761 :     "is needed), and then (in a separate directory) building 64-bit R with the "
2762 :     "macro @code{HOME32} set in file @file{MkRules.local} to the top-level "
2763 :     "directory of the 32-bit build. Then the @command{make rinstaller} step "
2764 :     "copies the files that differ between architectures from the 32-bit build as "
2765 :     "it builds the installer image."
2766 :     msgstr ""
2767 :    
2768 :     #. type: Plain text
2769 :     #: R-admin.texi:1474
2770 :     msgid ""
2771 :     "It is also possible to build an installer for use with Microsoft Installer. "
2772 :     "This is intended for use by sysadmins doing automated installs, and is not "
2773 :     "recommended for casual use."
2774 :     msgstr ""
2775 :    
2776 :     #. type: Plain text
2777 :     #: R-admin.texi:1480
2778 :     msgid ""
2779 :     "It makes use of the Windows Installer XML (WiX) toolkit @emph{version 3.5} "
2780 :     "(or perhaps later, untested) available from @uref{http://wix.sourceforge."
2781 :     "net/} or @uref{http://wixtoolset.org/}. Once WiX is installed, set the path "
2782 :     "to its home directory in @file{MkRules.local}."
2783 :     msgstr ""
2784 :    
2785 :     #. type: Plain text
2786 :     #: R-admin.texi:1486
2787 :     msgid ""
2788 :     "You need to have the files for a complete R build, including bitmap and Tcl/"
2789 :     "Tk support and the manuals, as well as the recommended packages. There is "
2790 :     "no option in the installer to customize startup options, so edit @file{etc/"
2791 :     "Rconsole} and @file{etc/Rprofile.site} to set these as required. Then"
2792 :     msgstr ""
2793 :    
2794 :     #. type: example
2795 :     #: R-admin.texi:1490
2796 :     #, no-wrap
2797 :     msgid ""
2798 :     "cd installer\n"
2799 :     "make msi\n"
2800 :     msgstr ""
2801 :    
2802 :     #. type: Plain text
2803 :     #: R-admin.texi:1503
2804 :     msgid ""
2805 :     "which will result in a file with a name like @file{@value{RWVERSION}-win32."
2806 :     "msi}. This can be double-clicked to be installed, but those who need it "
2807 :     "will know what to do with it (usually by running @command{msiexec /i} with "
2808 :     "additional options). Properties that users might want to set from the "
2809 :     "@command{msiexec} command line include @samp{ALLUSERS}, @samp{INSTALLDIR} "
2810 :     "(something like @file{c:\\Program Files\\R\\@value{RWVERSION}}) and "
2811 :     "@samp{RMENU} (the path to the @samp{R} folder on the start menu) and "
2812 :     "@samp{STARTDIR} (the starting directory for @R{} shortcuts, defaulting to "
2813 :     "something like @file{c:\\Users\\name\\Documents\\R})."
2814 :     msgstr ""
2815 :    
2816 :     #. type: Plain text
2817 :     #: R-admin.texi:1510
2818 :     msgid ""
2819 :     "The MSI installer can be built both from a 32-bit build of @R{} "
2820 :     "(@file{@value{RWVERSION}-win32.msi}) and from a 64-bit build of @R{} "
2821 :     "(@file{@value{RWVERSION}-win64.msi}, optionally including 32-bit files by "
2822 :     "setting the macro @code{HOME32}, when the name is @file{@value{RWVERSION}-"
2823 :     "win.msi}). Unlike the main installer, a 64-bit MSI installer can only be "
2824 :     "run on 64-bit Windows."
2825 :     msgstr ""
2826 :    
2827 :     #. type: Plain text
2828 :     #: R-admin.texi:1513
2829 :     msgid ""
2830 :     "Thanks to David del Campo (Dept of Statistics, University of Oxford) for "
2831 :     "suggesting WiX and building a prototype installer."
2832 :     msgstr ""
2833 :    
2834 :     #. type: Plain text
2835 :     #: R-admin.texi:1522
2836 :     msgid ""
2837 :     "To build a 64-bit version of R you need a 64-bit toolchain: the only one "
2838 :     "discussed here is based on the work of the MinGW-w64 project (@uref{http://"
2839 :     "sourceforge.net/@/projects/@/mingw-w64/}, but commercial compilers such as "
2840 :     "those from Intel and PGI could be used (and have been by @R{} "
2841 :     "redistributors)."
2842 :     msgstr ""
2843 :    
2844 :     #. type: Plain text
2845 :     #: R-admin.texi:1528
2846 :     msgid ""
2847 :     "Support for MinGW-w64 was developed in the R sources over the period "
2848 :     "2008--10 and was first released as part of @R{} 2.11.0. The assistance of "
2849 :     "Yu Gong at a crucial step in porting R to MinGW-w64 is gratefully "
2850 :     "acknowledged, as well as help from Kai Tietz, the lead developer of the "
2851 :     "MinGW-w64 project."
2852 :     msgstr ""
2853 :    
2854 :     #. type: Plain text
2855 :     #: R-admin.texi:1531
2856 :     msgid ""
2857 :     "Windows 64-bit is now completely integrated into the @R{} and package build "
2858 :     "systems: a 64-bit build is selected in file @file{MkRules.local}."
2859 :     msgstr ""
2860 :    
2861 :     #. type: Plain text
2862 :     #: R-admin.texi:1537
2863 :     msgid ""
2864 :     "The Windows installer contains a set of test files used when building @R{}."
2865 :     msgstr ""
2866 :    
2867 :     #. type: Plain text
2868 :     #: R-admin.texi:1541
2869 :     msgid ""
2870 :     "The @code{Rtools} are not needed to run these tests. but more comprehensive "
2871 :     "analysis of errors will be given if @command{diff} is in the path (and "
2872 :     "@code{errorsAreFatal = FALSE} is then not needed below)."
2873 :     msgstr ""
2874 :    
2875 :     #. type: Plain text
2876 :     #: R-admin.texi:1544
2877 :     msgid ""
2878 :     "Launch either @code{Rgui} or @code{Rterm}, preferably with @option{--"
2879 :     "vanilla}. Then run"
2880 :     msgstr ""
2881 :    
2882 :     #. type: example
2883 :     #: R-admin.texi:1551
2884 :     #, no-wrap
2885 :     msgid ""
2886 :     "Sys.setenv(LC_COLLATE = \"C\", LANGUAGE = \"en\")\n"
2887 :     "library(\"tools\")\n"
2888 :     "testInstalledBasic(\"both\")\n"
2889 :     "testInstalledPackages(scope = \"base\", errorsAreFatal = FALSE)\n"
2890 :     "testInstalledPackages(scope = \"recommended\", errorsAreFatal = FALSE)\n"
2891 :     msgstr ""
2892 :    
2893 :     #. type: Plain text
2894 :     #: R-admin.texi:1559
2895 :     msgid ""
2896 :     "runs the basic tests and then all the tests on the standard and recommended "
2897 :     "packages. These tests can be run from anywhere: they write some of their "
2898 :     "results in the @file{tests} folder of the @R{} home directory (as given by "
2899 :     "@code{R.home()}), and hence may need to be run under the account used to "
2900 :     "install @R{}."
2901 :     msgstr ""
2902 :    
2903 :     #. type: Plain text
2904 :     #: R-admin.texi:1563
2905 :     msgid ""
2906 :     "The results of @code{example(md5sums)} when testing @pkg{tools} will differ "
2907 :     "from the reference output as some files are installed with Windows' CRLF "
2908 :     "line endings."
2909 :     msgstr ""
2910 :    
2911 :     #. type: sc{#1}
2912 :     #: R-admin.texi:1571
2913 :     msgid "R.app"
2914 :     msgstr ""
2915 :    
2916 :     #. type: Plain text
2917 :     #: R-admin.texi:1580
2918 :     msgid ""
2919 :     "The front page of a @acronym{CRAN} site has a link `Download R for OS X'. "
2920 :     "Click on that, then download the file @file{R-@value{VERSIONno}-snowleopard."
2921 :     "pkg} and install it. This runs on OS X 10.6 and later (Snow Leopard, Lion, "
2922 :     "Mountain Lion, Mavericks, Yosemite, @dots{}); it is a 64-bit "
2923 :     "(@cputype{x86_64}) build which should run on all Macs from mid-2008 on. For "
2924 :     "older Intel Macs and some older versions of the OS you can install @R{} from "
2925 :     "the sources."
2926 :     msgstr ""
2927 :    
2928 :     #. type: Plain text
2929 :     #: R-admin.texi:1586
2930 :     msgid ""
2931 :     "There is a separate installer package, @file{R-@value{VERSIONno}-mavericks."
2932 :     "pkg}, for use on Mavericks and Yosemite: the `Snow Leopard' installer "
2933 :     "package also works there and may have more binary packages available (but "
2934 :     "there are a few packages using C++11 and only available for the Mavericks "
2935 :     "build)."
2936 :     msgstr ""
2937 :    
2938 :     #. type: Plain text
2939 :     #: R-admin.texi:1590
2940 :     msgid ""
2941 :     "It is important that if you use a binary installer package that your OS is "
2942 :     "fully updated: run `Software Update' from the Apple menu to be sure. (If "
2943 :     "using XQuartz, check that is current.)"
2944 :     msgstr ""
2945 :    
2946 :     #. type: Plain text
2947 :     #: R-admin.texi:1597
2948 :     msgid ""
2949 :     "To install, just double-click on the icon of the file you downloaded. At "
2950 :     "the `Installation Type' stage, note the option to `Customize'. This "
2951 :     "currently shows three components. Everyone will need the `R Framework' "
2952 :     "component: the `R GUI' and `Tcl/Tk' components are optional (the latter "
2953 :     "being needed to use package @pkg{tcltk}, and requires an X sub-system to be "
2954 :     "installed: @pxref{OS X})."
2955 :     msgstr ""
2956 :    
2957 :     #. type: Plain text
2958 :     #: R-admin.texi:1602
2959 :     msgid ""
2960 :     "This is an Apple Installer package. If you encounter any problem during the "
2961 :     "installation, please check the Installer log by clicking on the ``Window'' "
2962 :     "menu and item ``Installer Log''. The full output (select ``Show All Log'') "
2963 :     "is useful for tracking down problems."
2964 :     msgstr ""
2965 :    
2966 :     #. type: Plain text
2967 :     #: R-admin.texi:1605
2968 :     msgid ""
2969 :     "If you update your OS X version, you should re-install @R{}: the installer "
2970 :     "tailors the installation to the current version of the OS."
2971 :     msgstr ""
2972 :    
2973 :     #. type: Plain text
2974 :     #: R-admin.texi:1607
2975 :     msgid "For building @R{} from source, see @ref{OS X}."
2976 :     msgstr ""
2977 :    
2978 :     #. type: node
2979 :     #: R-admin.texi:1613
2980 :     #: R-admin.texi:1615
2981 :     #: R-admin.texi:1616
2982 :     #: R-admin.texi:1674
2983 :     #, no-wrap
2984 :     msgid "Running R under OS X"
2985 :     msgstr ""
2986 :    
2987 :     #. type: node
2988 :     #: R-admin.texi:1613
2989 :     #: R-admin.texi:1615
2990 :     #: R-admin.texi:1674
2991 :     #: R-admin.texi:1675
2992 :     #: R-admin.texi:1713
2993 :     #, no-wrap
2994 :     msgid "Uninstalling under OS X"
2995 :     msgstr ""
2996 :    
2997 :     #. type: section
2998 :     #: R-admin.texi:1613
2999 :     #: R-admin.texi:1674
3000 :     #: R-admin.texi:1713
3001 :     #: R-admin.texi:1714
3002 :     #, no-wrap
3003 :     msgid "Multiple versions"
3004 :     msgstr ""
3005 :    
3006 :     #. type: Plain text
3007 :     #: R-admin.texi:1620
3008 :     msgid ""
3009 :     "There are two ways to run @R{} on OS X from a @acronym{CRAN} binary "
3010 :     "distribution."
3011 :     msgstr ""
3012 :    
3013 :     #. type: Plain text
3014 :     #: R-admin.texi:1628
3015 :     msgid ""
3016 :     "There is a GUI console normally installed with the @R{} icon in @file{/"
3017 :     "Applications} which you can run by double-clicking (e.g. from Launchpad or "
3018 :     "Finder). This is usually referred to as @Rapp{} to distinguish it from "
3019 :     "command-line @R{}: its user manual is currently part of the OS X FAQ at "
3020 :     "@uref{http://cran.r-project.org/@/bin/@/macosx/@/RMacOSX-FAQ.html} and can "
3021 :     "be viewed from @Rapp{}'s `Help' menu."
3022 :     msgstr ""
3023 :    
3024 :     #. type: Plain text
3025 :     #: R-admin.texi:1636
3026 :     msgid ""
3027 :     "You can run command-line @R{} from a Terminal like any other Unix-alike: see "
3028 :     "the next chapter of this manual. There are some small differences which may "
3029 :     "surprise users of @R{} on other platforms, notably the default location of "
3030 :     "the personal library directory (under @file{~/Library/R}, e.g. @file{~/"
3031 :     "Library/R/3.1/library}), and that warnings, messages and other output to "
3032 :     "@file{stderr} are highlighted in bold."
3033 :     msgstr ""
3034 :    
3035 :     #. type: Plain text
3036 :     #: R-admin.texi:1641
3037 :     msgid ""
3038 :     "%% https://stat.ethz.ch/pipermail/r-sig-mac/2014-October/011131.html It has "
3039 :     "been reported that running @Rapp{} under Yosemite may fail if no preferences "
3040 :     "are stored, so if it fails when launched for the very first time, try it "
3041 :     "again (the first attempt will store some preferences)."
3042 :     msgstr ""
3043 :    
3044 :     #. type: Plain text
3045 :     #: R-admin.texi:1647
3046 :     msgid ""
3047 :     "Users of @Rapp{} under Mavericks and later need to be aware of the `App Nap' "
3048 :     "feature (@uref{https://developer.apple.com/library/mac/releasenotes/MacOSX/"
3049 :     "WhatsNewInOSX/Articles/MacOSX10_9.html}) which can cause @R{} tasks to "
3050 :     "appear to run very slowly when not producing output in the console. Here "
3051 :     "are three ways to avoid it:"
3052 :     msgstr ""
3053 :    
3054 :     #. type: itemize
3055 :     #: R-admin.texi:1652
3056 :     msgid ""
3057 :     "Ensure that the console is completely visible (or at least the activity "
3058 :     "indicator at the top right corner is visible)."
3059 :     msgstr ""
3060 :    
3061 :     #. type: itemize
3062 :     #: R-admin.texi:1658
3063 :     msgid ""
3064 :     "Call @samp{Get Info} on the application (e.g.@: from Finder). This may have "
3065 :     "two tick boxes in the `General' panel: click the one named `Prevent App Nap' "
3066 :     "if it is not already ticked. (This only available for builds made prior to "
3067 :     "Mavericks.)"
3068 :     msgstr ""
3069 :    
3070 :     #. type: itemize
3071 :     #: R-admin.texi:1661
3072 :     msgid "In a Terminal, run"
3073 :     msgstr ""
3074 :    
3075 :     #. type: example
3076 :     #: R-admin.texi:1663
3077 :     #, no-wrap
3078 :     msgid "defaults write org.R-project.R NSAppSleepDisabled -bool YES\n"
3079 :     msgstr ""
3080 :    
3081 :     #. type: itemize
3082 :     #: R-admin.texi:1667
3083 :     msgid ""
3084 :     "(see @uref{https://developer.apple.com/library/mac/releasenotes/MacOSX/"
3085 :     "WhatsNewInOSX/Articles/MacOSX10_9.html})."
3086 :     msgstr ""
3087 :    
3088 :     #. type: Plain text
3089 :     #: R-admin.texi:1673
3090 :     msgid ""
3091 :     "Using the @code{X11} device or the X11-based versions of @code{View()} and "
3092 :     "@code{edit} for data frames and matrices (the latter are the default for "
3093 :     "command-line @R{} but not @Rapp{}) requires an X sub-system to be installed: "
3094 :     "see @ref{OS X}. (So do some third-party packages.)"
3095 :     msgstr ""
3096 :    
3097 :     #. type: Plain text
3098 :     #: R-admin.texi:1683
3099 :     msgid ""
3100 :     "@R{} for OS X consists of two parts: the GUI (@Rapp{}) and the R framework. "
3101 :     "The un-installation is as simple as removing those folders (e.g.@: by "
3102 :     "dragging them into the Trash). The typical installation will install the GUI "
3103 :     "into the @file{/Applications/R.app} folder and the R framework into the "
3104 :     "@file{/Library/Frameworks/R.framework} folder. This does leave some links "
3105 :     "in @file{/usr/bin}."
3106 :     msgstr ""
3107 :    
3108 :     #. type: Plain text
3109 :     #: R-admin.texi:1686
3110 :     msgid ""
3111 :     "If you want to get rid of @R{} more completely using a Terminal, simply run "
3112 :     "(prepend @code{sudo} if needed):"
3113 :     msgstr ""
3114 :    
3115 :     #. type: example
3116 :     #: R-admin.texi:1690
3117 :     #, no-wrap
3118 :     msgid ""
3119 :     "rm -rf /Library/Frameworks/R.framework /Applications/R.app \\\n"
3120 :     " /usr/bin/R /usr/bin/Rscript\n"
3121 :     msgstr ""
3122 :    
3123 :     #. type: Plain text
3124 :     #: R-admin.texi:1701
3125 :     msgid ""
3126 :     "The installation consisted of three Apple packages: @code{org.r-project.R."
3127 :     "x86_64.fw.pkg}, @code{org.r-project.R.x86_64.GUI.pkg} and @code{org.r-"
3128 :     "project.x86_64.tcltk.x11} (not all of which need be installed). You can use "
3129 :     "@code{pkgutil --unlink} (not supported by Lion or later) to remove their "
3130 :     "files or @code{pkgutil --forget} if you want the Apple Installer to forget "
3131 :     "about the package without deleting its files (useful for the @R{} framework "
3132 :     "when installing multiple R versions in parallel), or after you have deleted "
3133 :     "the files."
3134 :     msgstr ""
3135 :    
3136 :     #. type: Plain text
3137 :     #: R-admin.texi:1705
3138 :     msgid ""
3139 :     "Uninstalling the Tcl/Tk component (which is installed under @file{/usr/"
3140 :     "local}) is not simple. You can list the files it installed in a Terminal by"
3141 :     msgstr ""
3142 :    
3143 :     #. type: example
3144 :     #: R-admin.texi:1708
3145 :     #, no-wrap
3146 :     msgid "pkgutil --files org.r-project.x86_64.tcltk.x11\n"
3147 :     msgstr ""
3148 :    
3149 :     #. type: Plain text
3150 :     #: R-admin.texi:1712
3151 :     msgid "These are paths relative to @file{/}, the root of the file system."
3152 :     msgstr ""
3153 :    
3154 :     #. type: Plain text
3155 :     #: R-admin.texi:1723
3156 :     msgid ""
3157 :     "The installer will remove any previous version of the @R{} framework which "
3158 :     "it finds installed. This can be avoided by using @command{pkgutil --forget} "
3159 :     "(see the previous section). However, note that different versions are "
3160 :     "installed under @file{/Library/Frameworks/R.framework/Versions} as "
3161 :     "@file{3.0}, @file{3.1} and so on, so it is not possible to have different "
3162 :     "@samp{3.x.y} versions installed for the same @samp{x}."
3163 :     msgstr ""
3164 :    
3165 :     #. type: Plain text
3166 :     #: R-admin.texi:1725
3167 :     msgid "A version of @R{} can be run directly from the command-line as e.g.@:"
3168 :     msgstr ""
3169 :    
3170 :     #. type: example
3171 :     #: R-admin.texi:1727
3172 :     #, no-wrap
3173 :     msgid "/Library/Frameworks/R.framework/Versions/3.1/Resources/bin/R\n"
3174 :     msgstr ""
3175 :    
3176 :     #. type: Plain text
3177 :     #: R-admin.texi:1738
3178 :     msgid ""
3179 :     "However, @Rapp{} will always run the `current' version, that is the last "
3180 :     "installed version. A small utility, @command{Rswitch.app} (available at "
3181 :     "@url{http://r.research.att.com/#other}), can be used to change the `current' "
3182 :     "version. However, this is of limited use as @Rapp{} is compiled against a "
3183 :     "particular version of @R{} and will likely crash if switched to an earlier "
3184 :     "version. This may allow you to install a development version of @R{} (de-"
3185 :     "selecting @Rapp{}) and then switch back to the release version."
3186 :     msgstr ""
3187 :    
3188 :     #. type: Plain text
3189 :     #: R-admin.texi:1745
3190 :     msgid ""
3191 :     "How to start @R{} and what command-line options are available is discussed "
3192 :     "in @ref{Invoking R, , Invoking R, R-intro, An Introduction to R}."
3193 :     msgstr ""
3194 :    
3195 :     #. type: Plain text
3196 :     #: R-admin.texi:1752
3197 :     msgid ""
3198 :     "You should ensure that the shell has set adequate resource limits: @R{} "
3199 :     "expects a stack size of at least 8MB and to be able to open at least 256 "
3200 :     "file descriptors. (Any modern OS will have default limits at least as large "
3201 :     "as these, but apparently NetBSD does not. Use the shell command "
3202 :     "@command{ulimit} (@command{sh}/@command{bash}) or @command{limit} "
3203 :     "(@command{csh}/@command{tcsh}) to check.)"
3204 :     msgstr ""
3205 :    
3206 :     #. type: Plain text
3207 :     #: R-admin.texi:1757
3208 :     msgid ""
3209 :     "@R{} makes use of a number of environment variables, the default values of "
3210 :     "many of which are set in file @file{@var{R_HOME}/etc/Renviron} (there are "
3211 :     "none set by default on Windows and hence no such file). These are set at "
3212 :     "@command{configure} time, and you would not normally want to"
3213 :     msgstr ""
3214 :    
3215 :     #. type: Plain text
3216 :     #: R-admin.texi:1764
3217 :     msgid ""
3218 :     "change them -- a possible exception is @env{R_PAPERSIZE} (@pxref{Setting "
3219 :     "paper size}). The paper size will be deduced from the @samp{LC_PAPER} "
3220 :     "locale category if it exists and @env{R_PAPERSIZE} is unset, and this will "
3221 :     "normally produce the right choice from @samp{a4} and @samp{letter} on modern "
3222 :     "Unix-alikes (but can always be overridden by setting @env{R_PAPERSIZE})."
3223 :     msgstr ""
3224 :    
3225 :     #. type: Plain text
3226 :     #: R-admin.texi:1767
3227 :     msgid ""
3228 :     "Various environment variables can be set to determine where @R{} creates its "
3229 :     "per-session temporary directory. The environment variables"
3230 :     msgstr ""
3231 :    
3232 :     #. type: enindex
3233 :     #: R-admin.texi:1768
3234 :     #, no-wrap
3235 :     msgid "TMP"
3236 :     msgstr ""
3237 :    
3238 :     #. type: enindex
3239 :     #: R-admin.texi:1769
3240 :     #, no-wrap
3241 :     msgid "TEMP"
3242 :     msgstr ""
3243 :    
3244 :     #. type: Plain text
3245 :     #: R-admin.texi:1773
3246 :     msgid ""
3247 :     "@env{TMPDIR}, @env{TMP} and @env{TEMP} are searched in turn and the first "
3248 :     "one which is set and points to a writable area is used. If none do, the "
3249 :     "final default is @file{/tmp} on Unix-alikes and the value of"
3250 :     msgstr ""
3251 :    
3252 :     #. type: enindex
3253 :     #: R-admin.texi:1773
3254 :     #, no-wrap
3255 :     msgid "R_USER"
3256 :     msgstr ""
3257 :    
3258 :     #. type: Plain text
3259 :     #: R-admin.texi:1777
3260 :     msgid ""
3261 :     "@env{R_USER} on Windows. The path should be an absolute path not containing "
3262 :     "spaces (and it is best to avoid non-alphanumeric characters such as "
3263 :     "@code{+})."
3264 :     msgstr ""
3265 :    
3266 :     #. type: Plain text
3267 :     #: R-admin.texi:1780
3268 :     msgid ""
3269 :     "Some Unix-alike systems are set up to remove files and directories "
3270 :     "periodically from @file{/tmp}, for example by a @command{cron} job"
3271 :     msgstr ""
3272 :    
3273 :     #. type: Plain text
3274 :     #: R-admin.texi:1783
3275 :     msgid ""
3276 :     "running @command{tmpwatch}. Set @env{TMPDIR} to another directory before "
3277 :     "starting long-running jobs on such a system."
3278 :     msgstr ""
3279 :    
3280 :     #. type: Plain text
3281 :     #: R-admin.texi:1788
3282 :     msgid ""
3283 :     "Note that @env{TMPDIR} will be used to execute @command{configure} scripts "
3284 :     "when installing packages, so if @file{/tmp} has been mounted as "
3285 :     "@samp{noexec}, @env{TMPDIR} needs to be set to a directory from which "
3286 :     "execution is allowed."
3287 :     msgstr ""
3288 :    
3289 :     #. type: cindex
3290 :     #: R-admin.texi:1791
3291 :     #, no-wrap
3292 :     msgid "Packages"
3293 :     msgstr ""
3294 :    
3295 :     #. type: cindex
3296 :     #: R-admin.texi:1792
3297 :     #, no-wrap
3298 :     msgid "Libraries"
3299 :     msgstr ""
3300 :    
3301 :     #. type: node
3302 :     #: R-admin.texi:1802
3303 :     #: R-admin.texi:1812
3304 :     #: R-admin.texi:1813
3305 :     #: R-admin.texi:1838
3306 :     #, no-wrap
3307 :     msgid "Default packages"
3308 :     msgstr ""
3309 :    
3310 :     #. type: node
3311 :     #: R-admin.texi:1802
3312 :     #: R-admin.texi:1812
3313 :     #: R-admin.texi:1838
3314 :     #: R-admin.texi:1839
3315 :     #: R-admin.texi:1880
3316 :     #, no-wrap
3317 :     msgid "Managing libraries"
3318 :     msgstr ""
3319 :    
3320 :     #. type: node
3321 :     #: R-admin.texi:1802
3322 :     #: R-admin.texi:1838
3323 :     #: R-admin.texi:1880
3324 :     #: R-admin.texi:1881
3325 :     #: R-admin.texi:1975
3326 :     #: R-admin.texi:2058
3327 :     #: R-admin.texi:2127
3328 :     #: R-admin.texi:2165
3329 :     #: R-admin.texi:2206
3330 :     #: R-admin.texi:2226
3331 :     #, no-wrap
3332 :     msgid "Installing packages"
3333 :     msgstr ""
3334 :    
3335 :     #. type: node
3336 :     #: R-admin.texi:1802
3337 :     #: R-admin.texi:1880
3338 :     #: R-admin.texi:2226
3339 :     #: R-admin.texi:2227
3340 :     #: R-admin.texi:2260
3341 :     #, no-wrap
3342 :     msgid "Updating packages"
3343 :     msgstr ""
3344 :    
3345 :     #. type: node
3346 :     #: R-admin.texi:1802
3347 :     #: R-admin.texi:2226
3348 :     #: R-admin.texi:2260
3349 :     #: R-admin.texi:2261
3350 :     #: R-admin.texi:2283
3351 :     #, no-wrap
3352 :     msgid "Removing packages"
3353 :     msgstr ""
3354 :    
3355 :     #. type: node
3356 :     #: R-admin.texi:1802
3357 :     #: R-admin.texi:2260
3358 :     #: R-admin.texi:2283
3359 :     #: R-admin.texi:2284
3360 :     #: R-admin.texi:2355
3361 :     #, no-wrap
3362 :     msgid "Setting up a package repository"
3363 :     msgstr ""
3364 :    
3365 :     #. type: section
3366 :     #: R-admin.texi:1802
3367 :     #: R-admin.texi:2283
3368 :     #: R-admin.texi:2355
3369 :     #: R-admin.texi:2356
3370 :     #, no-wrap
3371 :     msgid "Checking installed source packages"
3372 :     msgstr ""
3373 :    
3374 :     #. type: Plain text
3375 :     #: R-admin.texi:1808
3376 :     msgid ""
3377 :     "It is helpful to use the correct terminology. A @emph{package} is loaded "
3378 :     "from a @emph{library} by the function @code{library()}. Thus a library is a "
3379 :     "directory containing installed packages; the main library is "
3380 :     "@file{@var{R_HOME}/library}, but others can be used, for example by"
3381 :     msgstr ""
3382 :    
3383 :     #. type: enindex
3384 :     #: R-admin.texi:1808
3385 :     #, no-wrap
3386 :     msgid "R_LIBS"
3387 :     msgstr ""
3388 :    
3389 :     #. type: Plain text
3390 :     #: R-admin.texi:1811
3391 :     msgid ""
3392 :     "setting the environment variable @env{R_LIBS} or using the @R{} function "
3393 :     "@code{.libPaths()}."
3394 :     msgstr ""
3395 :    
3396 :     #. type: cindex
3397 :     #: R-admin.texi:1814
3398 :     #, no-wrap
3399 :     msgid "Packages, default"
3400 :     msgstr ""
3401 :    
3402 :     #. type: Plain text
3403 :     #: R-admin.texi:1817
3404 :     msgid "The set of packages loaded on startup is by default"
3405 :     msgstr ""
3406 :    
3407 :     #. type: example
3408 :     #: R-admin.texi:1821
3409 :     #, no-wrap
3410 :     msgid ""
3411 :     "> getOption(\"defaultPackages\")\n"
3412 :     "[1] \"datasets\" \"utils\" \"grDevices\" \"graphics\" \"stats\" \"methods\"\n"
3413 :     msgstr ""
3414 :    
3415 :     #. type: Plain text
3416 :     #: R-admin.texi:1826
3417 :     msgid ""
3418 :     "(plus, of course, @pkg{base}) and this can be changed by setting the option "
3419 :     "in startup code (e.g.@: in @file{~/.Rprofile}). It is initially"
3420 :     msgstr ""
3421 :    
3422 :     #. type: enindex
3423 :     #: R-admin.texi:1826
3424 :     #, no-wrap
3425 :     msgid "R_DEFAULT_PACKAGES"
3426 :     msgstr ""
3427 :    
3428 :     #. type: Plain text
3429 :     #: R-admin.texi:1830
3430 :     msgid ""
3431 :     "set to the value of the environment variable @env{R_DEFAULT_PACKAGES} if set "
3432 :     "(as a comma-separated list). Setting @env{R_DEFAULT_PACKAGES=NULL} ensures "
3433 :     "that only package @pkg{base} is loaded."
3434 :     msgstr ""
3435 :    
3436 :     #. type: Plain text
3437 :     #: R-admin.texi:1836
3438 :     msgid ""
3439 :     "Changing the set of default packages is normally used to reduce the set for "
3440 :     "speed when scripting: in particular not using @pkg{methods} will reduce the "
3441 :     "start-up time by a factor of up to two (and this is done by "
3442 :     "@command{Rscript}). But it can also be used to customize @R{}, e.g.@: for "
3443 :     "class use."
3444 :     msgstr ""
3445 :    
3446 :     #. type: cindex
3447 :     #: R-admin.texi:1840
3448 :     #, no-wrap
3449 :     msgid "Libraries, managing"
3450 :     msgstr ""
3451 :    
3452 :     #. type: Plain text
3453 :     #: R-admin.texi:1845
3454 :     msgid ""
3455 :     "@R{} packages are installed into @emph{libraries}, which are directories in "
3456 :     "the file system containing a subdirectory for each package installed there."
3457 :     msgstr ""
3458 :    
3459 :     #. type: Plain text
3460 :     #: R-admin.texi:1853
3461 :     msgid ""
3462 :     "@R{} comes with a single library, @file{@var{R_HOME}/library} which is the "
3463 :     "value of the @R{} object @samp{.Library} containing the standard and "
3464 :     "recommended@footnote{unless they were excluded in the build.} packages. "
3465 :     "Both sites and users can create others and make use of them (or not) in an "
3466 :     "@R{} session. At the lowest level @samp{.libPaths()} can be used to add "
3467 :     "paths to the collection of libraries or to report the current collection."
3468 :     msgstr ""
3469 :    
3470 :     #. type: cindex
3471 :     #: R-admin.texi:1854
3472 :     #, no-wrap
3473 :     msgid "Libraries, site"
3474 :     msgstr ""
3475 :    
3476 :     #. type: cindex
3477 :     #: R-admin.texi:1855
3478 :     #, no-wrap
3479 :     msgid "Site libraries"
3480 :     msgstr ""
3481 :    
3482 :     #. type: Plain text
3483 :     #: R-admin.texi:1863
3484 :     msgid ""
3485 :     "@R{} will automatically make use of a site-specific library "
3486 :     "@file{@var{R_HOME}/site-library} if this exists (it does not in a vanilla "
3487 :     "@R{} installation). This location can be overridden by setting@footnote{its "
3488 :     "binding is locked once the startup files have been read, so users cannot "
3489 :     "easily change it.} @samp{.Library.site} in @file{@var{R_HOME}/etc/Rprofile."
3490 :     "site}, or (not recommended) by setting the"
3491 :     msgstr ""
3492 :    
3493 :     #. type: enindex
3494 :     #: R-admin.texi:1863
3495 :     #, no-wrap
3496 :     msgid "R_LIBS_SITE"
3497 :     msgstr ""
3498 :    
3499 :     #. type: Plain text
3500 :     #: R-admin.texi:1866
3501 :     msgid ""
3502 :     "environment variable @env{R_LIBS_SITE}. Like @samp{.Library}, the site "
3503 :     "libraries are always included by @samp{.libPaths()}."
3504 :     msgstr ""
3505 :    
3506 :     #. type: cindex
3507 :     #: R-admin.texi:1867
3508 :     #, no-wrap
3509 :     msgid "Libraries, user"
3510 :     msgstr ""
3511 :    
3512 :     #. type: cindex
3513 :     #: R-admin.texi:1868
3514 :     #, no-wrap
3515 :     msgid "User libraries"
3516 :     msgstr ""
3517 :    
3518 :     #. type: enindex
3519 :     #: R-admin.texi:1869
3520 :     #, no-wrap
3521 :     msgid "R_LIBS_USER"
3522 :     msgstr ""
3523 :    
3524 :     #. type: Plain text
3525 :     #: R-admin.texi:1875
3526 :     msgid ""
3527 :     "Users can have one or more libraries, normally specified by the environment "
3528 :     "variable @env{R_LIBS_USER}. This has a default value (to see it, use "
3529 :     "@samp{Sys.getenv(\"R_LIBS_USER\")} within an @R{} session), but that is only "
3530 :     "used if the corresponding directory actually exists (which by default it "
3531 :     "will not)."
3532 :     msgstr ""
3533 :    
3534 :     #. type: Plain text
3535 :     #: R-admin.texi:1878
3536 :     msgid ""
3537 :     "Both @env{R_LIBS_USER} and @env{R_LIBS_SITE} can specify multiple library "
3538 :     "paths, separated by colons (semicolons on Windows)."
3539 :     msgstr ""
3540 :    
3541 :     #. type: cindex
3542 :     #: R-admin.texi:1882
3543 :     #, no-wrap
3544 :     msgid "Packages, installing"
3545 :     msgstr ""
3546 :    
3547 :     #. type: node
3548 :     #: R-admin.texi:1890
3549 :     #: R-admin.texi:1975
3550 :     #: R-admin.texi:2058
3551 :     #, no-wrap
3552 :     msgid "Windows packages"
3553 :     msgstr ""
3554 :    
3555 :     #. type: node
3556 :     #: R-admin.texi:1890
3557 :     #: R-admin.texi:1975
3558 :     #: R-admin.texi:2058
3559 :     #: R-admin.texi:2127
3560 :     #, no-wrap
3561 :     msgid "OS X packages"
3562 :     msgstr ""
3563 :    
3564 :     #. type: node
3565 :     #: R-admin.texi:1890
3566 :     #: R-admin.texi:2058
3567 :     #: R-admin.texi:2127
3568 :     #: R-admin.texi:2128
3569 :     #: R-admin.texi:2165
3570 :     #, no-wrap
3571 :     msgid "Customizing package compilation"
3572 :     msgstr ""
3573 :    
3574 :     #. type: node
3575 :     #: R-admin.texi:1890
3576 :     #: R-admin.texi:2127
3577 :     #: R-admin.texi:2165
3578 :     #: R-admin.texi:2166
3579 :     #: R-admin.texi:2206
3580 :     #, no-wrap
3581 :     msgid "Multiple sub-architectures"
3582 :     msgstr ""
3583 :    
3584 :     #. type: subsection
3585 :     #: R-admin.texi:1890
3586 :     #: R-admin.texi:2165
3587 :     #: R-admin.texi:2206
3588 :     #: R-admin.texi:2207
3589 :     #, no-wrap
3590 :     msgid "Byte-compilation"
3591 :     msgstr ""
3592 :    
3593 :     #. type: Plain text
3594 :     #: R-admin.texi:1898
3595 :     msgid ""
3596 :     "Packages may be distributed in source form or compiled binary form. "
3597 :     "Installing source packages which contain C/C++/Fortran code requires that "
3598 :     "compilers and related tools be installed. Binary packages are platform-"
3599 :     "specific and generally need no special tools to install, but see the "
3600 :     "documentation for your platform for details."
3601 :     msgstr ""
3602 :    
3603 :     #. type: Plain text
3604 :     #: R-admin.texi:1902
3605 :     msgid ""
3606 :     "Note that you may need to specify implicitly or explicitly the library to "
3607 :     "which the package is to be installed. This is only an issue if you have "
3608 :     "more than one library, of course."
3609 :     msgstr ""
3610 :    
3611 :     #. type: Plain text
3612 :     #: R-admin.texi:1912
3613 :     msgid ""
3614 :     "Ensure that the environment variable @env{TMPDIR} is either unset (and "
3615 :     "@file{/tmp} exists and can be written in and executed from) or is the "
3616 :     "absolute path to a valid temporary directory, not containing spaces."
3617 :     msgstr ""
3618 :    
3619 :     #. type: Plain text
3620 :     #: R-admin.texi:1920
3621 :     msgid ""
3622 :     "For most users it suffices to call @samp{install.packages(@var{pkgname})} or "
3623 :     "its GUI equivalent if the intention is to install a @acronym{CRAN} package "
3624 :     "and internet access is available.@footnote{If a proxy needs to be set, see "
3625 :     "@command{?download.file}.} On most systems @samp{install.packages()} will "
3626 :     "allow packages to be selected from a list box (typically with several "
3627 :     "thousand items)."
3628 :     msgstr ""
3629 :    
3630 :     #. type: Plain text
3631 :     #: R-admin.texi:1922
3632 :     msgid "To install packages from source on a Unix-alike use in a terminal"
3633 :     msgstr ""
3634 :    
3635 :     #. type: example
3636 :     #: R-admin.texi:1925
3637 :     #, no-wrap
3638 :     msgid "R CMD INSTALL -l /path/to/library @var{pkg1} @var{pkg2} @dots{}\n"
3639 :     msgstr ""
3640 :    
3641 :     #. type: Plain text
3642 :     #: R-admin.texi:1931
3643 :     msgid ""
3644 :     "The part @samp{-l /path/to/library} can be omitted, in which case the first "
3645 :     "library of a normal @R{} session is used (that shown by @code{.libPaths()"
3646 :     "[1]})."
3647 :     msgstr ""
3648 :    
3649 :     #. type: Plain text
3650 :     #: R-admin.texi:1934
3651 :     msgid ""
3652 :     "There are a number of options available: use @code{R CMD INSTALL --help} to "
3653 :     "see the current list."
3654 :     msgstr ""
3655 :    
3656 :     #. type: findex
3657 :     #: R-admin.texi:1935
3658 :     #, no-wrap
3659 :     msgid "install.packages"
3660 :     msgstr ""
3661 :    
3662 :     #. type: Plain text
3663 :     #: R-admin.texi:1940
3664 :     msgid ""
3665 :     "Alternatively, packages can be downloaded and installed from within @R{}. "
3666 :     "First choose your nearest @acronym{CRAN} mirror using "
3667 :     "@command{chooseCRANmirror()}. Then download and install packages @pkg{pkg1} "
3668 :     "and @pkg{pkg2} by"
3669 :     msgstr ""
3670 :    
3671 :     #. type: example
3672 :     #: R-admin.texi:1943
3673 :     #, no-wrap
3674 :     msgid "> install.packages(c(\"pkg1\", \"pkg2\"))\n"
3675 :     msgstr ""
3676 :    
3677 :     #. type: Plain text
3678 :     #: R-admin.texi:1951
3679 :     msgid ""
3680 :     "The essential dependencies of the specified packages will also be fetched. "
3681 :     "Unless the library is specified (argument @code{lib}) the first library in "
3682 :     "the library search path is used: if this is not writable, @R{} will ask the "
3683 :     "user (in an interactive session) if the default personal library should be "
3684 :     "created, and if allowed to will install the packages there."
3685 :     msgstr ""
3686 :    
3687 :     #. type: Plain text
3688 :     #: R-admin.texi:1955
3689 :     msgid ""
3690 :     "If you want to fetch a package and all those it depends on (in any way) "
3691 :     "that are not already installed, use e.g."
3692 :     msgstr ""
3693 :    
3694 :     #. type: example
3695 :     #: R-admin.texi:1958
3696 :     #, no-wrap
3697 :     msgid "> install.packages(\"Rcmdr\", dependencies = TRUE)\n"
3698 :     msgstr ""
3699 :    
3700 :     #. type: Plain text
3701 :     #: R-admin.texi:1964
3702 :     msgid ""
3703 :     "@code{install.packages} can install a source package from a local @file{.tar."
3704 :     "gz} file (or a URL to such a file) by setting argument @code{repos} to "
3705 :     "@code{NULL}: this will be selected automatically if the name given is a "
3706 :     "single @file{.tar.gz} file."
3707 :     msgstr ""
3708 :    
3709 :     #. type: Plain text
3710 :     #: R-admin.texi:1971
3711 :     msgid ""
3712 :     "@code{install.packages} can look in several repositories, specified as a "
3713 :     "character vector by the argument @code{repos}: these can include a "
3714 :     "@acronym{CRAN} mirror, Bioconductor, Omegahat, R-forge, rforge.net, local "
3715 :     "archives, local files, @dots{}). Function @code{setRepositories()} can "
3716 :     "select amongst those repositories that the @R{} installation is aware of."
3717 :     msgstr ""
3718 :    
3719 :     #. type: Plain text
3720 :     #: R-admin.texi:1974
3721 :     msgid ""
3722 :     "Naive users sometimes forget that as well as installing a package, they have "
3723 :     "to use @code{library} to make its functionality available."
3724 :     msgstr ""
3725 :    
3726 :     #. type: section
3727 :     #: R-admin.texi:1976
3728 :     #: R-admin.texi:2182
3729 :     #: R-admin.texi:2851
3730 :     #, no-wrap
3731 :     msgid "Windows"
3732 :     msgstr ""
3733 :    
3734 :     #. type: Plain text
3735 :     #: R-admin.texi:1987
3736 :     msgid ""
3737 :     "What @code{install.packages} does by default is different on Unix-alikes "
3738 :     "(except OS X) and Windows. On Unix-alikes it consults the list of available "
3739 :     "@emph{source} packages on @acronym{CRAN} (or other repository/ies), "
3740 :     "downloads the latest version of the package sources, and installs them (via "
3741 :     "@code{R CMD INSTALL}). On Windows it looks (by default) at the list of "
3742 :     "@emph{binary} versions of packages available for your version of @R{} and "
3743 :     "downloads the latest versions (if any), although optionally it will also "
3744 :     "download and install a source package by setting the @code{type} argument."
3745 :     msgstr ""
3746 :    
3747 :     #. type: Plain text
3748 :     #: R-admin.texi:1993
3749 :     msgid ""
3750 :     "On Windows @code{install.packages} can also install a binary package from a "
3751 :     "local @file{zip} file (or the URL of such a file) by setting argument "
3752 :     "@code{repos} to @code{NULL}. @code{Rgui.exe} has a menu @code{Packages} "
3753 :     "with a GUI interface to @code{install.packages}, @code{update.packages} and "
3754 :     "@code{library}."
3755 :     msgstr ""
3756 :    
3757 :     #. type: Plain text
3758 :     #: R-admin.texi:1996
3759 :     msgid ""
3760 :     "Windows binary packages for @R{} are distributed as a single binary "
3761 :     "containing either or both architectures (32- and 64-bit)."
3762 :     msgstr ""
3763 :    
3764 :     #. type: Plain text
3765 :     #: R-admin.texi:2007
3766 :     msgid ""
3767 :     "A few of the binary packages need other software to be installed on your "
3768 :     "system: see for example @uref{http://CRAN.R-project.org/@/bin/@/windows/@/"
3769 :     "contrib/@/3.1/@/@@ReadMe}. For 64-bit builds, packages using Gtk+ "
3770 :     "(@CRANpkg{Cairo}, @CRANpkg{RGtk2}, @CRANpkg{cairoDevice} and those that "
3771 :     "depend on them) need the @file{bin} directory of a bundled distribution "
3772 :     "from @uref{http://www.gtk.org/@/download/@/win32.php} or @uref{http://www."
3773 :     "gtk.org/@/download/@/win64.php} in the path: it should work to have both 32- "
3774 :     "and 64-bit Gtk+ @file{bin} directories in the path on a 64-bit version of "
3775 :     "@R{}."
3776 :     msgstr ""
3777 :    
3778 :     #. type: Plain text
3779 :     #: R-admin.texi:2016
3780 :     msgid ""
3781 :     "@command{R CMD INSTALL} works in Windows to install source packages. No "
3782 :     "additional tools are needed if the package does not contain compiled code, "
3783 :     "and @code{install.packages(type=\"source\")} will work for such packages "
3784 :     "(and for those with compiled code if the tools (see @ref{The Windows "
3785 :     "toolset}) are in the path). We have seen occasional permission problems "
3786 :     "after unpacking source packages on some Windows 7 and Server 2008 systems: "
3787 :     "these have been circumvented by setting the environment variable "
3788 :     "@env{R_INSTALL_TAR} to @samp{tar.exe}."
3789 :     msgstr ""
3790 :    
3791 :     #. type: enindex
3792 :     #: R-admin.texi:2016
3793 :     #, no-wrap
3794 :     msgid "R_INSTALL_TAR"
3795 :     msgstr ""
3796 :    
3797 :     #. type: Plain text
3798 :     #: R-admin.texi:2022
3799 :     msgid ""
3800 :     "If you have only a source package that is known to work with current @R{} "
3801 :     "and just want a binary Windows build of it, you could make use of the "
3802 :     "building service offered at @uref{http://win-builder.r-project.org/}."
3803 :     msgstr ""
3804 :    
3805 :     #. type: Plain text
3806 :     #: R-admin.texi:2039
3807 :     msgid ""
3808 :     "For almost all packages @command{R CMD INSTALL} will attempt to install both "
3809 :     "32- and 64-bit builds of a package if run from a 32/64-bit install of @R{}. "
3810 :     "It will report success if the installation of the architecture of the "
3811 :     "running @command{R} succeeded, whether or not the other architecture was "
3812 :     "successfully installed. The exceptions are packages with a non-empty "
3813 :     "@file{configure.win} script or which make use of @file{src/Makefile.win}. "
3814 :     "If @file{configure.win} does something appropriate to both architectures "
3815 :     "use@footnote{for a small number of @acronym{CRAN} packages where this is "
3816 :     "known to be safe and is needed by the autobuilder this is the default. Look "
3817 :     "at the source of @file{tools:::.install_packages} for the list. It can also "
3818 :     "be specified in the package's @file{DESCRIPTION} file.} option @option{--"
3819 :     "force-biarch}: otherwise @command{R CMD INSTALL --merge-multiarch} can be "
3820 :     "applied to a source tarball to merge separate 32- and 64-bit installs. "
3821 :     "(This can only be applied to a tarball, and will only succeed if both "
3822 :     "installs succeed.)"
3823 :     msgstr ""
3824 :    
3825 :     #. type: Plain text
3826 :     #: R-admin.texi:2044
3827 :     msgid ""
3828 :     "If you have a package without compiled code and no Windows-specific help, "
3829 :     "you can zip up an installation on another OS and install from that zip file "
3830 :     "on Windows. However, such a package can be installed from the sources on "
3831 :     "Windows without any additional tools."
3832 :     msgstr ""
3833 :    
3834 :     #. type: enindex
3835 :     #: R-admin.texi:2046
3836 :     #, no-wrap
3837 :     msgid "LOCAL_SOFT"
3838 :     msgstr ""
3839 :    
3840 :     #. type: Plain text
3841 :     #: R-admin.texi:2057
3842 :     msgid ""
3843 :     "There is provision to make use of a system-wide library of installed "
3844 :     "external software by setting the @command{make} variable @code{LOCAL_SOFT}, "
3845 :     "to give an equivalent of @file{/usr/local} on a Unix-alike. This can be set "
3846 :     "in @file{src/gnuwin/MkRules.local} when @R{} is built from sources (see the "
3847 :     "comments in @file{src/gnuwin/MkRules.dist}), or in file@footnote{or by "
3848 :     "adding it in a file such as @file{etc/i386/Makevars.site}, which does not "
3849 :     "exist by default.} @file{etc/i386/Makeconf} or @file{etc/x64/Makeconf} for "
3850 :     "an installed version of @R{}. The version used by @acronym{CRAN} can be "
3851 :     "downloaded from @uref{http://www.stats.ox.ac.uk/pub/Rtools/libs.html}."
3852 :     msgstr ""
3853 :    
3854 :     #. type: Plain text
3855 :     #: R-admin.texi:2070
3856 :     msgid ""
3857 :     "On OS X @code{install.packages} works as it does on other Unix-alike "
3858 :     "systems, but there is an additional type @code{mac.binary} (the default in "
3859 :     "the @acronym{CRAN} distribution but not when compiling from source: "
3860 :     "@code{mac.binary.mavericks} for a Mavericks build) which can be passed to "
3861 :     "@code{install.packages} in order to download and install binary packages "
3862 :     "from a suitable repository. These OS X binary package files have the "
3863 :     "extension @samp{.tgz}. The @Rapp{} GUI provides menus for installation of "
3864 :     "either binary or source packages, from @acronym{CRAN} or local files."
3865 :     msgstr ""
3866 :    
3867 :     #. type: Plain text
3868 :     #: R-admin.texi:2073
3869 :     msgid ""
3870 :     "Note that most binary packages including compiled code are tied to a "
3871 :     "particular series (e.g.@: @R{} 3.0.x or 3.1.x) of @R{}."
3872 :     msgstr ""
3873 :    
3874 :     #. type: Plain text
3875 :     #: R-admin.texi:2077
3876 :     msgid ""
3877 :     "You should not attempt to mix-and-match binary packages built for the `Snow "
3878 :     "Leopard' and `Mavericks' @acronym{CRAN} distributions: doing so is likely to "
3879 :     "lead to crashes or failures to load."
3880 :     msgstr ""
3881 :    
3882 :     #. type: Plain text
3883 :     #: R-admin.texi:2084
3884 :     msgid ""
3885 :     "Installing source packages which do not contain compiled code should work "
3886 :     "with no additional tools. For others you will need the `Command-line Tools' "
3887 :     "for @command{Xcode} and compilers which match those used to build @R{}: see "
3888 :     "@ref{OS X}. (Note that the Fortran compilers differ for the `Snow Leopard' "
3889 :     "and `Mavericks' binary installations of @R{}.)"
3890 :     msgstr ""
3891 :    
3892 :     #. type: Plain text
3893 :     #: R-admin.texi:2088
3894 :     msgid ""
3895 :     "Package @CRANpkg{rJava} and those which depend on it need a Java runtime "
3896 :     "installed and several packages need X11 installed, including those using "
3897 :     "Tk. For Mountain Lion and later see @ref{OS X} and @ref{Java (OS X)}."
3898 :     msgstr ""
3899 :    
3900 :     #. type: Plain text
3901 :     #: R-admin.texi:2092
3902 :     msgid ""
3903 :     "Tcl/Tk extensions @code{BWidget} and @code{Tktable} are part of the Tcl/Tk "
3904 :     "contained in the @R{} installer. These are required by a number of "
3905 :     "@acronym{CRAN} and Bioconductor packages."
3906 :     msgstr ""
3907 :    
3908 :     #. type: Plain text
3909 :     #: R-admin.texi:2099
3910 :     msgid ""
3911 :     "A few of the binary packages need other software to be installed on your "
3912 :     "system. In particular packages using Gtk+ (@CRANpkg{RGtk2}, "
3913 :     "@CRANpkg{cairoDevice} and those that depend on them) need the GTK framework "
3914 :     "installed from @uref{http://r.research.att.com/libs/}: the appropriate "
3915 :     "version at the time of writing was @uref{http://r.research.att.com/libs/"
3916 :     "GTK_2.24.17-X11.pkg}"
3917 :     msgstr ""
3918 :    
3919 :     #. type: Plain text
3920 :     #: R-admin.texi:2110
3921 :     msgid ""
3922 :     "The default compilers specified in @file{/Library/Frameworks/R.framework/"
3923 :     "Resources/etc/Makeconf} depend on the version of OS X under which @R{} was "
3924 :     "installed, and are appropriate to the latest version of the Xcode command-"
3925 :     "line tools for that version of OS X. The settings can be changed, either by "
3926 :     "editing that file or in a file such as @file{~/.R/Makevars} (see the next "
3927 :     "section). Entries which may need to be changed include @samp{CC}, "
3928 :     "@samp{CXX}, @samp{FC}, @samp{F77}, @samp{FLIBS} and the corresponding flags, "
3929 :     "and perhaps @samp{CXXCPP}, @samp{DYLIB_LD}, @samp{MAIN_LD}, "
3930 :     "@samp{SHLIB_CXXLD}, @samp{SHLIB_FCLD} and @samp{SHLIB_LD}."
3931 :     msgstr ""
3932 :    
3933 :     #. type: Plain text
3934 :     #: R-admin.texi:2113
3935 :     msgid ""
3936 :     "So for example you could select @command{clang} for both C and C++ with "
3937 :     "extensive checking by having in @file{~/.R/Makevars}"
3938 :     msgstr ""
3939 :    
3940 :     #. type: example
3941 :     #: R-admin.texi:2118
3942 :     #, no-wrap
3943 :     msgid ""
3944 :     "CC=clang\n"
3945 :     "CXX=clang++\n"
3946 :     "CFLAGS=-mtune=native -g -O2 -Wall -pedantic -Wconversion\n"
3947 :     "CXXFLAGS=-mtune=native -g -O2 -Wall -pedantic -Wconversion\n"
3948 :     msgstr ""
3949 :    
3950 :     #. type: Plain text
3951 :     #: R-admin.texi:2122
3952 :     msgid "and for a version of @command{gfortran-4.2} we needed"
3953 :     msgstr ""
3954 :    
3955 :     #. type: example
3956 :     #: R-admin.texi:2124
3957 :     #, no-wrap
3958 :     msgid "FLIBS=-lgfortran\n"
3959 :     msgstr ""
3960 :    
3961 :     #. type: Plain text
3962 :     #: R-admin.texi:2139
3963 :     msgid ""
3964 :     "The R system and package-specific compilation flags can be overridden or "
3965 :     "added to by setting the appropriate Make variables in the personal file "
3966 :     "@file{@var{HOME}/.R/Makevars-@var{R_PLATFORM}} (but @file{@var{HOME}/.R/"
3967 :     "Makevars.win} or @file{@var{HOME}/.R/Makevars.win64} on Windows), or if that "
3968 :     "does not exist, @file{@var{HOME}/.R/Makevars}, where @samp{R_PLATFORM} is "
3969 :     "the platform for which R was built, as available in the @code{platform} "
3970 :     "component of the R variable @code{R.version}. An alternative personal file "
3971 :     "can be specified @emph{via} the environment variable @env{R_MAKEVARS_USER}."
3972 :     msgstr ""
3973 :    
3974 :     #. type: Plain text
3975 :     #: R-admin.texi:2144
3976 :     msgid ""
3977 :     "Package developers are encouraged to use this mechanism to enable a "
3978 :     "reasonable amount of diagnostic messaging (``warnings'') when compiling, "
3979 :     "such as e.g.@: @option{-Wall -pedantic} for tools from GCC, the Gnu Compiler "
3980 :     "Collection."
3981 :     msgstr ""
3982 :    
3983 :     #. type: Plain text
3984 :     #: R-admin.texi:2147
3985 :     msgid ""
3986 :     "Note that this mechanism can also be used when it necessary to change the "
3987 :     "optimization level for a particular package. For example"
3988 :     msgstr ""
3989 :    
3990 :     #. type: example
3991 :     #: R-admin.texi:2157
3992 :     #, no-wrap
3993 :     msgid ""
3994 :     "## @r{for C code}\n"
3995 :     "CFLAGS=-g -O -mtune=native\n"
3996 :     "## @r{for C++ code}\n"
3997 :     "CXXFLAGS=-g -O -mtune=native\n"
3998 :     "## @r{for Fortran code}\n"
3999 :     "FFLAGS=-g -O -mtune=native\n"
4000 :     "## @r{for Fortran 9x code}\n"
4001 :     "FCFLAGS=-g -O -mtune=native\n"
4002 :     msgstr ""
4003 :    
4004 :     #. type: Plain text
4005 :     #: R-admin.texi:2164
4006 :     msgid ""
4007 :     "There is also provision for a site-wide @file{Makevars.site} file under "
4008 :     "@file{@var{R_HOME}/etc} (in a sub-architecture-specific directory if "
4009 :     "appropriate). This is read immediately after @file{Makeconf}, and an "
4010 :     "alternative file can be specified by environment variable "
4011 :     "@env{R_MAKEVARS_SITE}."
4012 :     msgstr ""
4013 :    
4014 :     #. type: Plain text
4015 :     #: R-admin.texi:2172
4016 :     msgid ""
4017 :     "When installing packages from their sources, there are some extra "
4018 :     "considerations on installations which use sub-architectures. These are "
4019 :     "commonly used on Windows but can in principle be used on other platforms."
4020 :     msgstr ""
4021 :    
4022 :     #. type: Plain text
4023 :     #: R-admin.texi:2176
4024 :     msgid ""
4025 :     "When a source package is installed by a build of @R{} which supports "
4026 :     "multiple sub-architectures, the normal installation process installs the "
4027 :     "packages for all sub-architectures. The exceptions are"
4028 :     msgstr ""
4029 :    
4030 :     #. type: section
4031 :     #: R-admin.texi:2178
4032 :     #: R-admin.texi:2790
4033 :     #, no-wrap
4034 :     msgid "Unix-alikes"
4035 :     msgstr ""
4036 :    
4037 :     #. type: table
4038 :     #: R-admin.texi:2181
4039 :     msgid ""
4040 :     "where there is an @file{configure} script, or a file @file{src/Makefile}."
4041 :     msgstr ""
4042 :    
4043 :     #. type: table
4044 :     #: R-admin.texi:2189
4045 :     msgid ""
4046 :     "where there is a non-empty @file{configure.win} script, or a file @file{src/"
4047 :     "Makefile.win} (with some exceptions where the package is known to have an "
4048 :     "architecture-independent @file{configure.win}, or if @option{--force-biarch} "
4049 :     "or field @samp{Biarch} in the @file{DESCRIPTION} file is used to assert so)."
4050 :     msgstr ""
4051 :    
4052 :     #. type: Plain text
4053 :     #: R-admin.texi:2195
4054 :     msgid ""
4055 :     "In those cases only the current architecture is installed. Further sub-"
4056 :     "architectures can be installed by"
4057 :     msgstr ""
4058 :    
4059 :     #. type: example
4060 :     #: R-admin.texi:2198
4061 :     #, no-wrap
4062 :     msgid "R CMD INSTALL --libs-only @var{pkg}\n"
4063 :     msgstr ""
4064 :    
4065 :     #. type: Plain text
4066 :     #: R-admin.texi:2205
4067 :     msgid ""
4068 :     "using the path to @command{R} or @command{R --arch} to select the additional "
4069 :     "sub-architecture. There is also @command{R CMD INSTALL --merge-multiarch} "
4070 :     "to build and merge the two architectures, starting with a source tarball."
4071 :     msgstr ""
4072 :    
4073 :     #. type: Plain text
4074 :     #: R-admin.texi:2214
4075 :     msgid ""
4076 :     "The base and recommended packages are byte-compiled by default. Other "
4077 :     "packages can be byte-compiled on installation by using @command{R CMD "
4078 :     "INSTALL}with option @option{--byte-compile} or by @code{install."
4079 :     "packages(type = \"source\", INSTALL_opts = \"--byte-compile\")}."
4080 :     msgstr ""
4081 :    
4082 :     #. type: Plain text
4083 :     #: R-admin.texi:2222
4084 :     msgid ""
4085 :     "Not all contributed packages work correctly when byte-compiled (for example "
4086 :     "because they interfere with the sealing of namespaces). For most packages "
4087 :     "(especially those which make extensive use of compiled code) the speed-up is "
4088 :     "small. Unless a package is used frequently the time spent in byte-"
4089 :     "compilation can outweigh the time saved in execution: also byte-compilation "
4090 :     "can add substantially to the installed size of the package."
4091 :     msgstr ""
4092 :    
4093 :     #. type: Plain text
4094 :     #: R-admin.texi:2225
4095 :     msgid ""
4096 :     "Byte-compilation can be controlled on a per-package basis by the "
4097 :     "@samp{ByteCompile} field in the @file{DESCRIPTION} file."
4098 :     msgstr ""
4099 :    
4100 :     #. type: findex
4101 :     #: R-admin.texi:2228
4102 :     #, no-wrap
4103 :     msgid "update.packages"
4104 :     msgstr ""
4105 :    
4106 :     #. type: cindex
4107 :     #: R-admin.texi:2229
4108 :     #, no-wrap
4109 :     msgid "Packages, updating"
4110 :     msgstr ""
4111 :    
4112 :     #. type: Plain text
4113 :     #: R-admin.texi:2236
4114 :     msgid ""
4115 :     "The command @code{update.packages()} is the simplest way to ensure that all "
4116 :     "the packages on your system are up to date. It downloads the list of "
4117 :     "available packages and their current versions, compares it with those "
4118 :     "installed and offers to fetch and install any that have later versions on "
4119 :     "the repositories."
4120 :     msgstr ""
4121 :    
4122 :     #. type: Plain text
4123 :     #: R-admin.texi:2243
4124 :     msgid ""
4125 :     "An alternative interface to keeping packages up-to-date is provided by the "
4126 :     "command @code{packageStatus()}, which returns an object with information on "
4127 :     "all installed packages and packages available at multiple repositories. The "
4128 :     "@code{print} and @code{summary} methods give an overview of installed and "
4129 :     "available packages, the @code{upgrade} method offers to fetch and install "
4130 :     "the latest versions of outdated packages."
4131 :     msgstr ""
4132 :    
4133 :     #. type: Plain text
4134 :     #: R-admin.texi:2248
4135 :     msgid ""
4136 :     "One sometimes-useful additional piece of information that "
4137 :     "@code{packageStatus()} returns is the status of a package, as @code{\"ok\"}, "
4138 :     "@code{\"upgrade\"} or @code{\"unavailable\"} (in the currently selected "
4139 :     "repositories). For example"
4140 :     msgstr ""
4141 :    
4142 :     #. type: example
4143 :     #: R-admin.texi:2257
4144 :     #, no-wrap
4145 :     msgid ""
4146 :     "> inst <- packageStatus()$inst\n"
4147 :     "> inst[inst$Status != \"ok\", c(\"Package\", \"Version\", \"Status\")]\n"
4148 :     " Package Version Status\n"
4149 :     "Biobase Biobase 2.8.0 unavailable\n"
4150 :     "RCurl RCurl 1.4-2 upgrade\n"
4151 :     "Rgraphviz Rgraphviz 1.26.0 unavailable\n"
4152 :     "rgdal rgdal 0.6-27 upgrade\n"
4153 :     msgstr ""
4154 :    
4155 :     #. type: findex
4156 :     #: R-admin.texi:2262
4157 :     #, no-wrap
4158 :     msgid "remove.packages"
4159 :     msgstr ""
4160 :    
4161 :     #. type: cindex
4162 :     #: R-admin.texi:2263
4163 :     #, no-wrap
4164 :     msgid "Packages, removing"
4165 :     msgstr ""
4166 :    
4167 :     #. type: Plain text
4168 :     #: R-admin.texi:2267
4169 :     msgid ""
4170 :     "Packages can be removed in a number of ways. From a command prompt they can "
4171 :     "be removed by"
4172 :     msgstr ""
4173 :    
4174 :     #. type: example
4175 :     #: R-admin.texi:2270
4176 :     #, no-wrap
4177 :     msgid "R CMD REMOVE -l /path/to/library @var{pkg1} @var{pkg2} @dots{}\n"
4178 :     msgstr ""
4179 :    
4180 :     #. type: Plain text
4181 :     #: R-admin.texi:2273
4182 :     msgid "From a running @R{} process they can be removed by"
4183 :     msgstr ""
4184 :    
4185 :     #. type: example
4186 :     #: R-admin.texi:2277
4187 :     #, no-wrap
4188 :     msgid ""
4189 :     "> remove.packages(c(\"pkg1\", \"pkg2\"),\n"
4190 :     " lib = file.path(\"path\", \"to\", \"library\"))\n"
4191 :     msgstr ""
4192 :    
4193 :     #. type: Plain text
4194 :     #: R-admin.texi:2281
4195 :     msgid ""
4196 :     "Finally, in most installations one can just remove the package directory "
4197 :     "from the library."
4198 :     msgstr ""
4199 :    
4200 :     #. type: cindex
4201 :     #: R-admin.texi:2285
4202 :     #, no-wrap
4203 :     msgid "Repositories"
4204 :     msgstr ""
4205 :    
4206 :     #. type: Plain text
4207 :     #: R-admin.texi:2295
4208 :     msgid ""
4209 :     "Utilities such as @code{install.packages} can be pointed at any "
4210 :     "@acronym{CRAN}-style repository, and @R{} users may want to set up their "
4211 :     "own. The `base' of a repository is a URL such as @uref{http://www.omegahat."
4212 :     "org/R/}: this must be an URL scheme that @code{download.packages} supports "
4213 :     "(which also includes @samp{ftp://} and @samp{file://}, but not on most "
4214 :     "systems @samp{https://}). Under that base URL there should be directory "
4215 :     "trees for one or more of the following types of package distributions:"
4216 :     msgstr ""
4217 :    
4218 :     #. type: itemize
4219 :     #: R-admin.texi:2304
4220 :     msgid ""
4221 :     "@code{\"source\"}: located at @file{src/contrib} and containing @file{.tar."
4222 :     "gz} files. Other forms of compression can be used, e.g.@: @file{.tar.bz2} "
4223 :     "or @file{.tar.xz} files. Complete repositories contain the sources "
4224 :     "corresponding to any binary packages, and in any case it is wise to have a "
4225 :     "@file{src/contrib} area with a possibly empty @file{PACKAGES} file."
4226 :     msgstr ""
4227 :    
4228 :     #. type: itemize
4229 :     #: R-admin.texi:2308
4230 :     msgid ""
4231 :     "@code{\"win.binary\"}: located at @file{bin/windows/contrib/@var{x.y}} for "
4232 :     "@R{} versions @var{x.y.z} and containing @file{.zip} files for Windows."
4233 :     msgstr ""
4234 :    
4235 :     #. type: itemize
4236 :     #: R-admin.texi:2313
4237 :     msgid ""
4238 :     "@code{\"mac.binary\"}: located at @file{bin/macosx/contrib/@var{3.y}} for "
4239 :     "@R{} versions @var{3.y.z} and containing @file{.tgz} files."
4240 :     msgstr ""
4241 :    
4242 :     #. type: itemize
4243 :     #: R-admin.texi:2319
4244 :     msgid ""
4245 :     "@code{\"mac.binary.mavericks\"}: located at @file{bin/macosx/mavericks/"
4246 :     "contrib/@var{3.y}} for @R{} versions @var{3.1.z} to be run under OS X 10.9 "
4247 :     "(Mavericks) and later, containing @file{.tgz} files."
4248 :     msgstr ""
4249 :    
4250 :     #. type: itemize
4251 :     #: R-admin.texi:2324
4252 :     msgid ""
4253 :     "@code{\"mac.binary.leopard\"}: located at @file{bin/macosx/leopard/contrib/"
4254 :     "@var{2.y}} for @R{} versions @var{2.y.z} and containing @file{.tgz} files."
4255 :     msgstr ""
4256 :    
4257 :     #. type: Plain text
4258 :     #: R-admin.texi:2337
4259 :     msgid ""
4260 :     "Each terminal directory must also contain a @file{PACKAGES} file. This can "
4261 :     "be a concatenation of the @file{DESCRIPTION} files of the packages separated "
4262 :     "by blank lines, but only a few of the fields are needed. The simplest way "
4263 :     "to set up such a file is to use function @code{write_PACKAGES} in the "
4264 :     "@pkg{tools} package, and its help explains which fields are needed. "
4265 :     "Optionally there can also be a @file{PACKAGES.gz} file, a @command{gzip}-"
4266 :     "compressed version of @file{PACKAGES}---as this will be downloaded in "
4267 :     "preference to @file{PACKAGES} it should be included for large repositories. "
4268 :     "(If you have a mis-configured server that does not report correctly non-"
4269 :     "existent files you may need @file{PACKAGES.gz}.)"
4270 :     msgstr ""
4271 :    
4272 :     #. type: Plain text
4273 :     #: R-admin.texi:2340
4274 :     msgid ""
4275 :     "To add your repository to the list offered by @code{setRepositories()}, see "
4276 :     "the help file for that function."
4277 :     msgstr ""
4278 :    
4279 :     #. type: Plain text
4280 :     #: R-admin.texi:2343
4281 :     msgid ""
4282 :     "Incomplete repositories are better specified @emph{via} a @code{contriburl} "
4283 :     "argument than @emph{via} being set as a repository."
4284 :     msgstr ""
4285 :    
4286 :     #. type: Plain text
4287 :     #: R-admin.texi:2347
4288 :     msgid ""
4289 :     "A repository can contain subdirectories, when the descriptions in the "
4290 :     "@file{PACKAGES} file of packages in subdirectories must include a line of "
4291 :     "the form"
4292 :     msgstr ""
4293 :    
4294 :     #. type: example
4295 :     #: R-admin.texi:2350
4296 :     #, no-wrap
4297 :     msgid "Path: @var{path/to/subdirectory}\n"
4298 :     msgstr ""
4299 :    
4300 :     #. type: Plain text
4301 :     #: R-admin.texi:2354
4302 :     msgid "---once again @code{write_PACKAGES} is the simplest way to set this up."
4303 :     msgstr ""
4304 :    
4305 :     #. type: Plain text
4306 :     #: R-admin.texi:2362
4307 :     msgid ""
4308 :     "It can be convenient to run @command{R CMD check} on an installed package, "
4309 :     "particularly on a platform which uses sub-architectures. The outline of how "
4310 :     "to do this is, with the source package in directory @file{@var{pkg}} (or a "
4311 :     "tarball filename):"
4312 :     msgstr ""
4313 :    
4314 :     #. type: example
4315 :     #: R-admin.texi:2366
4316 :     #, no-wrap
4317 :     msgid ""
4318 :     "R CMD INSTALL -l @var{libdir} @var{pkg} > @var{pkg}.log 2>&1\n"
4319 :     "R CMD check -l @var{libdir} --install=check:@var{pkg}.log @var{pkg}\n"
4320 :     msgstr ""
4321 :    
4322 :     #. type: Plain text
4323 :     #: R-admin.texi:2371
4324 :     msgid ""
4325 :     "Where sub-architectures are in use the @command{R CMD check} line can be "
4326 :     "repeated with additional architectures by"
4327 :     msgstr ""
4328 :    
4329 :     #. type: example
4330 :     #: R-admin.texi:2374
4331 :     #, no-wrap
4332 :     msgid "R --arch @var{arch} CMD check -l @var{libdir} --extra-arch --install=check:@var{pkg}.log @var{pkg}\n"
4333 :     msgstr ""
4334 :    
4335 :     #. type: Plain text
4336 :     #: R-admin.texi:2386
4337 :     msgid ""
4338 :     "where @option{--extra-arch} selects only those checks which depend on the "
4339 :     "installed code and not those which analyse the sources. (If multiple sub-"
4340 :     "architectures fail only because they need different settings, e.g.@: "
4341 :     "environment variables, @option{--no-multiarch} may need to be added to the "
4342 :     "@code{INSTALL} lines.) On Unix-alikes the architecture to run is selected "
4343 :     "by @option{--arch}: this can also be used on Windows with @file{@var{R_HOME}/"
4344 :     "bin/R.exe}, but it is more usual to select the path to the @command{Rcmd."
4345 :     "exe} of the desired architecture."
4346 :     msgstr ""
4347 :    
4348 :     #. type: Plain text
4349 :     #: R-admin.texi:2390
4350 :     msgid ""
4351 :     "So on Windows to install, check and package for distribution a source "
4352 :     "package from a tarball which has been tested on another platform one might "
4353 :     "use"
4354 :     msgstr ""
4355 :    
4356 :     #. type: example
4357 :     #: R-admin.texi:2395
4358 :     #, no-wrap
4359 :     msgid ""
4360 :     ".../bin/i386/Rcmd INSTALL -l @var{libdir} @var{tarball} --build > @var{pkg}.log 2>&1\n"
4361 :     ".../bin/i386/Rcmd check -l @var{libdir} --extra-arch --install=check:@var{pkg}.log @var{pkg}\n"
4362 :     ".../bin/x64/Rcmd check -l @var{libdir} --extra-arch --install=check:@var{pkg}.log @var{pkg}\n"
4363 :     msgstr ""
4364 :    
4365 :     #. type: Plain text
4366 :     #: R-admin.texi:2401
4367 :     msgid ""
4368 :     "where one might want to run the second and third lines in a different shell "
4369 :     "with different settings for environment variables and the path (to find "
4370 :     "external software, notably for Gtk+)."
4371 :     msgstr ""
4372 :    
4373 :     #. type: Plain text
4374 :     #: R-admin.texi:2404
4375 :     msgid ""
4376 :     "@command{R CMD INSTALL} can do a @code{i386} install and then add the "
4377 :     "@code{x64} DLL from a single command by"
4378 :     msgstr ""
4379 :    
4380 :     #. type: example
4381 :     #: R-admin.texi:2407
4382 :     #, no-wrap
4383 :     msgid "R CMD INSTALL --merge-multiarch -l @var{libdir} @var{tarball}\n"
4384 :     msgstr ""
4385 :    
4386 :     #. type: Plain text
4387 :     #: R-admin.texi:2411
4388 :     msgid "and @option{--build} can be added to zip up the installation."
4389 :     msgstr ""
4390 :    
4391 :     #. type: chapter
4392 :     #: R-admin.texi:2413
4393 :     #, no-wrap
4394 :     msgid "Internationalization and Localization"
4395 :     msgstr ""
4396 :    
4397 :     #. type: cindex
4398 :     #: R-admin.texi:2415
4399 :     #, no-wrap
4400 :     msgid "Localization"
4401 :     msgstr ""
4402 :    
4403 :     #. type: Plain text
4404 :     #: R-admin.texi:2420
4405 :     msgid ""
4406 :     "@emph{Internationalization} refers to the process of enabling support for "
4407 :     "many human languages, and @emph{localization} to adapting to a specific "
4408 :     "country and language."
4409 :     msgstr ""
4410 :    
4411 :     #. type: Plain text
4412 :     #: R-admin.texi:2429
4413 :     msgid ""
4414 :     "Current builds of @R{} support all the character sets that the underlying OS "
4415 :     "can handle. These are interpreted according to the"
4416 :     msgstr ""
4417 :    
4418 :     #. type: cindex
4419 :     #: R-admin.texi:2429
4420 :     #: R-admin.texi:2447
4421 :     #, no-wrap
4422 :     msgid "Locale"
4423 :     msgstr ""
4424 :    
4425 :     #. type: Plain text
4426 :     #: R-admin.texi:2436
4427 :     msgid ""
4428 :     "current @code{locale}, a sufficiently complicated topic to merit a separate "
4429 :     "section. Note though that @R{} has no built-in support for right-to-left "
4430 :     "languages and bidirectional output, relying on the OS services. For "
4431 :     "example, how character vectors in UTF-8 containing both English digits and "
4432 :     "Hebrew characters are printed is OS-dependent (and perhaps locale-dependent)."
4433 :     msgstr ""
4434 :    
4435 :     #. type: Plain text
4436 :     #: R-admin.texi:2439
4437 :     msgid ""
4438 :     "The other aspect of the internationalization is support for the translation "
4439 :     "of messages. This is enabled in almost all builds of @R{}."
4440 :     msgstr ""
4441 :    
4442 :     #. type: node
4443 :     #: R-admin.texi:2443
4444 :     #: R-admin.texi:2445
4445 :     #: R-admin.texi:2446
4446 :     #: R-admin.texi:2495
4447 :     #: R-admin.texi:2510
4448 :     #: R-admin.texi:2526
4449 :     #: R-admin.texi:2545
4450 :     #, no-wrap
4451 :     msgid "Locales"
4452 :     msgstr ""
4453 :    
4454 :     #. type: section
4455 :     #: R-admin.texi:2443
4456 :     #: R-admin.texi:2445
4457 :     #: R-admin.texi:2545
4458 :     #: R-admin.texi:2546
4459 :     #, no-wrap
4460 :     msgid "Localization of messages"
4461 :     msgstr ""
4462 :    
4463 :     #. type: Plain text
4464 :     #: R-admin.texi:2454
4465 :     msgid ""
4466 :     "A @emph{locale} is a description of the local environment of the user, "
4467 :     "including the preferred language, the encoding of characters, the currency "
4468 :     "used and its conventions, and so on. Aspects of the locale are accessed by "
4469 :     "the @R{} functions @code{Sys.getlocale} and @code{Sys.localeconv}."
4470 :     msgstr ""
4471 :    
4472 :     #. type: Plain text
4473 :     #: R-admin.texi:2458
4474 :     msgid ""
4475 :     "The system of naming locales is OS-specific. There is quite wide agreement "
4476 :     "on schemes, but not on the details of their implementation. A locale needs "
4477 :     "to specify"
4478 :     msgstr ""
4479 :    
4480 :     #. type: itemize
4481 :     #: R-admin.texi:2463
4482 :     msgid ""
4483 :     "A human language. These are generally specified by a lower-case two-"
4484 :     "character abbreviation following ISO 639 (see e.g.@: @uref{http://en."
4485 :     "wikipedia.org/@/wiki/@/ISO_639-1})."
4486 :     msgstr ""
4487 :    
4488 :     #. type: itemize
4489 :     #: R-admin.texi:2468
4490 :     msgid ""
4491 :     "A `territory', used mainly to specify the currency. These are generally "
4492 :     "specified by an upper-case two-character abbreviation following ISO 3166 "
4493 :     "(see e.g.@: @uref{http://@/en.wikipedia.org/@/wiki/@/ISO_3166})."
4494 :     msgstr ""
4495 :    
4496 :     #. type: itemize
4497 :     #: R-admin.texi:2475
4498 :     msgid ""
4499 :     "A charset encoding, which determines both how a byte stream should be "
4500 :     "divided into characters, and which characters the subsequences of bytes "
4501 :     "represent. Sometimes the combination of language and territory is used to "
4502 :     "specify the encoding, for example to distinguish between traditional and "
4503 :     "simplified Chinese."
4504 :     msgstr ""
4505 :    
4506 :     #. type: itemize
4507 :     #: R-admin.texi:2483
4508 :     msgid ""
4509 :     "Optionally, a modifier, for example to indicate that Austria is to be "
4510 :     "considered pre- or post-Euro. The modifier is also used to indicate the "
4511 :     "script (@code{@@latin}, @code{@@cyrillic} for Serbian, @code{@@iqtelif}) or "
4512 :     "language dialect (e.g.@: @code{@@saaho}, a dialect of Afar, and "
4513 :     "@code{@@bokmal} and @code{@@nynorsk}, dialects of Norwegian regarded by some "
4514 :     "OSes as separate languages, @code{no} and @code{nn})."
4515 :     msgstr ""
4516 :    
4517 :     #. type: Plain text
4518 :     #: R-admin.texi:2488
4519 :     msgid ""
4520 :     "@R{} is principally concerned with the first (for translations) and third. "
4521 :     "Note that the charset may be deducible from the language, as some OSes offer "
4522 :     "only one charset per language."
4523 :     msgstr ""
4524 :    
4525 :     #. type: node
4526 :     #: R-admin.texi:2493
4527 :     #: R-admin.texi:2495
4528 :     #: R-admin.texi:2496
4529 :     #: R-admin.texi:2510
4530 :     #, no-wrap
4531 :     msgid "Locales under Unix-alikes"
4532 :     msgstr ""
4533 :    
4534 :     #. type: node
4535 :     #: R-admin.texi:2493
4536 :     #: R-admin.texi:2495
4537 :     #: R-admin.texi:2510
4538 :     #: R-admin.texi:2511
4539 :     #: R-admin.texi:2526
4540 :     #, no-wrap
4541 :     msgid "Locales under Windows"
4542 :     msgstr ""
4543 :    
4544 :     #. type: subsection
4545 :     #: R-admin.texi:2493
4546 :     #: R-admin.texi:2510
4547 :     #: R-admin.texi:2526
4548 :     #: R-admin.texi:2527
4549 :     #, no-wrap
4550 :     msgid "Locales under OS X"
4551 :     msgstr ""
4552 :    
4553 :     #. type: Plain text
4554 :     #: R-admin.texi:2505
4555 :     msgid ""
4556 :     "Modern Linux uses the XPG@footnote{`X/Open Portability Guide', which has had "
4557 :     "several versions.} locale specifications which have the form @samp{en_GB}, "
4558 :     "@samp{en_GB.UTF-8}, @samp{aa_ER.UTF-8@@saaho}, @samp{de_AT.iso885915@@euro}, "
4559 :     "the components being in the order listed above. (See @command{man locale} "
4560 :     "and @command{locale -a} for more details.) Similar schemes are used by most "
4561 :     "Unix-alikes: some (including some distributions of Linux) use @samp{.utf8} "
4562 :     "rather than @samp{.UTF-8}."
4563 :     msgstr ""
4564 :    
4565 :     #. type: Plain text
4566 :     #: R-admin.texi:2509
4567 :     msgid ""
4568 :     "Note that whereas UTF-8 locales are nowadays almost universally used, "
4569 :     "locales such as @samp{en_GB} use 8-bit encodings for backwards compatibility."
4570 :     msgstr ""
4571 :    
4572 :     #. type: Plain text
4573 :     #: R-admin.texi:2519
4574 :     msgid ""
4575 :     "Windows also uses locales, but specified in a rather less concise way. Most "
4576 :     "users will encounter locales only via drop-down menus, but more information "
4577 :     "and lists can be found at @uref{http://msdn.microsoft.com/en-us/library/"
4578 :     "hzz3tw78(v=vs.80)} (or if Microsoft moves it yet again, search for "
4579 :     "@samp{Windows language country strings})."
4580 :     msgstr ""
4581 :    
4582 :     #. type: Plain text
4583 :     #: R-admin.texi:2521
4584 :     msgid "It offers only one encoding per language."
4585 :     msgstr ""
4586 :    
4587 :     #. type: Plain text
4588 :     #: R-admin.texi:2525
4589 :     msgid ""
4590 :     "Some care is needed with Windows' locale names. For example, @code{chinese} "
4591 :     "is Traditional Chinese and not Simplified Chinese as used in most of the "
4592 :     "Chinese-speaking world."
4593 :     msgstr ""
4594 :    
4595 :     #. type: Plain text
4596 :     #: R-admin.texi:2539
4597 :     msgid ""
4598 :     "OS X supports locales in its own particular way, but the R GUI tries to make "
4599 :     "this easier for users. See @uref{http://developer.apple.com/@/documentation/"
4600 :     "@/MacOSX/@/Conceptual/@/BPInternational/} for how users can set their "
4601 :     "locales. As with Windows, end users will generally only see lists of "
4602 :     "languages/territories. Users of @R{} in a terminal may need to set the "
4603 :     "locale to something like @samp{en_GB.UTF-8} if it defaults to @samp{C} (as "
4604 :     "it sometimes does when logging in remotely and for batch jobs: note whether "
4605 :     "@command{Terminal} sets the @env{LANG} environment variable is an (advanced) "
4606 :     "preference, but does so by default)."
4607 :     msgstr ""
4608 :    
4609 :     #. type: Plain text
4610 :     #: R-admin.texi:2543
4611 :     msgid ""
4612 :     "Internally OS X uses a form similar to Linux: the main difference from other "
4613 :     "Unix-alikes is that where a character set is not specified it is assumed to "
4614 :     "be @code{UTF-8}."
4615 :     msgstr ""
4616 :    
4617 :     #. type: Plain text
4618 :     #: R-admin.texi:2550
4619 :     msgid ""
4620 :     "The preferred language for messages is by default taken from the locale. "
4621 :     "This can be overridden first by the setting of the environment variable"
4622 :     msgstr ""
4623 :    
4624 :     #. type: enindex
4625 :     #: R-admin.texi:2550
4626 :     #: R-admin.texi:2623
4627 :     #, no-wrap
4628 :     msgid "LANGUAGE"
4629 :     msgstr ""
4630 :    
4631 :     #. type: enindex
4632 :     #: R-admin.texi:2551
4633 :     #, no-wrap
4634 :     msgid "LC_ALL"
4635 :     msgstr ""
4636 :    
4637 :     #. type: enindex
4638 :     #: R-admin.texi:2552
4639 :     #, no-wrap
4640 :     msgid "LC_MESSAGES"
4641 :     msgstr ""
4642 :    
4643 :     #. type: enindex
4644 :     #: R-admin.texi:2553
4645 :     #, no-wrap
4646 :     msgid "LANG"
4647 :     msgstr ""
4648 :    
4649 :     #. type: Plain text
4650 :     #: R-admin.texi:2565
4651 :     msgid ""
4652 :     "@env{LANGUAGE} and then@footnote{On some systems setting @env{LC_ALL} or "
4653 :     "@env{LC_MESSAGES} to @samp{C} disables @env{LANGUAGE}.} by the environment "
4654 :     "variables @env{LC_ALL}, @env{LC_MESSAGES} and @env{LANG}. (The last three "
4655 :     "are normally used to set the locale and so should not be needed, but the "
4656 :     "first is only used to select the language for messages.) The code tries "
4657 :     "hard to map locales to languages, but on some systems (notably Windows) the "
4658 :     "locale names needed for the environment variable @env{LC_ALL} do not all "
4659 :     "correspond to XPG language names and so @env{LANGUAGE} may need to be set. "
4660 :     "(One example is @samp{LC_ALL=es} on Windows which sets the locale to "
4661 :     "Estonian and the language to Spanish.)"
4662 :     msgstr ""
4663 :    
4664 :     #. type: Plain text
4665 :     #: R-admin.texi:2574
4666 :     msgid ""
4667 :     "It is usually possible to change the language once @R{} is running "
4668 :     "@emph{via} (not Windows) @code{Sys.setlocale(\"LC_MESSAGES\", \"new_locale"
4669 :     "\")}, or by setting an environment variable such as @env{LANGUAGE}, "
4670 :     "@emph{provided}@footnote{If you try changing from French to Russian except "
4671 :     "in a UTF-8 locale, you will most likely find messages change to English.} "
4672 :     "the language you are changing to can be output in the current character "
4673 :     "set. But this is OS-specific, and has been known to stop working on an OS "
4674 :     "upgrade."
4675 :     msgstr ""
4676 :    
4677 :     #. type: Plain text
4678 :     #: R-admin.texi:2578
4679 :     msgid ""
4680 :     "Messages are divided into @emph{domains}, and translations may be available "
4681 :     "for some or all messages in a domain. @R{} makes use of the following "
4682 :     "domains."
4683 :     msgstr ""
4684 :    
4685 :     #. type: itemize
4686 :     #: R-admin.texi:2583
4687 :     msgid ""
4688 :     "Domain @code{R} for the C-level error and warning messages from the @R{} "
4689 :     "interpreter."
4690 :     msgstr ""
4691 :    
4692 :     #. type: itemize
4693 :     #: R-admin.texi:2588
4694 :     msgid ""
4695 :     "Domain @code{R-@var{pkg}} for the R @code{stop}, @code{warning} and "
4696 :     "@code{message} messages in each package, including @code{R-base} for the "
4697 :     "@pkg{base} package."
4698 :     msgstr ""
4699 :    
4700 :     #. type: itemize
4701 :     #: R-admin.texi:2591
4702 :     msgid "Domain @code{@var{pkg}} for the C-level messages in each package."
4703 :     msgstr ""
4704 :    
4705 :     #. type: itemize
4706 :     #: R-admin.texi:2594
4707 :     msgid ""
4708 :     "Domain @code{RGui} for the menus etc of the R for Windows GUI front-end."
4709 :     msgstr ""
4710 :    
4711 :     #. type: Plain text
4712 :     #: R-admin.texi:2600
4713 :     msgid ""
4714 :     "Dividing up the messages in this way allows @R{} to be extensible: as "
4715 :     "packages are loaded, their message translation catalogues can be loaded too."
4716 :     msgstr ""
4717 :    
4718 :     #. type: Plain text
4719 :     #: R-admin.texi:2603
4720 :     msgid ""
4721 :     "@R{} can be built without support for translations, but it is enabled by "
4722 :     "default."
4723 :     msgstr ""
4724 :