License ------- The use of XploRe 4 is free. The current version has a limited license up to 31.12.96. Please read also the copyright notes. Setting up XploRe 4 ------------------- This document describes the steps how to install XploRe on your computer. There are two different possibilities. One is a local installation for a single user, the other one is an installation for all users within a local network. For the latter one administration rights will probably be necessary. The software consists of three different tar-archives which are compressed with 'gzip'. Two of them do not depend on the hardware architecture while the third one contains mainly the executable. xpl4help.tar.gz ca. 540KB (ca. 2.4 MB uncompressed) xpl4.tar.gz ca. 270KB (ca. 1.3 MB uncompressed) There are four different types of executables: xpl4_sparc_solaris2.tar.gz ca. 750 KB xpl4_sparc_solaris2_static.tar.gz ca. 1.2 MB xpl4_i486_linux1.2.tar.gz ca. 630 KB xpl4_i486_linux1.2_static.tar.gz ca. 1.3 MB The static versions do not need the Motif runtime library. Local installation ------------------ 1. Transfer the files 'xpl4help.tar.gz', 'xpl4.tar.gz' and the executable for your architecture to your computer. If you use ftp make sure to set the binary mode for the transfer. 2. Change to a new directory, move the files to this directory and install the files with gzip -c -d xpl4.tar.gz | tar xf - If you want to set up your own help files, invoke gzip -c -d xpl4help.tar.gz | tar xf - You can also set the option -helpdir http://wotan.wiwi.hu-berlin.de/xplore/help in the script 'xplore' (see below). 3. The executable and three scripts are extracted with gzip -c -d xpl4_.tar.gz | tar xf - Maybe you have to change the execution permission of xpl4.exe by chmod +x xpl4.exe 4. The script 'instx4' is not needed by local installation. You can delete it. The script 'xplore' passes general information on the location of directories to the executable. With 'xplore -h' the list of all options is printed. [-helpdir helpdir] [-progdir progdir] -homedir root directory for lib, data, help, and prog -libdir directory containing libraries -datadir directory containing data files -helpdir directory containing the help files -progdir directory to store programs -v displays version number -h -help gives this help For the libdir and datadir it is possible to set more than one directory. They are separated as usual with a ':'. E.g. -libdir /lib:/project/lib This information can also be set with the environment variables: XPL4HOME, XPL4LIB, XPL4DATA, XPL4HELP, XPL4PROG The script 'xplore' should similar look like xpl4.exe -libdir /lib -helpdir /help $* If you call it without arguments XploRe assumes the help, library and data directory inside the current directory. 5. The script 'hlp2html' is intended for the generation of HTML files from XploRe macros. It requires Pearl (version 5). 6. The help system is display with a WWW browser. Depending on the system's load and the network bandwidth it can take a few seconds to start it. The default browser is 'netscape'. You can set it within XploRe with the command 'setenv ("browser", "")'. The HTML files use the frame extension. Installation on a server ------------------------ The installation is very similar to a single user installation. The differences are the location and the handling of the scripts 'instx4' and 'xplore'. If you did not read the user installation before, please do it now. 1. After transfer and extracting the files, move the scripts 'xplore', 'instx4' and 'hlp2html' to a standard path of executables like /usr/local/bin or /opt/bin. 2. Edit the script 'xplore' that the executable 'xpl4.exe' is found and started with the location of the help system. E.g. /opt/bin/xpl4.exe -helpdir /opt/XploRe/help $* It is also possible to set the -libdir, -datadir and -progdir in the global 'xplore' script. 3. Install the script 'instx4' so that each user can get his/her own version of the data, lib and example files, e.g.: gzip -c -d /opt/XploRe/xpl4.tar.gz | tar xf - mkdir help mv Xplore.ad $HOME/Xplore.ad Note: The generation of a local directory help is obligatory if the automatic generation of HTML files should be used. 4. Install the 'hlp2html' file in the standard executable path. This is a pearl script (version 5) for the HTML generation from xpl files. Perhaps you have to change the first line of the script in order to meet your local installation. If you have problems you can mail to xplore4@wiwi.hu-berlin.de. BUG Report: ----------- When you find a bug, please send us a short description and the shortest XploRe code, which reproduces the bug to xplore4@wiwi.hu-berlin.de The description must contain the version (xplore -v) and your computer type. Thomas Koetter, 17.3.97