
                               HPGLVIEW

                  Viewer and converter for HP-GL files

                             Version 5.43

        Special notes for installation on the generic Unix platforms

                       CERN, Geneva, December 2011


1. Installation

To install, unpack/untar the contents of the distribution package wherever
it is to be installed.  Then, either add this directory to the path and
define environment variable HPGLVIEW to point to this directory too.  The
other possibility is to create a simple startup script.  Assume that the
viewer is to be installed in /usr/local/share/hpglview, the following
script could be added to a directory in the path, say, /usr/local/bin:

  #! /bin/sh
  HPGLVIEW=/usr/local/share/hpglview
  export HPGLVIEW
  exec $HPGLVIEW/hpglview $@

The included manual page, hpglview.1, can be installed wherever your
manual pages are, typically /usr/local/man/man1, /usr/share/man/man1, etc.


2. Uninstallation

Simply delete the viewer files and remove the associated directories.


3. Known Problems

The HP-GL viewer binary for Unix platforms uses the Motif-interface, which
in turn uses the X11 server.  The binary is statically linked whenever
possible, but on some platforms X11-libraries cannot be linked static.
This means that on some stripped-down machines the viewer may not find
all the libraries it needs and may not work.  In this case, go to the
viewer installation directory and check which libraries are missing with
command:

  ldd hpglview

This will show all the actual library files, which are being used and
will indicate "not found" for any libraries not present.
