
PACKAGE CONTENTS
----------------
This is my fourth release of a linux port of the Xview 3.0 toolkit
library & friends. The package contains the following:

     - DLL libraries (v2.0) of olgx, xview and slingshot
NEW! - DLL library of libUIC (v.1.0)
     - Static libraries for XView developers
     - olwm (OpenLook window manager)
     - olvwm (OpenLook virtual window manager)
     - Binaries for:
       * cmdtool/shelltool (OpenLook compliant shell window)
       * props             (Properties tool)
       * textedit          (Text editor)
       * clock             (OpenLook compliant clock)
       All binaries have been linked with the DLL libraries.
     - User Interface Toolkit (UIT), a C++ API for XView
       (user documentation not included)
     - Postscript documentation for the Slingshot extensions.
       (See later in this text for a short description of Slingshot).
     - Sources for Slingshot examples.
NEW! - Sources for UIT examples.
     - Header files for xview, olgx, pixrect, slingshot and UIT
     - Man pages for the window manager + tools
     - Online help files
     - Sample openwin-menu files, customized for X-utils available with
       the SLS distribution. This could be a good starting point if you
       haven't already got your own Workspace menus.
     - A new entry for /etc/termcap. The command tool requires an entry
       for a 'sun' terminal. 
NEW! - A "openwin" script to start X using ol[v]wm
NEW! - xtoolplaces as a replacement for owplaces to save workspace setup.

CHANGES AND FIXES FROM PREVIOUS LINUX RELEASE
---------------------------------------------
See ChangeLog file included in the package.

INSTALLATION
-------------
Execute the 'Install' script. If you have XView already installed (from
the previous release), it will be uninstalled. If you are using a previous
release of xview, you should leave X before installation.

IMPORTANT! If you have modified anything from the previous release
(e.g. openwin-menus in /usr/openwin/lib), you should store your
customizations somewhere safe before starting the installation.

The script will install various files in /usr/openwin, and make some
links in /usr/include and other places.

The script "openwin" in /usr/openwin/bin and /usr/X386/bin can be used to
start X instead of the "startx" script. "openwin" will set environment
variables and search paths for the XView tools. "openwin" also restores
the desktop setup from $HOME/.openwin-init if present. For "openwin" to
work correctly, it is recommended to copy the Xinitrc from this package to
your home directory as .xinitrc (cp Xinitrc $HOME/.xinitrc).  The .xinitrc
file supports using non-openwin setups, see the file for instructions.

The xview header files live under /usr/openwin/include. The install
script will make softlinks pointing at the olgx, pixrect, xview,
sspkg and uit include directories, so no special header file
directories need to be specified when compiling applications.

The install script will also place a termcap entry for a sun terminal in
/etc/termcap, required by cmdtool/shelltool. The script will remove any
previous sun terminal entry.

You might also want to customize .textswrc and .ttyswrc. I haven't
done much to improve these, they're pretty Sun-specific at the moment.

Another thing to look at is your .Xmodmap. Olwm uses (but does not
require) keys that aren't available on PC keyboards, such as Help,
Cut, Paste etc. The installation program will ask you whether to append
definitions for these special keys in your .Xmodmap. This will allow
you to use the keyboard for Copy-Paste, which is sometimes quicker than
fiddling with the mouse to find the correct menu item.

WHAT IS XVIEW (excerpt from SunFlash announcing XView 3.0 release)
------------------------------------------------------------------
XView is a user-interface toolkit to support interactive, graphics-based
applications running under the X Window System.  XView provides a set of
pre-built, user-interface objects such as canvases, scrollbars, menus, and
control panels.  The appearance and functionality of these objects follow
the OPEN LOOK Graphical User Interface (GUI) specification.  XView features
an object-oriented style Application Programmer's Interface (API) that is
straightforward and easy to learn.  XView's API is very similar to the
API of the SunView toolkit; in practice, most SunView applications can
be converted to XView in a few days, although some will take longer.
Additionally, XView provides both 2D and 3D-look OPEN LOOK graphical
interfaces through the usage of the OPEN LOOK graphics library (OLGX).

