annotate README.Windows @ 3167:d609b993be3b

[project @ 1998-04-17 04:41:59 by jwe]
author jwe
date Fri, 17 Apr 1998 04:42:03 +0000
parents 352a80c32765
children fccab8e7d35f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3167
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
1 Octave has been ported to Windows NT and Windows 95 using the gnu-win32
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
2 tools from Cygnus Support. If you would like to volunteer to work on
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
3 improving this port, please contact bug-octave@bevo.che.wisc.edu.
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
4
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
5 The directory ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
6 contains a binary distribution of Octave for Windows NT/95 along with
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
7 installation instructions. Unless you are interested in doing some
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
8 hacking, you should use the binary releases.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
9
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
10 Here is a list of current problems (and workarounds, where available).
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
11
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
12 * To compile and install Octave on a Windows NT/95 system,
3167
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
13 you will need to get the beta 19 release of the gnu-win32 tools.
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
14 They are available from ftp://ftp.cygnus.com/pub/gnu-win32.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
15
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
16 * You will need to have f2c and libf2c.a or g77 installed. I would
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
17 recommend using g77. Mumit Khan has directions for building g77 at
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
18 http://www.xraylith.wisc.edu/~khan/software/gnu-win32/g77.html.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
19 Another solution is to use egcs, which includes g77. The egcs
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
20 compiler is available from http://www.cygnus.com/egcs.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
21
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
22 * You will also need a termcap library. The GNU termcap library seems
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
23 to work. You can get it from any GNU archive site, including
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
24 ftp://ftp.gnu.org/pub/gnu/termcap-1.3.tar.gz.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
25
3167
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
26 * It is possible to cross-compile Octave for Windows NT/95 systems.
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
27 On the same hardware, it's generally much faster to use gcc as a
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
28 cross compiler under Linux than as a native compiler under Windows.
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
29
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
30 Here are some instructions for building a cross version of gcc and
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
31 then using it to compile Octave. I've done this using a Linux
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
32 system as the host, but it should work equally well on other systems
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
33 that can run gcc).
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
34
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
35 + install cdk on your Windows system
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
36
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
37 + build a cross version of binutils:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
38
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
39 tar zxf binutils-2.9.tar.gz
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
40 cd binutils-2.9
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
41 ./configure --target=i386-pc-cygwin32 --prefix=/usr/local/cross-gcc
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
42 make
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
43 make install
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
44
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
45 (You can choose whatever value for prefix that you prefer, of
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
46 course, just remember to also make the corresponding changes in the
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
47 following steps as well.)
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
48
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
49 + copy libraries and include files from cdk. You'll need the
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
50 library files from the following directory trees:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
51
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
52 b19/H-i386-pc-cygwin32/lib
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
53 b19/H-i386-pc-cygwin32/i386-cygwin32/lib
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
54
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
55 Copy them to /usr/local/cross-gcc/i386-pc-cygwin32/lib.
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
56
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
57 You'll also need the include files from the following directory
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
58 trees:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
59
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
60 b19/include
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
61 b19/H-i386-pc-cygwin32/include
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
62
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
63 Copy them to /usr/local/cross-gcc/i386-pc-cygwin32/include.
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
64
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
65 + build cross version of egcs:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
66
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
67 tar zxf egcs-1.0.2.tar.gz
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
68 cd egcs-1.0.2
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
69 export PATH=/usr/local/cross-gcc/bin:$PATH
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
70 ./configure --target=i386-pc-cygwin32 --prefix=/usr/local/cross-gcc
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
71 make
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
72 make install
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
73
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
74 + cross-compile libtermcap:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
75
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
76 export PATH=/usr/local/cross-gcc/i386-pc-cygwin32/bin:$PATH
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
77 tar zxf termcap-1.3.tar.gz
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
78 cd termcap-1.3
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
79 ./configure --host=i386-pc-cygwin3
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
80 make
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
81 cp termcap.h /usr/local/cross-gcc/i386-pc-cygwin32/include
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
82 cp libtermcap.a /usr/local/cross-gcc/i386-pc-cygwin32/lib
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
83
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
84 + cross-compile Octave using the compiler you just built:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
85
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
86 export PATH=/usr/local/cross-gcc/i386-pc-cygwin32/bin:$PATH
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
87 tar zxf octave-2.0.12.tar.gz
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
88 cd octave-2.0.10
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
89 ./configure --host=i386-pc-cygwin3
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
90 make
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
91
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
92 + make a binary distribution to copy to your Windows system:
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
93
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
94 make -f octMakefile binary-dist
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
95
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
96 + copy the binary distribution to your Windows system and install
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
97 using the intall-octave shell script
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
98
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
99 * Octave requires gnuplot for plotting, but the normal Windows version
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
100 of gnuplot will not work because it only reads from the GUI and refuses
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
101 to read input from stdin. Mumit Khan has written a patch that fixes
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
102 the problem, but the gnuplot license does not allow us to distribute
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
103 modified versions of gnuplot in binary form. The patch is available
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
104 from http://www.xraylith.wisc.edu/~khan/software/gnu-win32.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
105
3130
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
106 * If Octave takes a long time to find function files, you may have to
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
107 modify your LOADPATH to avoid device names specified using the
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
108 `//DEV/subdir' syntax. To map the D: drive (for example) to
3130
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
109 /D_DRIVE, do the following:
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
110
3130
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
111 cd /
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
112 mkdir /D_DRIVE
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
113 mount d: /D_DRIVE
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
114
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
115 Then you can set your LOADPATH to include /D_DRIVE/subdir instead of
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
116 //d/subdir.
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
117
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
118 If you know of solutions for any of the problems mentioned above,
02766207b74c [project @ 1998-01-25 08:27:23 by jwe]
jwe
parents: 2605
diff changeset
119 please contact bug-octave@bevo.che.wisc.edu.
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
120
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents: 3130
diff changeset
121 More information about the gnu-win32 project is available via the WWW
2587
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
122 at http://www.cygnus.com/gnu-win32.
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
123
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
124 John W. Eaton
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
125 jwe@bevo.che.wisc.edu
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
126 University of Wisconsin-Madison
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
127 Department of Chemical Engineering
7323c6c5c1c4 [project @ 1996-12-12 08:14:36 by jwe]
jwe
parents:
diff changeset
128
3167
d609b993be3b [project @ 1998-04-17 04:41:59 by jwe]
jwe
parents: 3154
diff changeset
129 Thu Apr 16 23:39:13 1998