annotate README.Linux @ 5540:cda6a105ae9a before-ov-branch

[project @ 2005-11-17 05:47:13 by jwe]
author jwe
date Thu, 17 Nov 2005 05:47:13 +0000
parents b2ce28713791
children 5eb3db6e4042
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3598
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
1 NOTE: This file was originally written several years ago, when many
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
2 people were complaining that Octave would not work for them on Linux
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
3 systems. Generally, the problems were not actually bugs in Octave.
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
4 More recently, the compilers are better, most distributions are more
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
5 complete, and it seems harder to install incompatible sets of
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
6 libraries or header files (but some people still manage to do it).
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
7
2602
9cbbbcf5b6f5 [project @ 1997-01-07 06:18:23 by jwe]
jwe
parents: 2601
diff changeset
8 Since July 1996, most work on Octave has been done using a Linux
9cbbbcf5b6f5 [project @ 1997-01-07 06:18:23 by jwe]
jwe
parents: 2601
diff changeset
9 system, and a number of people who regularly test Octave snapshot
3142
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
10 releases also primarily use Linux systems. Because of this, I believe
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
11 Octave should run reasonably well on most current Linux systems.
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
12 However, there have been some problems in the past, usually the result
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
13 of improper installation of compilers or libraries. Sometimes the
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
14 problems have happened because of a botched upgrade or even a buggy
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
15 Linux distribution.
2593
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
16
3598
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
17 If you can, you should probably install Octave using one of the Debian
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
18 or RPM packages for Octave that are available with the major Linux
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
19 distributions. For example, Dirk Eddelbuettel <edd@debian.org>
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
20 maintains the Debian Octave package and usually has them ready within
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
21 a day or so of new Octave releases. They are available via the WWW at
4494
93ad80b6eef6 [project @ 2003-09-03 20:27:00 by jwe]
jwe
parents: 3598
diff changeset
22 http://www.debian.org/distrib/packages.
3142
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
23
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
24 If for some reason you can't (or choose not to) install Octave from
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
25 one of the binary distributions or by using one of the Debian or RPM
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
26 packages and something goes wrong, please check the following list to
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
27 see if your problem is already well known before reporting a bug.
2593
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
28
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
29 Octave compiles, but it won't run
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
30 ---------------------------------
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
31
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
32 If you can compile Octave, but it crashes with a segmentation fault
3598
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
33 right away, you probably have incompatible versions of libc and
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
34 libstdc++ installed, or you have a version of the dynamic loader,
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
35 ld.so, that is incompatible with your versions of the libraries, or
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
36 both.
2593
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
37
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
38 Octave won't even compile
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
39 -------------------------
2593
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
40
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
41 If you can't compile Octave, you should first check to see that your
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
42 compiler and header files are properly installed. Do you have
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
43 multiple versions of the g++ include files on your system? Are you
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
44 sure that your copy of g++ is finding the right set? You can find out
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
45 by compiling a simple C++ program with -v:
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
46
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
47 bash$ cat foo.cc
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
48 #include <iostream.h>
2663
00b2eff19bf5 [project @ 1997-02-08 21:58:49 by jwe]
jwe
parents: 2647
diff changeset
49 int main (void) { cerr << "yo\n"; return 0; }
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
50
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
51 bash$ g++ -v foo.cc
3598
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
52 gcc -v foo.cc -lstdc++ -lm
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
53 Reading specs from /usr/lib/gcc-lib/i486-linux/2.7.2/specs
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
54 gcc version 2.7.2
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
55 /usr/lib/gcc-lib/i486-linux/2.7.2/cpp -lang-c++ -v -undef ...
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
56 #include "..." search starts here:
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
57 #include <...> search starts here:
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
58 /usr/lib/g++-include
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
59 /usr/local/include
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
60 /usr/i486-linux/include
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
61 /usr/lib/gcc-lib/i486-linux/2.7.2/include
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
62 /usr/include
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
63 End of search list.
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
64 ...
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
65
2597
106ae3df29f5 [project @ 1996-12-17 17:48:01 by jwe]
jwe
parents: 2596
diff changeset
66 If the location of the correct set of include files is not listed in
106ae3df29f5 [project @ 1996-12-17 17:48:01 by jwe]
jwe
parents: 2596
diff changeset
67 the search path, then you might be able to fix that with a symbolic
3598
0ae310231c46 [project @ 2000-02-19 08:07:08 by jwe]
jwe
parents: 3151
diff changeset
68 link. However, if your version of libstdc++ was not compiled with your
2597
106ae3df29f5 [project @ 1996-12-17 17:48:01 by jwe]
jwe
parents: 2596
diff changeset
69 current version of gcc, you are likely to run into more trouble.
2596
7020b79afd9c [project @ 1996-12-14 19:12:11 by jwe]
jwe
parents: 2593
diff changeset
70
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
71 I/O in dynamically loaded .oct files doesn't work
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
72 -------------------------------------------------
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
73
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
74 If Octave prints things like `%.-1e' instead of numbers when you use a
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
75 dynamically linked .oct file, you probably need to create shared
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
76 versions of the Octave libraries. To do that, configure Octave with
3142
b06bffc95051 [project @ 1998-02-03 08:38:41 by jwe]
jwe
parents: 2993
diff changeset
77 --enable-shared, recompile, and reinstall.
2993
91589ab98e37 [project @ 1997-05-21 21:44:54 by jwe]
jwe
parents: 2663
diff changeset
78
2601
3723512a827a [project @ 1997-01-06 05:43:16 by jwe]
jwe
parents: 2600
diff changeset
79
2598
36a4daa9e3c7 [project @ 1996-12-19 02:27:21 by jwe]
jwe
parents: 2597
diff changeset
80 If you have comments or suggestions for this document, please contact
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 4494
diff changeset
81 bug@octave.org.
2593
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
82
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
83 John W. Eaton
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
84 jwe@bevo.che.wisc.edu
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
85 University of Wisconsin-Madison
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
86 Department of Chemical Engineering
3190d595d0da [project @ 1996-12-14 15:45:39 by jwe]
jwe
parents:
diff changeset
87
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 4494
diff changeset
88 Fri Oct 1 13:04:36 2004