WHAT IS OLWM (excerpt from SunFlash announcing XView 3.0 release)
-----------------------------------------------------------------
OLWM is an ICCCM-compliant window manager, also based on the OPEN LOOK GUI.
OLWM is a "stand-alone" window manager, not dependent on any toolkit code.
OLWM provides both 2D and 3D-look OPEN LOOK graphical interfaces through
the usage of the OPEN LOOK graphics library (OLGX).  OLGX is written to the
Xlib interface and does not use any toolkit.

WHAT IS SLINGSHOT (from preface of Slingshot documentation)
-----------------------------------------------------------
The XView toolkit provides a number of user interface objects such as Frames,
Icons, and Panel items. While these are necessary and appropriate for many
types of applications, programmers are forced to use Xlib to implement other
types of user interfaces. Unfortunately, Xlib programming is difficult and
tedious. The Slingshot extensions provide one answer to this dilemma, by
supplying a set of objects and event handling routines that implement commonly
needed functionality.

The Slingshot extensions to XView are based on the XView toolkit. Programmers
who already know XView will find the Slingshot extensions very familiar
because the XView API (xv_create(), xv_set(), xv_get(), etc.) is used.

This package contains the release 2.0 of Slingshot extensions. Release 2.0
is based on XView 3.0 and incorporates the XView 3.0 selections and drag and
drop interfaces.

WHAT IS UIT (from introduction of UIT documentation)
----------------------------------------------------
The UIT is a tool/class library for C++ programmers developing OpenWindows
user interfaces.

The UIT has two parts:
* A hierarchy of OpenLook-conformant user-interface classes, realized in
  C++ on top of the XView toolkit. These are the user-interface components
  (UIC).

* A tool to convert OpenWindows developer's guide (DevGuide) output into
  C++ code that uses the UIC. This part is the guide to UIC utility, or `guic`.

  [note. `guic` was provided as a Sun-binary only, and is not included in the
  linux package (anyone wanna build a Sparc emulator:-) :-) I'd recommend
  getting the whole package from export.lcs.mit.edu, the Postscript docs are
  over 1MB, and not included here]

BUGS
----
Although this port works a bit better than my previous release, there are
still known (and probably unknown) bugs:

- The command tool does not function very well. I got it to work
  by hardcoding sane tty settings for terminal panes in the
  xview library. 
- There are problems with the notifier functions in the library.
  Apps using the notifier may not work correctly (most do, though)
- Be aware that closing the window manager while you have open shelltools
  will leave entries in the utmp file. This means that utilities that depend
  on utmp entries such as 'shutdown' and 'reboot' will not work properly.
  Always close all shell windows before ending the session.
- The 'Tacho' object in Slingshot has a small bug in the lower left corner,
  due to the arc extending one pixel too far. The problem is probably a
  faked 'irint()' function in my port, which introduces a rounding error.
  The bug can be seen in the 'tacho' and 'temp_grip' examples.
- The Slingshot example 'dnd2' cannot be compiled because it requires the
  Sun OpenWindows Classing Engine, which hasn't been released by Sun.

If you find other (linux-specific) bugs please report them to
lmfken@lmf.ericsson.se.

ENVIRONMENT USED DURING PORT
----------------------------
Linux kernel 0.99p7A
DLL X-libs, libm & libc
SLS distribution (not the latest, though)
XFree-1.2
GCC 2.3.3

LOCATION OF SOURCES
-------------------------------------------------------------------------------
west coast      xview.ucdavis.edu       ftp     pub/XView/XView3.0/*
east coast      export.lcs.mit.edu      ftp     contrib/xview3
                export.lcs.mit.edu      ftp     contrib/Slingshot2.0.tar.Z
                export.lcs.mit.edu      ftp     contrib/UIT2.tar.Z (??)

Kenneth Osterberg (lmfken@lmf.ericsson.se or lmfken@bluese1.ericsson.fi)
