NOTE: This file is autogenerated from the Geomview manual. For references to things not in this file, see the manual. The manual is distributed in the "doc" subdirectory. Installing the NeXT Binary Distribution ======================================= 1. If you have just obtained a copy of the NeXTStep binary distribution (file `geomview-next.tar'), you can unpack it by double-clicking on it in the Workspace. This will open up a File Viewer panel showing, among other things, a NeXT Installer package called `Geomview.pkg'. 2. The first thing you should do is double-click on `Geomview.pkg' to invoke the NeXT Installer. You will be asked where you want to install it; typically it should go in `/LocalApps' or in `~/Apps' in your home directory. You should now be able to run Geomview and make use of most of its features by double-clicking on the installed `Geomview.app' icon. 3. There are some aspects of the installation, however, that the NeXT Installer can't handle. In order to fully install Geomview so that you can use all of its features, you should run the `install' script in the `Geomview.app' directory. In particular, you must go through this installation procedure in order to use Geomview to display Mathematica graphics. To run the `install' script you can open `Geomview.app' in the Workspace by selecting it and picking `File->Open as Folder' from the Workspace menu. This will pop up a File Viewer panel showing the contents of `Geomview.app'. Scroll down to the file named `install', and double-click on it. This will open a terminal window and run the script in that window. Alternately, you can open a terminal window yourself, cd to `Geomview.app', and run `install' there. The `install' script does the installation after asking you several questions about where you want to install the various components of Geomview. After running the `install' script, Geomview is completely installed. If in the future you move `Geomview.app' to some other location you should run `install' again. 4. This step is optional. Geomview's example data files are in the `Geomview.app/data' directory. If you are on a network with both SGI workstations and NeXTStep workstations, and you want to install Geomview to run on both, you can save disk space by having the two installations share a common data directory. To do this, decide on a location for the data directory and copy it there if it isn't there already (a good choice would be to leave it in the `$GEOMROOT' directory in your SGI Geomview installation). Then edit the file `Geomview.app/CONFIG.gv' to change the setting of the variable `GEOMVIEW_DATA' to point to this directory (there are comments in the file telling you what to do). You can then remove the data directory from `Geomview.app'. To run geomview, double-click on `Geomview.app' from the workspace, or type `open Geomview.app' from the appropriate directory, or type `geomview' from a shell window. More Geomview documentation is in the `Geomview.app/doc' subdirectory. In particular, a copy of the manual is there. The `install' script puts copies of the files in `Geomview.app/bin/next' and `Geomview.app/man' into the directories you specified for executables and man pages, respectively. Once you have done the installation you can cut down one the disk space required by Geomview by removing all the files in these directories, since copies have been installed elsewhere. You should first test that your installed Geomview works properly because once you remove these files from their distribution directories you will not be able to do the installation again. Details of the NeXTStep Binary Installation ------------------------------------------- Other than the installation of the `Geomview.app' directory, the installation details of the NeXTStep binary distribution are the same as for the SGI distribution, *Note SGI Binary Detail::. Note that the directory referred to in the SGI distribution as `$GEOMROOT' is the `Geomview.app' directory in the NeXTStep distribution. Details of the SGI Binary Installation -------------------------------------- The `install' script should be self-explanatory; just run it and answer the questions. This section gives some details for system administrators and other users who may want to know more about the installation. The installation is actually done by `make'; the `install' script queries the user for the settings of the following `make' variables and then invokes `make install'. `GEOMROOT': the absolute pathname of the Geomview root directory. The `geomview' shell script, which is what users invoke to run Geomview, uses this to set various environment variables that Geomview needs. It is very important that this be an *absolute* pathname --- i.e. it should start with a '/'. `BINDIR': a directory where executable files are installed. The `geomview' shell script goes here, as well as various other auxiliary programs that can be used in conjunction with `geomview'. This should be a directory that is on users' `$path'. These auxiliary programs are distributed in the `$GEOMROOT/bin/sgi' directory; if you specify this directory for `BINDIR', they are left in that directory. `MANDIR': a directory where Unix manual pages are installed. These are distributed in the `$GEOMROOT/man' subdirectory; if you specify this directory for `MANDIR', they are left in that directory. `MMAPACKAGEDIR': a directory where Mathematica packages are installed. This should be a directory that Mathematica searches for packages that it loads; you can see what directories your Mathematica searches by looking at the value of the `$Path' variable in a Mathematica session. The installation process will install some packages there which allow you to use Geomview to display Mathematica graphics. These packages are distributed in the `$GEOMROOT/mathematica' subdirectory; if you specify this directory for `MMAPACKAGEDIR', or if you specify the empty string for `MMAPACKAGEDIR', the packages are left in that directory. For more details about the way these Mathematica packages connect to Geomview, *Note Package Installation::.