How to Install XYPLOT

• Linux Installation
• Windows 95/98 Installation
• DOS Installation

Linux Installation

XYPLOT for Linux is distributed as a compressed tar (Unix Tape Archive) file with the name

After installing the Lesstif packages on your system, you can build and install xyplot by following these steps:

1. Log in as the root user (superuser).
   
   
2. Create a directory for the xyplot source files, typically in the /usr/local/src directory, e.g.
   
   mkdir /usr/local/src/xyplot
   
   
3. Move the xyplot archive file (xypx10.tar.gz) into this directory:
   
   mv xypx10.tar.gz /usr/local/src/xyplot
   
   
4. Change to the /usr/local/src/xyplot directory and extract the files:
   
   cd /usr/local/src/xyplot
   tar -zxvf xypx10.tar.gz
   
   After this step, the directory should contain all of the xyplot source files, the Makefile, and a README file, which also contains these installation instructions.
   
   
5. Build the xyplot executable. There are several options for building xyplot, but the simplest is to type:
   
   make
   
   All of the source files will be compiled/assembled and the executable file, named xyplot, will be generated. You may notice compiler warnings scroll by as the files are compiled, but these may be ignored. Only if you do not have an executable named xyplot at the end of the make process has something gone wrong.
   
   You can examine the file Makefile to see the other options for building xyplot. Also, if something does go wrong during the make process, you may need to edit the Makefile. For example, the linker may not be able to find the necessary libraries on your system and you may need to redefine the macro LIBDIRS in the Makefile.
   
   
6. Move the executable to a directory in the path for users, e.g.:
   
   mv xyplot /usr/local/bin
   
   Any user should then be able to execute xyplot.
   
   
7. Each user maintains customized settings in his/her $HOME/.xyplot directory. For each user, create the directory as follows:
   
   mkdir /home/username/.xyplot
   
   Next, copy the Forth source files (*.4th) into this directory
   
   cp /usr/local/src/xyplot/*.4th /home/username/.xyplot
   
   When a user executes xyplot, the file xyplot.4th from the user's $HOME/.xyplot will be loaded. XYPLOT can be customized by appending Forth commands to the end of this file. For example, other Forth files may be loaded to provide additional menu functions. The file smooth.4th is an example of a Math Menu function, called Smooth, which is defined in Forth source code and loaded upon startup.

Windows 95/98 Installation

XYPLOT for Windows 95 is distributed as a zip file xypw10.zip which contains a single executable file called xypw.exe. We suggest that you create a folder called xyplot, move the zip file into this folder, and unzip the file:

1. Create a new folder called xyplot.
   
   
2. Drag the zip file xypw10.zip into this folder.
   
   
3. If WinZip is installed on your system, you can simply double click on the zip file to unzip it. Otherwise, go to the DOS prompt and type:
   
   pkunzip xypw10.zip
   
   
4. Create a shorcut on your desktop to the executable xypw.exe.

DOS Installation

Installation of XYPLOT on your PC requires you to do the following:

• Create a directory for the program files.
  
• Copy the distribution file (zip file) into this directory.
  
• Edit the initialization file in this directory.
  
• Modify the autoexec.bat file for your computer to include
  
  • a path to the program
  • an environment variable that locates the initialization file

1. First create a directory for the xyplot files, e.g.
   
   mkdir c:\xyplot
   
   
2. Next, copy or download the compressed zip file (xyp41.zip) into this directory. Then use the program pkunzip to decompress the files
   
   pkunzip xyp41
   
   
3. Now, modify the initialization file xyplot.ini using a text editor. The file as supplied will work for a computer with a color VGA display.
   
   edit xyplot.ini
   
   
4. Edit the autoexec.bat file of your system to include the lines
   
   path c:\dos;...;c:\xyplot
   set xypini=c:\xyplot