annotate INSTALL.Windows @ 3154:352a80c32765

[project @ 1998-02-14 19:17:59 by jwe]
author jwe
date Sat, 14 Feb 1998 19:18:37 +0000
parents
children 92fb162eba24
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
1 Instructions for installing Octave on Windows NT/95 systems using the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
2 beta 18 release of the gnu-win32 tools from Cygnus Support.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
3
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
4 1. Install the Cygnus gnu-win32 tools. You only need the user tools,
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
5 but you can install the full development kit instead (either will
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
6 work -- the development kit contains all the user tools plus the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
7 GNU compilers and other development tools that are not needed to
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
8 just run Octave). The gnu-win32 tools are available from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
9 ftp://ftp.cygnus.com/pub/gnu-win32/latest, and also from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
10 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
11
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
12 -- Download usertools.exe or cdk.exe.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
13
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
14 -- Install the tools by running the file usertools.exe (or
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
15 cdk.exe) and following the directions. The default install
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
16 location is /gnuwin32/b18 (the rest of the examples in this
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
17 document assume that you've used the default location).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
18
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
19 -- Create a /bin directory and put a copy of sh.exe there. You
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
20 can find the sh.exe file in /gnuwin32/b18/H-i386-cygwin32/bin.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
21
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
22 -- Create a /tmp directory.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
23
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
24 -- Add
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
25
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
26 C:\gnuwin32\b18\H-i386-cygwin32\bin
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
27
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
28 to your $PATH.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
29
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
30 -- Create a /etc directory and put a copy of the termcap file
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
31 there. You can find a suitable termcap file in the directory
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
32 /gnuwin32/b18/H-i386-cygwin32/etc.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
33
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
34 -- There is a bug in the main gnu-win32 dll that will cause
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
35 Octave to fail. You need to fix it by either editing the file
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
36 (using an editor like Emacs that can handle binary files) or
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
37 by replacing it with the file cygwin-setpwent-fixed.dll from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
38 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
39
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
40 To fix the problem by editing the file, open the file
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
41 /gnuwin32/b18/H-i386-cygwin32/bin/cygwin.dll and replace the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
42 string setpwend with setpwent. This change needs to be made
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
43 in three places in the same file. Next, copy the fixed file to
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
44 /gnuwin32/b18/H-i386-cygwin32/i386-cygwin32/lib/cygwin.dll.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
45
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
46 To fix the problem by replacing the file with a version that's
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
47 already been fixed, download the file cygwin-setpwent-fixed.dll
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
48 from ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32 and
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
49 copy it to /gnuwin32/b18/H-i386-cygwin32/bin/cygwin.dll and
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
50 /gnuwin32/b18/H-i386-cygwin32/i386-cygwin32/lib/cygwin.dll.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
51
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
52 2. Install less for gnuwin32. A copy is available from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
53 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
54
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
55 -- Download the file less-gnu-win32.tar.gz.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
56
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
57 -- Install it along with the gnu-win32 tools. Change your
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
58 directory to /gnuwin32/b18/H-i386-cygwin32/bin and untar the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
59 less-gnu-win32.tar.gz file (bash syntax):
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
60
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
61 tar zxf /path/to/less-gnu-win32.tar.gz
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
62
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
63 -- Set the environment variable TERM to linux.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
64
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
65 3. Install Octave.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
66
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
67 -- Download the file octave-2.0.10-i386-pc-cygwin32.tar.gz from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
68 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
69
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
70 -- Untar the distribution:
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
71
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
72 tar zxf octave-2.0.10-i386-pc-cygwin32.tar.gz
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
73
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
74 The files will be unpacked into a subdirectory called
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
75 octave-2.0.10-i386-pc-cygwin32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
76
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
77 -- Change your directory to octave-2.0.10-i386-pc-cygwin32 and
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
78 install the files using the command ./install-octave (running
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
79 bash).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
80
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
81 -- The default installation directory is /octave. If you choose
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
82 a different installation directory, you will have to set the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
83 environment variable OCTAVE_HOME to the name of that directory
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
84 (using Unix file name syntax) in order for Octave to work.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
85
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
86 -- Add C:\octave\bin to your path.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
87
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
88 -- Set the environment variable TERM to linux.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
89
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
90 -- Optionally set the environment variables HOME (for your home
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
91 direoctory using Unix file name syntax) and USER (for your user
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
92 name).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
93
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
94 Note that Octave requires gnuplot for plotting, but the normal Windows
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
95 version of gnuplot will not work because it only reads from the GUI
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
96 and refuses to read input from stdin. Mumit Khan has written a patch
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
97 that fixes the problem, but the gnuplot license does not allow us to
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
98 distribute modified versions of gnuplot in binary form. The patch is
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
99 available from http://www.xraylith.wisc.edu/~khan/software/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
100
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
101 Eventually, I hope to automate most of this process and make it much
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
102 simpler. Please contact me if you are interested in helping out with
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
103 this task.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
104
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
105 Thanks,
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
106
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
107 John W. Eaton
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
108 jwe@bevo.che.wisc.edu
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
109 University of Wisconsin-Madison
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
110 Department of Chemical Engineering
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
111
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
112 Fri Feb 13 19:24:01 1998