annotate doc/interpreter/install.texi @ 3176:fccab8e7d35f

[project @ 1998-05-18 20:33:31 by jwe]
author jwe
date Mon, 18 May 1998 20:33:42 +0000
parents 8cdcb8945695
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2670
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
1 @c Copyright (C) 1996, 1997 John W. Eaton
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
2 @c This is part of the Octave manual.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
3 @c For copying conditions, see the file gpl.texi.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
4
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
5 @c The text of this file will eventually appear in the file INSTALL
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
6 @c in the Octave distribution, as well as in the Octave manual.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
7
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
8 @ifclear INSTALLONLY
2670
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
9 @node Installation, Emacs, Trouble, Top
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
10 @appendix Installing Octave
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
11 @end ifclear
2627
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
12
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
13 @ifset INSTALLONLY
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
14 @include conf.texi
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
15
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
16 This file documents the installation of Octave.
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
17
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
18 Octave is free software; you can redistribute it and/or modify it
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
19 under the terms of the GNU General Public License as published by the
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
20 Free Software Foundation.
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
21
2653
e7908588548a [project @ 1997-02-01 16:53:52 by jwe]
jwe
parents: 2629
diff changeset
22 @node Installation, , Installation
2627
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
23 @chapter Installing Octave
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
24 @end ifset
0b852cbea582 [project @ 1997-01-27 04:07:05 by jwe]
jwe
parents: 2621
diff changeset
25
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
26 @cindex installing Octave
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
27
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
28 Here is the procedure for installing Octave from scratch on a Unix
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
29 system. For instructions on how to install the binary distributions of
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
30 Octave, see @ref{Binary Distributions}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
31
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
32 @itemize @bullet
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
33 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
34 Run the shell script @file{configure}. This will determine the features
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
35 your system has (or doesn't have) and create a file named
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
36 @file{Makefile} from each of the files named @file{Makefile.in}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
37
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
38 Here is a summary of the configure options that are most frequently used
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
39 when building Octave:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
40
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
41 @table @code
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
42 @item --prefix=@var{prefix}
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
43 Install Octave in subdirectories below @var{prefix}. The default value
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
44 of @var{prefix} is @file{/usr/local}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
45
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
46 @item --srcdir=@var{dir}
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
47 Look for Octave sources in the directory @var{dir}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
48
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
49 @item --with-f2c
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
50 Use @code{f2c} even if a Fortran compiler is available.
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
51
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
52 @item --with-g77
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
53 Use @code{g77} to compile Fortran code.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
54
2799
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
55 @item --enable-shared
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
56 Create shared libraries. If you are planning to use
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
57 @code{--enable-lite-kernelel} or the dynamic loading features, you will
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
58 probably want to use this option. It will make your @file{.oct} files
3069
db6d57d718f7 [project @ 1997-07-10 23:34:03 by jwe]
jwe
parents: 2993
diff changeset
59 much smaller and on some systems it may be necessary to build shared
db6d57d718f7 [project @ 1997-07-10 23:34:03 by jwe]
jwe
parents: 2993
diff changeset
60 libraries in order to use dynamically linked functions.
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
61
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
62 You may also want to build a shared version of @code{libstdc++}, if your
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
63 system doesn't already have one. Note that a patch is needed to build
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
64 shared versions of version 2.7.2 of @code{libstdc++} on the HP-PA
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
65 architecture. You can find the patch at
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
66 @url{ftp://ftp.cygnus.com/pub/g++/libg++-2.7.2-hppa-gcc-fix}.
2799
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
67
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
68 @item --enable-dl
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
69 Use @code{dlopen} and friends to make Octave capable of dynamically
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
70 linking externally compiled functions. This only works on systems that
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
71 actually have these functions. If you plan on using this feature, you
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
72 should probably also use @code{--enable-shared} to reduce the size of
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
73 your @file{.oct} files.
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
74
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
75 @item --enable-shl
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
76 Use @code{shl_load} and friends to make Octave capable of dynamically
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
77 linking externally compiled functions. This only works on systems that
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
78 actually have these functions (only HP-UX systems). If you plan on
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
79 using this feature, you should probably also use @code{--enable-shared}
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
80 to reduce the size of your @file{.oct} files.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
81
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
82 @item --enable-lite-kernel
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
83 Compile smaller kernel. This currently requires the dynamic linking
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
84 functions @code{dlopen} or @code{shl_load} and friends so that Octave
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
85 can load functions at run time that are not loaded at compile time.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
86
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
87 @item --help
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
88 Print a summary of the options recognized by the configure script.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
89 @end table
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
90
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
91 See the file @file{INSTALL} for more information about the command line
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
92 options used by configure. That file also contains instructions for
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
93 compiling in a directory other than where the source is located.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
94
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
95 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
96 Run make.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
97
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
98 You will need a recent version of GNU Make. Modifying Octave's
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
99 makefiles to work with other make programs is probably not worth
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
100 your time. We recommend you get and compile GNU Make instead.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
101
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
102 For plotting, you will need to have gnuplot installed on your system.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
103 Gnuplot is a command-driven interactive function plotting program.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
104 Gnuplot is copyrighted, but freely distributable. The `gnu' in gnuplot
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
105 is a coincidence---it is not related to the GNU project or the FSF in
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
106 any but the most peripheral sense.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
107
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
108 To compile Octave, you will need a recent version of GNU Make. You
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
109 will also need @code{g++} 2.7.2 or later. Version 2.8.0 or @code{egcs}
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
110 1.0.x should work. Later versions may work, but C++ is still evolving,
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
111 so don't be too surprised if you run into some trouble.
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
112
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
113 It is no longer necessary to have @code{libg++}, but you do need to have
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
114 the GNU implementation of @code{libstdc++}. If you are using @code{g++}
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
115 2.7.2, @code{libstdc++} is distributed along with @code{libg++}, but for
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
116 later versions, @code{libstdc++} is distributed separately. For
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
117 @code{egcs}, @code{libstdc++} is included with the compiler
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
118 distribution.
3079
eb827eb9b8ff [project @ 1997-08-03 20:44:07 by jwe]
jwe
parents: 3073
diff changeset
119
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
120 If you plan to modify the parser you will also need GNU @code{bison} and
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
121 @code{flex}. If you modify the documentation, you will need GNU
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
122 Texinfo, along with the patch for the @code{makeinfo} program that is
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
123 distributed with Octave.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
124
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
125 GNU Make, @code{gcc}, and @code{libstdc++}, @code{gnuplot},
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
126 @code{bison}, @code{flex}, and Texinfo are all available from many
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
127 anonymous ftp archives. The primary site is @url{ftp.gnu.org}, but it
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
128 is often very busy. A list of sites that mirror the software on
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
129 @url{ftp.gnu.org} is available by anonymous ftp from
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
130 @url{ftp://ftp.gnu.org/pub/gnu/GNUinfo/FTP}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
131
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
132 If you don't have a Fortran compiler, or if your Fortran compiler
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
133 doesn't work like the traditional Unix f77, you will need to have the
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
134 Fortran to C translator @code{f2c}. You can get @code{f2c} from any
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
135 number of anonymous ftp archives. The most recent version of @code{f2c}
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
136 is always available from @url{netlib.att.com}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
137
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
138 On an otherwise idle Pentium 133 running Linux, it will take somewhere
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
139 between 1-1/2 to 3 hours to compile everything, depending on whether you
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
140 are building shared libraries. You will need about 100 megabytes of disk
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
141 storage to work with (considerably less if you don't compile with debugging
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
142 symbols). To do that, use the command
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
143
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
144 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
145 make CFLAGS=-O CXXFLAGS=-O LDFLAGS=
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
146 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
147
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
148 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
149 instead of just @samp{make}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
150
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
151 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
152 If you encounter errors while compiling Octave, first check the list of
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
153 known problems below to see if there is a workaround or solution for
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
154 your problem. If not,
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
155 @ifclear INSTALLONLY
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
156 see @ref{Trouble},
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
157 @end ifclear
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
158 @ifset INSTALLONLY
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
159 see the file BUGS
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
160 @end ifset
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
161 for information about how to report bugs.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
162
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
163 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
164 Once you have successfully compiled Octave, run @samp{make install}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
165
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
166 This will install a copy of octave, its libraries, and its documentation
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
167 in the destination directory. As distributed, Octave is installed in
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
168 the following directories. In the table below, @var{prefix} defaults to
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
169 @file{/usr/local}, @var{version} stands for the current version number
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
170 of the interpreter, and @var{arch} is the type of computer on which
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
171 Octave is installed (for example, @samp{i586-unknown-gnu}).
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
172
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
173 @table @file
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
174 @item @var{prefix}/bin
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
175 Octave and other binaries that people will want to run directly.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
176
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
177 @item @var{prefix}/lib
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
178 Libraries like libcruft.a and liboctave.a.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
179
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
180 @item @var{prefix}/share
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
181 Architecture-independent data files.
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
182
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
183 @item @var{prefix}/include/octave
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
184 Include files distributed with Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
185
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
186 @item @var{prefix}/man/man1
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
187 Unix-style man pages describing Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
188
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
189 @item @var{prefix}/info
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
190 Info files describing Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
191
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
192 @item @var{prefix}/share/octave/@var{version}/m
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
193 Function files distributed with Octave. This includes the Octave
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
194 version, so that multiple versions of Octave may be installed at the
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
195 same time.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
196
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
197 @item @var{prefix}/lib/octave/@var{version}/exec/@var{arch}
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
198 Executables to be run by Octave rather than the user.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
199
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
200 @item @var{prefix}/lib/octave/@var{version}/oct/@var{arch}
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
201 Object files that will be dynamically loaded.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
202
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
203 @item @var{prefix}/share/octave/@var{version}/imagelib
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
204 Image files that are distributed with Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
205 @end table
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
206 @end itemize
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
207
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
208 @menu
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
209 * Installation Problems::
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
210 * Binary Distributions::
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
211 @end menu
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
212
3079
eb827eb9b8ff [project @ 1997-08-03 20:44:07 by jwe]
jwe
parents: 3073
diff changeset
213 @node Installation Problems, Binary Distributions, Installation, Installation
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
214 @appendixsec Installation Problems
2799
d77a29e4387f [project @ 1997-03-08 08:35:56 by jwe]
jwe
parents: 2703
diff changeset
215
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
216 This section contains a list of problems (and some apparent problems
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
217 that don't really mean anything is wrong) that may show up during
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
218 installation of Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
219
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
220 @itemize @bullet
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
221 @item
2512
fda09c1e787e [project @ 1996-11-14 08:39:41 by jwe]
jwe
parents: 2495
diff changeset
222 On some SCO systems, @code{info} fails to compile if
fda09c1e787e [project @ 1996-11-14 08:39:41 by jwe]
jwe
parents: 2495
diff changeset
223 @code{HAVE_TERMIOS_H} is defined int @file{config.h}. Simply removing
fda09c1e787e [project @ 1996-11-14 08:39:41 by jwe]
jwe
parents: 2495
diff changeset
224 the definition from @file{info/config.h} should allow it to compile.
fda09c1e787e [project @ 1996-11-14 08:39:41 by jwe]
jwe
parents: 2495
diff changeset
225
fda09c1e787e [project @ 1996-11-14 08:39:41 by jwe]
jwe
parents: 2495
diff changeset
226 @item
2495
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
227 If @code{configure} finds @code{dlopen}, @code{dlsym}, @code{dlclose},
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
228 and @code{dlerror}, but not the header file @file{dlfcn.h}, you need to
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
229 find the source for the header file and install it in the directory
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
230 @file{usr/include}. This is reportedly a problem with Slackware 3.1.
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
231 For Linux/GNU systems, the source for @file{dlfcn.h} is in the
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
232 @code{ldso} package.
2495
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
233
29cd3862a9dc [project @ 1996-11-11 02:39:49 by jwe]
jwe
parents: 2488
diff changeset
234 @item
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
235 Building @file{.oct} files doesn't work.
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
236
3148
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
237 You should probably have a shared version of @code{libstdc++}. A patch
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
238 is needed to build shared versions of version 2.7.2 of @code{libstdc++}
8cdcb8945695 [project @ 1998-02-06 21:25:11 by jwe]
jwe
parents: 3130
diff changeset
239 on the HP-PA architecture. You can find the patch at
2862
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
240 @url{ftp://ftp.cygnus.com/pub/g++/libg++-2.7.2-hppa-gcc-fix}.
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
241
95e85daad148 [project @ 1997-04-15 22:00:57 by jwe]
jwe
parents: 2799
diff changeset
242 @item
3130
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
243 On FreeBSD systems Octave may hang while initializing some internal
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
244 constants. The fix appears to be to use
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
245
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
246 @example
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
247 options GPL_MATH_EMULATE
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
248 @end example
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
249
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
250 @noindent
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
251 rather than
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
252
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
253 @example
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
254 options MATH_EMULATE
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
255 @end example
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
256
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
257 @noindent
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
258 in the kernel configuration files (typically found in the directory
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
259 @file{/sys/i386/conf}. After making this change, you'll need to rebuild
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
260 the kernel, install it, and reboot.
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
261
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 3079
diff changeset
262 @item
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
263 If you encounter errors like
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
264
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
265 @smallexample
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
266 @group
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
267 passing `void (*)()' as argument 2 of
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
268 `octave_set_signal_handler(int, void (*)(int))'
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
269 @end group
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
270 @end smallexample
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
271
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
272 @noindent
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
273 or
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
274
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
275 @smallexample
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
276 warning: ANSI C++ prohibits conversion from `(int)' to `(...)'
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
277 @end smallexample
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
278
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
279 @noindent
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
280 while compiling @file{sighandlers.cc}, you may need to edit some files
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
281 in the @code{gcc} include subdirectory to add proper prototypes for functions
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
282 there. For example, Ultrix 4.2 needs proper declarations for the
2670
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
283 @code{signal} function and the @code{SIG_IGN} macro in the file
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
284 @file{signal.h}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
285
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
286 On some systems the @code{SIG_IGN} macro is defined to be something like
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
287 this:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
288
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
289 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
290 #define SIG_IGN (void (*)())1
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
291 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
292
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
293 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
294 when it should really be something like:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
295
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
296 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
297 #define SIG_IGN (void (*)(int))1
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
298 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
299
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
300 @noindent
2670
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
301 to match the prototype declaration for the @code{signal} function. This
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
302 change should also be made for the @code{SIG_DFL} and @code{SIG_ERR}
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
303 symbols. It may be necessary to change the definitions in
18192eea4973 [project @ 1997-02-13 18:29:53 by jwe]
jwe
parents: 2653
diff changeset
304 @file{sys/signal.h} as well.
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
305
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
306 The @code{gcc} @code{fixincludes} and @code{fixproto} scripts should
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
307 probably fix these problems when @code{gcc} installs its modified set of
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
308 header files, but I don't think that's been done yet.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
309
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
310 @strong{You should not change the files in @file{/usr/include}}. You
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
311 can find the @code{gcc} include directory tree by running the command
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
312
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
313 @example
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
314 gcc -print-libgcc-file-name
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
315 @end example
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
316
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
317 @noindent
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
318 The directory of @code{gcc} include files normally begins in the same directory
2621
337a09dd1c06 [project @ 1997-01-24 21:49:41 by jwe]
jwe
parents: 2570
diff changeset
319 that contains the file @file{libgcc.a}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
320
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
321 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
322 Some of the Fortran subroutines may fail to compile with older versions
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
323 of the Sun Fortran compiler. If you get errors like
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
324
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
325 @smallexample
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
326 zgemm.f:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
327 zgemm:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
328 warning: unexpected parent of complex expression subtree
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
329 zgemm.f, line 245: warning: unexpected parent of complex
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
330 expression subtree
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
331 warning: unexpected parent of complex expression subtree
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
332 zgemm.f, line 304: warning: unexpected parent of complex
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
333 expression subtree
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
334 warning: unexpected parent of complex expression subtree
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
335 zgemm.f, line 327: warning: unexpected parent of complex
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
336 expression subtree
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
337 pcc_binval: missing IR_CONV in complex op
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
338 make[2]: *** [zgemm.o] Error 1
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
339 @end smallexample
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
340
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
341 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
342 when compiling the Fortran subroutines in the @file{libcruft}
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
343 subdirectory, you should either upgrade your compiler or try compiling
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
344 with optimization turned off.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
345
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
346 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
347 On NeXT systems, if you get errors like this:
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
348
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
349 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
350 /usr/tmp/cc007458.s:unknown:Undefined local symbol LBB7656
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
351 /usr/tmp/cc007458.s:unknown:Undefined local symbol LBE7656
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
352 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
353
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
354 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
355 when compiling @file{Array.cc} and @file{Matrix.cc}, try recompiling
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
356 these files without @code{-g}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
357
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
358 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
359 Some people have reported that calls to shell_cmd and the pager do not
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
360 work on SunOS systems. This is apparently due to having
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
361 @code{G_HAVE_SYS_WAIT} defined to be 0 instead of 1 when compiling
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
362 @code{libg++}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
363
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
364 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
365 On NeXT systems, linking to @file{libsys_s.a} may fail to resolve the
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
366 following functions
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
367
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
368 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
369 _tcgetattr
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
370 _tcsetattr
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
371 _tcflow
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
372 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
373
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
374 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
375 which are part of @file{libposix.a}. Unfortunately, linking Octave with
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
376 @code{-posix} results in the following undefined symbols.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
377
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
378 @example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
379 .destructors_used
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
380 .constructors_used
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
381 _objc_msgSend
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
382 _NXGetDefaultValue
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
383 _NXRegisterDefaults
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
384 .objc_class_name_NXStringTable
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
385 .objc_class_name_NXBundle
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
386 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
387
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
388 One kluge around this problem is to extract @file{termios.o} from
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
389 @file{libposix.a}, put it in Octave's @file{src} directory, and add it
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
390 to the list of files to link together in the makefile. Suggestions for
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
391 better ways to solve this problem are welcome!
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
392
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
393 @item
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
394 If Octave crashes immediately with a floating point exception, it is
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
395 likely that it is failing to initialize the IEEE floating point values
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
396 for infinity and NaN.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
397
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
398 If your system actually does support IEEE arithmetic, you should be able
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
399 to fix this problem by modifying the function @code{octave_ieee_init} in
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
400 the file @file{lo-ieee.cc} to correctly initialize Octave's internal
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
401 infinity and NaN variables.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
402
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
403 If your system does not support IEEE arithmetic but Octave's configure
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
404 script incorrectly determined that it does, you can work around the
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
405 problem by editing the file @file{config.h} to not define
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
406 @code{HAVE_ISINF}, @code{HAVE_FINITE}, and @code{HAVE_ISNAN}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
407
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
408 In any case, please report this as a bug since it might be possible to
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
409 modify Octave's configuration script to automatically determine the
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
410 proper thing to do.
3073
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
411
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
412 @item
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
413 After installing the binary distribution of Octave in an alternate
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
414 directory, the Emacs command @code{run-octave} doesn't work. Emacs
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
415 hangs in @code{accept-process-output} in @code{inferior-octave-startup}.
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
416
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
417 This seems to be a problem with executing a shell script using the
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
418 comint package. You can avoid the problem by changing the way Octave is
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
419 installed to eliminate the need for the shell script. You can either
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
420 compile and install Octave using the source distribution, reinstall the
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
421 binary distribution in the default directory, or copy the commands in
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
422 the octave shell script wrapper to your shell startup files (and the
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
423 shell startup files for anyone else who is using Octave) and then
132c83a7b706 [project @ 1997-07-17 14:43:32 by jwe]
jwe
parents: 3069
diff changeset
424 rename the file @file{octave.bin} to be @file{octave}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
425 @end itemize
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
426
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
427 @node Binary Distributions, , Installation Problems, Installation
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
428 @appendixsec Binary Distributions
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
429
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
430 Although Octave is not very difficult to build from its sources, it is a
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
431 relatively large program that does require a significant amount of time
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
432 and disk space to compile and install. Because of this, many people
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
433 want to be able to obtain binary distributions so they can start using
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
434 Octave immediately, without having to bother with the details of
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
435 compiling it first. This is understandable, so I try to maintain a
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
436 current collection of binary distributions at
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
437 @url{ftp://ftp.che.wisc.edu/pub/octave/BINARIES}.
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
438
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
439 Please understand, however, that there is only a limited amount of time
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
440 available to devote to making binaries, so binaries may not be
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
441 immediately available for some platforms. (Please contact
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
442 @email{bug-octave@@bevo.che.wisc.edu} if you are interested in helping
2703
41d6a1c814c4 [project @ 1997-02-19 19:25:55 by jwe]
jwe
parents: 2689
diff changeset
443 make a binary distribution available for your system.)
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
444
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
445 @menu
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
446 * Installing Octave from a Binary Distribution::
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
447 * Creating a Binary Distribution::
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
448 @end menu
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
449
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
450 @node Installing Octave from a Binary Distribution, Creating a Binary Distribution, Binary Distributions, Binary Distributions
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
451 @appendixsubsec Installing Octave from a Binary Distribution
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
452
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
453 To install Octave from a binary distribution, execute the command
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
454
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
455 @example
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
456 sh ./install-octave
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
457 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
458
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
459 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
460 in the top level directory of the distribution.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
461
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
462 Binary distributions are normally compiled assuming that Octave will be
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
463 installed in the following subdirectories of @file{/usr/local}.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
464
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
465 @table @file
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
466 @item bin
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
467 Octave and other binaries that people will want to run directly.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
468
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
469 @item lib
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
470 Shared libraries that Octave needs in order to run. These files are
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
471 not included if you are installing a statically linked version of
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
472 Octave.
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
473
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
474 @item man/man1
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
475 Unix-style man pages describing Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
476
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
477 @item info
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
478 Info files describing Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
479
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
480 @item share/octave/@var{version}/m
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
481 Function files distributed with Octave. This includes the Octave
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
482 version, so that multiple versions of Octave may be installed at the
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
483 same time.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
484
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
485 @item libexec/octave/@var{version}/exec/@var{arch}
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
486 Executables to be run by Octave rather than the user.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
487
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
488 @item libexec/octave/@var{version}/oct/@var{arch}
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
489 Object files that will be dynamically loaded.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
490
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
491 @item share/octave/@var{version}/imagelib
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
492 Image files that are distributed with Octave.
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
493 @end table
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
494
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
495 @noindent
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
496 where @var{version} stands for the current version number of the
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
497 interpreter, and @var{arch} is the type of computer on which Octave
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
498 is installed (for example, @samp{@value{TARGETHOSTTYPE}}).
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
499
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
500 If these directories don't exist, the script @code{install-octave} will
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
501 create them for you. The installation script also creates the following
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
502 subdirectories of @file{/usr/local} that are intended for locally
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
503 installed functions:
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
504
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
505 @table @file
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
506 @item share/octave/site/m
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
507 Locally installed M-files.
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
508
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
509 @item libexec/octave/site/exec/@var{arch}
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
510 Locally installed binaries intended to be run by Octave rather than by
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
511 the user.
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
512
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2862
diff changeset
513 @item libexec/octave/site/octave/@var{arch}
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
514 Local object files that will be dynamically linked.
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
515 @end table
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
516
2469
f201716926bb [project @ 1996-11-05 19:39:33 by jwe]
jwe
parents: 2333
diff changeset
517 If it is not possible for you to install Octave in @file{/usr/local}, or
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
518 if you would prefer to install it in a different directory, you can
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
519 specify the name of the top level directory as an argument to the
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
520 @file{install-octave} script. For example:
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
521
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
522 @example
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
523 sh ./install-octave /some/other/directory
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
524 @end example
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
525
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
526 @noindent
2535
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
527 will install Octave in subdirectories of the directory
caa21ce81913 [project @ 1996-11-19 19:53:55 by jwe]
jwe
parents: 2512
diff changeset
528 @file{/some/other/directory}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
529
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
530 @node Creating a Binary Distribution, , Installing Octave from a Binary Distribution, Binary Distributions
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
531 @appendixsubsec Creating a Binary Distribution
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
532
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
533 Here is how to build a binary distribution for others to use. If you
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
534 want to make a binary distribution for your system available along with
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
535 the Octave sources and binaries on @url{ftp.che.wisc.edu}, please follow
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
536 this procedure. For directions explaining how to make the binary
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
537 available on the ftp site, please contact
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
538 @email{bug-octave@@bevo.che.wisc.edu}.
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
539
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
540 @itemize @bullet
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
541 @item
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
542 Unpack the source distribution:
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
543
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
544 @example
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
545 gunzip -c octave-@value{VERSION}.tar.gz | tar xf -
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
546 @end example
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
547
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
548 @item
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
549 Change your current directory to the top-level directory of the source
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
550 distribution:
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
551
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
552 @example
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
553 cd octave-@value{VERSION}
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
554 @end example
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
555
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
556 @item
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
557 Make the binary distribution:
2629
20704e7e5e79 [project @ 1997-01-27 06:11:52 by jwe]
jwe
parents: 2628
diff changeset
558
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
559 @example
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
560 make binary-dist
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
561 @end example
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
562
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
563 This will create a compressed tar file ready for distribution.
3176
fccab8e7d35f [project @ 1998-05-18 20:33:31 by jwe]
jwe
parents: 3148
diff changeset
564 It will have a name like
2689
8c7955a8d49f [project @ 1997-02-18 09:06:10 by jwe]
jwe
parents: 2670
diff changeset
565 @file{octave-@value{VERSION}-@value{TARGETHOSTTYPE}.tar.gz}
2333
b1a56412c385 [project @ 1996-07-19 02:20:16 by jwe]
jwe
parents:
diff changeset
566 @end itemize