Building and installing XView
=============================

!!!IMPORTANT!!! 

64-bit operating systems are currently unsupported. While build will 
succed, XView won't work at all.

1. Prerequisties
----------------
To build XView you need to have developments headers for X11 and curses,
bash, gcc, gmake and imake. You also need Sun's fonts, they are included
in most operating systems, while others offer them as separate download.

2. Build-XView.bash
-------------------
Build-XView.bash is the script used to build XView on all supported 
platforms. 

Typically you invoke it like this:

  bash Build-XView.bash libs clients contrib olvwm

And when there are no errors, you run:

  bash Build-XView.bash instlibs instclients instcontrib instolvwm instfinish

There are several environment variables that control Build-XView.bash
behaviour:

OPENWINHOME                 - it sets path where XView will be installed, by 
                              default it's set to "/usr". Older versions had 
                              "/usr/openwin" as default.

_DESTDIR_                   - it is prepended to all target paths. XView will 
                              be installed to $_DESTDIR_$OPENWINHOME. Usually
                              you don't have to set this variable.

XVIEW_USE_GCC               - If this variable is set, XView will be built 
                              using gcc compiler.

XVIEW_USE_OPEN64            - If this variable is set, XView will be built 
                              using Open64 compiler.

XVIEW_USE_OS_DEFAULTS       - If this variable is set, XView will be built 
                              using compiler specified in X11 headers. 

XVIEW_NO_WARNINGS           - If this variable is set, C compiler won't output 
                              any warnings.

XVIEW_BROKEN_X11_WORKAROUND - XView applications may hang after first mouse
                              button click when using certain versions of
                              X server. If this variable is set, XView will
                              be compiled with workaround for this problem
                              (fullscreen grabs will be disabled).

3. OS-specific tips
-------------------

 3.1. Cygwin tips
 ~~~~~~~~~~~~~~~~
 Under Cygwin, you have to create symbolic link /usr/bin/gmake.exe
 pointing to /usr/bin/make.exe.
 
 3.2. Solaris 9 tips
 ~~~~~~~~~~~~~~~~~~~
 Under Solaris 9, you have to install binutils, gcc and make from tgcware 
 (available at http://jupiterrise.com/tgcware/). Additionally, you should 
 rename XView libraries that come with system (/usr/openwin/lib/libxview* 
 and /usr/openwin/lib/libolgx*) to prevent them from being overwritten. 
 
 Solaris 9 imake includes need to be replaced with files found in
 misc/ImakeIncludesForSolaris.tar.Z archive. Please backup
 contents of /usr/openwin/lib/X11/config and copy contents of the archive to
 that directory. Then, append following lines to the end of site.def, located 
 in /usr/openwin/lib/X11/config directory:
 
   #define TopLevelProject X11
   #define ProjectTmplFile <X11.tmpl>
   #define ProjectRulesFile <X11.rules>
   #define HasGcc2 YES
 

---
Copyright (C) 2013 Tomasz Konojacki <me@xenu.tk>

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.
