

Overview:
------------------------------------------------------------

This kit essentially contains the sources of

 o Kaleb S. Keithley's Xaw3D widget set.
   This widget set is intended to improve the visual appearance
   of the common X Athena Widgets.
   In general it may be used as a replacement for the Xaw widget set.
 o the X Miscellaneous Utilities (Xmu).
 o Ghostview-VMS.
   Ghostview-VMS allows to view postscript files on an X display.
   As implied by its name, it is derived from ghostview 1.5.
 o David M. Brooke's VMS port of XFig 2.1.6.
   XFig allows to draw figures on an X display.

Please note that this kit is intended to support Ghostview-VMS
and the Xaw3D widget set only. The sources of XFig are included
for convenience only.

Xaw3D:
------

Apart from changes introduced to provide the functionality 
of a Xaw compatible widget set on OpenVMS,
the Xaw3D widget set contained in this kit includes 
 o a modified version of Keith Packard's Layout widget.
 o a different Scrollbar widget, added to complete the 3D appeareance
   of the simple widgets.
 o a modifed version of the Paned widget.
   The modifications are minimal and are restricted to details of its
   visual appearance.
 o a composite 3D widget, Form3D.
The original versions of all modified widgets listed above are
included. With the exception of the Layout widget this code
is in a functional state and may be used in case problems
arise with the modified versions.
The Xaw3D library will be build as shareable image.

Xmu:
----

The X Miscellaneous Utilities are included
to make this kit self-contained and to implement all resource
converters needed by the Xaw3D clients.
The Xmu library will be build as shareable image.

GhostView-VMS:
--------------

GhostView-VMS is derived from Timothy Theisen's ghostview 1.5
and allows to view postscript files.
It requires ghostscript, version 2.52 or higher.
ghostscript as well as the original ghostview 1.5
may be obtained from
   site:   ftp.cs.wisc.edu
   dir:    pub/ghost
Please see the accompanying documentation for further information
on GhostView-VMS.

XFig:
-----

The version of XFig included in this kit is David M. Brooke's
VMS port of XFig 2.1.6. 

Files:
------------------------------------------------------------------    
     
The archives contained in this package are:

  BITMAPS.ZIP	: X11 bitmaps. 
                  Required by Xmu, Xaw3D and many clients.
  COMMAND.ZIP	: Platform independant DCL command files.
                  Contains the setup procedure of this kit.
  DATA.ZIP	: Contains additional application specific data.
                  Required.
  DEFAULTS.ZIP	: Resource Files.
                  Required.
  EXE.ZIP       : Executable code for OpenVMS VAX.
                  Required on OpenVMS VAX. 
  EXE_ALPHA.ZIP : Executable code for OpenVMS AXP.
                  Required on OpenVMS AXP.
  GV.ZIP	: GhostView-VMS, Version 2.0 .
  INSTALL.ZIP	: Documentation and installation guidelines for this kit.
  XAW3D.ZIP	: Xaw3D widget set.
                  Required by GhostView-VMS and XFig.
  XFIG.ZIP	: XFig, Version 2.1.6 . 
  XMU.ZIP	: X Miscellaneous Utilities (Xmu)
                  Required by Xaw3D and many of its clients. 

Assuming you want to install Ghostview-VMS, you should obtain:
  BITMAPS.ZIP 
  COMMAND.ZIP
  DATA.ZIP
  DEFAULTS.ZIP
  EXE.ZIP
  EXE_ALPHA.ZIP
  GV.ZIP
  INSTALL.ZIP
  XAW3D.ZIP
  XMU.ZIP
If you like to install XFig also, you additionally need:
  XFIG.ZIP

Installation Preliminaries:
--------------------------------------------------------------

This kit was developed on OpenVMS AXP 6.1 and OpenVMS VAX 6.1.
It was tested on:

   Operating System	  X Windows	  Compiler
   -----------------------------------------------------
   OpenVMS AXP V6.1	  X11 Release 5   DEC C V4.0-000
   OpenVMS VAX V6.1       X11 Release 5   VAX C V3.2-044
   OpenVMS VAX V6.1       X11 Release 5   DEC C V4.0-000

Additional software required for installation:

  o  MMS or MMK
     MMK is Matt's Make Utility. The latest version (V3.3-4) may be
     obtained via anonymous ftp from
        site:  ftp.spc.edu 
        dir:   [.macro32.savesets]
  o  UNZIP

To use the software contained in this kit you should
download all archives needed into one common directory
(which will be called 'X11' within this documentation)
This directory serves as the top node of this kit, may
have an arbitrary name but should not be nested to deeply.

Unpacking the archives will create the directory tree

  X11 --- BITMAPS
          COMMAND
          DATA
          DEFAULTS
          EXE
          EXE_ALPHA
          GV ------ DOC
                    SOURCE
                    UNUSED
          INSTALL
          XAW3D --- WIDGETS
          XFIG ---- TRANSFIG -- DOC ------ MANUAL
                                FIG2DEV -- DEV
                                TRANSFIG
                    XFIG ------ DOC
                                EXAMPLES
          XMU

The file 
   [.X11.INSTALL]INSTALL.TXT
contains the remaining instructions on how to compile and how to use this
software.

The file
   [.X11.INSTALL]CHANGES.TXT
contains pointers to files that describe the changes made since 1-FEB-1995.

Johannes Plass, June 1995
plass@dipmza.physik.uni-mainz.de

