Mercurial > hg > octave-lyh
diff 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 |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/INSTALL.Windows @@ -0,0 +1,112 @@ +Instructions for installing Octave on Windows NT/95 systems using the +beta 18 release of the gnu-win32 tools from Cygnus Support. + +1. Install the Cygnus gnu-win32 tools. You only need the user tools, + but you can install the full development kit instead (either will + work -- the development kit contains all the user tools plus the + GNU compilers and other development tools that are not needed to + just run Octave). The gnu-win32 tools are available from + ftp://ftp.cygnus.com/pub/gnu-win32/latest, and also from + ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32. + + -- Download usertools.exe or cdk.exe. + + -- Install the tools by running the file usertools.exe (or + cdk.exe) and following the directions. The default install + location is /gnuwin32/b18 (the rest of the examples in this + document assume that you've used the default location). + + -- Create a /bin directory and put a copy of sh.exe there. You + can find the sh.exe file in /gnuwin32/b18/H-i386-cygwin32/bin. + + -- Create a /tmp directory. + + -- Add + + C:\gnuwin32\b18\H-i386-cygwin32\bin + + to your $PATH. + + -- Create a /etc directory and put a copy of the termcap file + there. You can find a suitable termcap file in the directory + /gnuwin32/b18/H-i386-cygwin32/etc. + + -- There is a bug in the main gnu-win32 dll that will cause + Octave to fail. You need to fix it by either editing the file + (using an editor like Emacs that can handle binary files) or + by replacing it with the file cygwin-setpwent-fixed.dll from + ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32. + + To fix the problem by editing the file, open the file + /gnuwin32/b18/H-i386-cygwin32/bin/cygwin.dll and replace the + string setpwend with setpwent. This change needs to be made + in three places in the same file. Next, copy the fixed file to + /gnuwin32/b18/H-i386-cygwin32/i386-cygwin32/lib/cygwin.dll. + + To fix the problem by replacing the file with a version that's + already been fixed, download the file cygwin-setpwent-fixed.dll + from ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32 and + copy it to /gnuwin32/b18/H-i386-cygwin32/bin/cygwin.dll and + /gnuwin32/b18/H-i386-cygwin32/i386-cygwin32/lib/cygwin.dll. + +2. Install less for gnuwin32. A copy is available from + ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32 + + -- Download the file less-gnu-win32.tar.gz. + + -- Install it along with the gnu-win32 tools. Change your + directory to /gnuwin32/b18/H-i386-cygwin32/bin and untar the + less-gnu-win32.tar.gz file (bash syntax): + + tar zxf /path/to/less-gnu-win32.tar.gz + + -- Set the environment variable TERM to linux. + +3. Install Octave. + + -- Download the file octave-2.0.10-i386-pc-cygwin32.tar.gz from + ftp://ftp.che.wisc.edu/pub/octave/BINARIES/gnu-win32. + + -- Untar the distribution: + + tar zxf octave-2.0.10-i386-pc-cygwin32.tar.gz + + The files will be unpacked into a subdirectory called + octave-2.0.10-i386-pc-cygwin32. + + -- Change your directory to octave-2.0.10-i386-pc-cygwin32 and + install the files using the command ./install-octave (running + bash). + + -- The default installation directory is /octave. If you choose + a different installation directory, you will have to set the + environment variable OCTAVE_HOME to the name of that directory + (using Unix file name syntax) in order for Octave to work. + + -- Add C:\octave\bin to your path. + + -- Set the environment variable TERM to linux. + + -- Optionally set the environment variables HOME (for your home + direoctory using Unix file name syntax) and USER (for your user + name). + +Note that Octave requires gnuplot for plotting, but the normal Windows +version of gnuplot will not work because it only reads from the GUI +and refuses to read input from stdin. Mumit Khan has written a patch +that fixes the problem, but the gnuplot license does not allow us to +distribute modified versions of gnuplot in binary form. The patch is +available from http://www.xraylith.wisc.edu/~khan/software/gnu-win32. + +Eventually, I hope to automate most of this process and make it much +simpler. Please contact me if you are interested in helping out with +this task. + +Thanks, + +John W. Eaton +jwe@bevo.che.wisc.edu +University of Wisconsin-Madison +Department of Chemical Engineering + +Fri Feb 13 19:24:01 1998