annotate INSTALL.Windows @ 7948:af10baa63915 ss-3-1-50

3.1.50 snapshot
author John W. Eaton <jwe@octave.org>
date Fri, 18 Jul 2008 17:42:48 -0400
parents 92fb162eba24
children 66fdc831c580
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3847
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
1 *** PLEASE NOTE: This information is mostly out of date. It would be
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
2 *** useful for someone who uses Octave on Windows to take over
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
3 *** mainenance of this and other files related to running Octave on
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
4 *** Windows systems.
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
5
92fb162eba24 [project @ 2001-08-10 17:18:17 by jwe]
jwe
parents: 3154
diff changeset
6
3154
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
7 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
8 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
9
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
10 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
11 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
12 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
13 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
14 just run Octave). The gnu-win32 tools are available from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
15 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
16 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
17
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
18 -- Download usertools.exe or cdk.exe.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
19
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
20 -- Install the tools by running the file usertools.exe (or
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
21 cdk.exe) and following the directions. The default install
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
22 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
23 document assume that you've used the default location).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
24
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
25 -- 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
26 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
27
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
28 -- Create a /tmp directory.
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 -- Add
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
31
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
32 C:\gnuwin32\b18\H-i386-cygwin32\bin
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 to your $PATH.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
35
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
36 -- 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
37 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
38 /gnuwin32/b18/H-i386-cygwin32/etc.
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 -- 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
41 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
42 (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
43 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
44 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
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 editing the file, open the file
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
47 /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
48 string setpwend with setpwent. This change needs to be made
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
49 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
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 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
53 already been fixed, download the file cygwin-setpwent-fixed.dll
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
54 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
55 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
56 /gnuwin32/b18/H-i386-cygwin32/i386-cygwin32/lib/cygwin.dll.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
57
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
58 2. Install less for gnuwin32. A copy is available from
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
59 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32
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 -- Download the file 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 -- Install it along with the gnu-win32 tools. Change your
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
64 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
65 less-gnu-win32.tar.gz file (bash syntax):
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 tar zxf /path/to/less-gnu-win32.tar.gz
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
68
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
69 -- Set the environment variable TERM to linux.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
70
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
71 3. Install Octave.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
72
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
73 -- 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
74 ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
75
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
76 -- Untar the distribution:
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
77
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
78 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
79
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
80 The files will be unpacked into a subdirectory called
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
81 octave-2.0.10-i386-pc-cygwin32.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
82
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
83 -- 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
84 install the files using the command ./install-octave (running
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
85 bash).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
86
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
87 -- The default installation directory is /octave. If you choose
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
88 a different installation directory, you will have to set the
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
89 environment variable OCTAVE_HOME to the name of that directory
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
90 (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
91
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
92 -- Add C:\octave\bin to your path.
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 -- Set the environment variable TERM to linux.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
95
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
96 -- Optionally set the environment variables HOME (for your home
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
97 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
98 name).
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
99
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
100 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
101 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
102 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
103 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
104 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
105 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
106
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
107 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
108 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
109 this task.
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
110
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
111 Thanks,
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
112
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
113 John W. Eaton
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
114 jwe@bevo.che.wisc.edu
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
115 University of Wisconsin-Madison
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
116 Department of Chemical Engineering
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
117
352a80c32765 [project @ 1998-02-14 19:17:59 by jwe]
jwe
parents:
diff changeset
118 Fri Feb 13 19:24:01 1998