Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 94 lines (69 sloc) 3.804 kB
fa44a2c Initial revision
r authored
1
2 INSTALLING R UNDER UNIX
3
4
5 GENERALITIES
6
7 R will configure and build under a number of common Unix platforms
8 including dec-alpha-osf, freebsd, hpux, linux-elf, sgi-irix, solaris,
9 and sunos. In general it is relatively easy to adapt R to new
10 platforms. See below for details.
11
12
13 SIMPLE INSTALLATION
14
da9f5c7 Explain that `make docs' requires Perl version 5 etc.
hornik authored
15 Choose a place to install the R tree (R is not just a binary, but has
16 additional data sets, help files, font metrics etc). Let's call this
17 place RHOME. Untar the source code. This should create directories
18 src, etc, cmd, help and doc. Issue the following commands:
fa44a2c Initial revision
r authored
19
20 ./configure
21 make
22
da9f5c7 Explain that `make docs' requires Perl version 5 etc.
hornik authored
23 If these commands execute successfully, the R binary will be copied to
24 the `$RHOME/bin' directory. In addition, a shell script font-end
25 called "R" will be created and copied to the same directory. You can
26 copy this script to a place where users can invoke it, for example to
27 `/usr/local/bin/R'. You could also copy the man page `R.1' to a place
28 where your man reader finds it, such as `/usr/local/man/man1'.
fa44a2c Initial revision
r authored
29
da9f5c7 Explain that `make docs' requires Perl version 5 etc.
hornik authored
30 Using
fa44a2c Initial revision
r authored
31
32 make docs
33
da9f5c7 Explain that `make docs' requires Perl version 5 etc.
hornik authored
34 will build plain text help pages as well as HTML and LaTeX versions of
35 the documentation (the three kinds can also be generated separately
36 using make help, make html and make latex). Note that as of R version
37 0.60, you need Perl version 5 to build the documentation. If this is
38 not available on your system, you can obtain precompiled documentation
39 files via the `doc/pre-formatted-help' directory of the Comprehensive
40 R Archive Network (CRAN), see the file `RESOURCES' for information on
41 CRAN.
fa44a2c Initial revision
r authored
42
43 Now type R and reach for your S manuals ...
44
45
46 USING FORTRAN
47
48 R is "shipped" configured so that it does not need a Fortran compiler
49 to build and install. For performance or other reasons you may
50 wish to use your Fortran compiler to compile those pieces of R
51 which are written in Fortran. To do this, edit the file config.site
52 and change the line "F77=no" as indicated in the comments above
53 before typing configure. There are no guarantees that this will
54 work, but it may.
55
56
57 NEW PLATFORMS (Standards Hah!)
58
59 There are a number of sources of problems when installing R on a new
60 harware/os platform.
61
62 1. Floating Point Arithmetic: R supports the POSIX, SVID and IEEE
63 models for floating point arithmetic. The POSIX and SVID models
64 provide no problems. The IEEE model however can be a pain. The
65 problem is that there is no agreement on how to set the signalling
66 behavior; sgi/irix and linux require no special action, freebsd
67 requires a call to (the macro) fpsetmask(0) and osf1v3.2 requires
68 that computation be done with a -ieee_with_inexact flag etc...
69 On a new platform you must find out the magic recipe and add some
70 code to make it work. This can often be done via the file
71 config.site which resides in the top level directory.
72
73 2. Shared Libraries: There seems to be very little agreement across
74 platforms on what needs to be done to build shared libraries.
75 there are many different combinations of flags for the compilers
76 and loaders. The technique we use is to interrogate the X window
77 system about what it does (using xmkmf). This often works, but
78 you may have to manually override the results. Scanning the cc(1)
79 and ld(1) manual entries usually reveals the correct incantation.
80 Once you know the recipe you can modify the file config.site
81 (following the instructions therein) so that the build will use
82 these options.
83
84 If you do manage to get R running on a new platform please let us know
85 about it so we can modify the configuration procedures to include that
86 platform.
87
88 If you are having trouble getting R to work on your platform please
89 feel free to get in touch to ask questions. We've had a fair amount
90 of practice at porting R to new platforms...
91
92 Ross-n-Robert
93 R@stat.auckland.ac.nz
Something went wrong with that request. Please try again.