
Version: 1.3

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 GV.
   GV allows to view postscript files on an X display. It is based on
   ghostview 1.5.

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.
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.

GV:
---

GV 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 GV.

Files:
-------------------------------------------------------------------------

The archives contained in this package are:

  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        : GV
  INSTALL.ZIP   : Documentation and installation guidelines for this kit.
  XAW3D.ZIP     : Xaw3D widget set.
                  Required by GV.
  XMU.ZIP       : X Miscellaneous Utilities (Xmu)
                  Required by Xaw3D and many of its clients.

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

This kit was tested on:

   Operating System       X Windows       Compiler
   -----------------------------------------------------
   OpenVMS AXP V6.2       X11 Release 5   DEC C V5.2-003
   OpenVMS AXP V6.2       X11 Release 5   DEC C V5.0-003
   OpenVMS VAX V6.1       X11 Release 5   DEC C V5.0-003

Additional software required for installation:

  o  MMS or MMK
     MMK is Matt's Make Utility. You may obtain it 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 too deeply.

Unpacking the archives will create the directory tree

  X11 --- COMMAND
          DATA
          DEFAULTS
          EXE
          EXE_ALPHA
          GV ------ DOC
                    SOURCE
                    UNUSED
          INSTALL
          XAW3D --- WIDGETS
          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.

--------------------------------------------------------------------------

Regards,

Johannes Plass, November 1996

(plass@dipmza.physik.uni-mainz.de)





