Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 127 lines (93 sloc) 4.944 kb
fa44a2cd » r
1997-09-18 Initial revision
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
94e6a91a » leisch
1998-06-10 added make install
13 SIMPLE COMPILATION
fa44a2cd » r
1997-09-18 Initial revision
14
da9f5c75 » hornik
1997-12-10 Explain that `make docs' requires Perl version 5 etc.
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:
fa44a2cd » r
1997-09-18 Initial revision
19
20 ./configure
21 make
22
da9f5c75 » hornik
1997-12-10 Explain that `make docs' requires Perl version 5 etc.
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
94e6a91a » leisch
1998-06-10 added make install
28 where your man reader finds it, such as `/usr/local/man/man1'. If you
29 want to install the complete R tree to, e.g., /usr/local/lib/R, see
30 section INSTALLATION below.
fa44a2cd » r
1997-09-18 Initial revision
31
f7f10e38 » hornik
1998-03-06 Explain configure command line options.
32 If you need or want to set certain configure variables to something
33 other than their default, you can do that by either editing the file
34 `config.site' or on the command line as
35
36 VAR="..." ./configure # Bourne shell compatibles
37 (setenv VAR "..."; ./configure) # C shell
38
eff400bd » thomas
1998-04-03 warning about papersize in INSTALL
39 One common variable to change is R_PAPERSIZE, which defaults to a4, not
40 letter.
41
94e6a91a » leisch
1998-06-10 added make install
42 Make will also build plain text help pages as well as HTML and LaTeX
43 versions of the documentation (the three kinds can also be generated
44 separately using make help, make html and make latex). Note that as
45 of R version 0.60, you need Perl version 5 to build the documentation.
46 If this is not available on your system, you can obtain precompiled
47 documentation files via the `doc/pre-formatted-help' directory of the
48 Comprehensive R Archive Network (CRAN), see the file `RESOURCES' for
49 information on CRAN.
fa44a2cd » r
1997-09-18 Initial revision
50
94e6a91a » leisch
1998-06-10 added make install
51 Now type R and reach for your S manuals ...
fa44a2cd » r
1997-09-18 Initial revision
52
53
94e6a91a » leisch
1998-06-10 added make install
54 INSTALLATION
55
56 After
57 ./configure
58 make
59 have been completed successfully, you can install the complete R tree
60 to your system by typing
61
62 make install
63
64 This will install to the following directories:
65
66 $prefix/bin execeutables
67 $prefix/man/man1 man pages
68 $prefix/lib/R all the rest (libraries, online help
69 system, ...)
70
71 where prefix is determined during configuration (typically /usr/local)
72 and can be set by running configure with the option
73
74 ./configure --prefix=/where/you/want/R/to/go
75
76 The prefix of the installation directories can also be seen in the
77 status message that is displayed at the end of configure.
fa44a2cd » r
1997-09-18 Initial revision
78
79
80 USING FORTRAN
81
f7f10e38 » hornik
1998-03-06 Explain configure command line options.
82 To compile R, you need a FORTRAN compiler or f2c, the FORTRAN-to-C
fae2d086 » hornik
1998-03-22 Also look for fort77.
83 converter. The default is to search for g77, fort77, f77, f90, xlf,
84 cf77, and fc (in that order), and then for f2c, and use whichever is
85 found first; if none is found, R cannot be compiled. The search
86 mechanism can be changed using the `--with-g77', `--with-f77', and
87 `--with-f2c' command line options to configure. If your FORTRAN
88 compiler is in a non-standard location, you can specify it via
89 `--with-f77=path.to.f77'.
fa44a2cd » r
1997-09-18 Initial revision
90
91
92 NEW PLATFORMS (Standards Hah!)
93
94 There are a number of sources of problems when installing R on a new
95 harware/os platform.
96
97 1. Floating Point Arithmetic: R supports the POSIX, SVID and IEEE
98 models for floating point arithmetic. The POSIX and SVID models
99 provide no problems. The IEEE model however can be a pain. The
100 problem is that there is no agreement on how to set the signalling
101 behavior; sgi/irix and linux require no special action, freebsd
102 requires a call to (the macro) fpsetmask(0) and osf1v3.2 requires
103 that computation be done with a -ieee_with_inexact flag etc...
104 On a new platform you must find out the magic recipe and add some
105 code to make it work. This can often be done via the file
106 config.site which resides in the top level directory.
107
108 2. Shared Libraries: There seems to be very little agreement across
109 platforms on what needs to be done to build shared libraries.
110 there are many different combinations of flags for the compilers
111 and loaders. The technique we use is to interrogate the X window
112 system about what it does (using xmkmf). This often works, but
113 you may have to manually override the results. Scanning the cc(1)
114 and ld(1) manual entries usually reveals the correct incantation.
115 Once you know the recipe you can modify the file config.site
116 (following the instructions therein) so that the build will use
117 these options.
118
119 If you do manage to get R running on a new platform please let us know
120 about it so we can modify the configuration procedures to include that
121 platform.
122
123 If you are having trouble getting R to work on your platform please
124 feel free to get in touch to ask questions. We've had a fair amount
125 of practice at porting R to new platforms...
126
3ade4989 » ihaka
1998-05-26 Updates
127 R Core Members
Something went wrong with that request. Please try again.