CUB'X-WINDOW V5.0 DEMO VERSION 

Intuitive Systems, Inc. is pleased to present you Cub'X-Window v5.0, X11R6 client/server solution for NEXTSTEP!

Cub'X-Window integrates in NEXTSTEP the functionality of a standard X Window terminal, allowing the remote display of X Window applications running on any X Window workstation in the network.
Cub'X-Window provides all X Window development tools to port or develop X applications locally on NEXTSTEP. 
Cub'X-Window v5.0 also includes numerous X clients (XV, xfig, tcl/tk...) and window managers (fvwm, Xview, twm...) already pre-compiled and ready for use. 

Please Note: Cub'X-Window v5.0 runs on NEXTSTEP v3.2 and 3.3. Cub'X-Window is not compatible with the NeXT Dimension board. 

Demo packages available:

· Single fat packages 
- NeXT hardware: CubXWindow.Demo-m68k.tar.gz (size 2645509)
- Intel Systems: CubXWindow.Demo-i386.tar.gz (size 2925586)
- HP PA-RISC: CubXWindow.Demo-hppa.tar.gz (size 3372494)
- Sun SPARCstations: CubXWindow.Demo-sparc.tar.gz (size 2947155)

· 4-way fat package for NEXTSTEP for NeXT, Intel, HP PA-RISC and Sun SPARCstations: 
CubXWindow.Demo-quad.tar.gz (size 8270856)
 
· 2-way fat package for NEXTSTEP for NeXT and Intel:
CubXWindow.Demo-i386ANDm68k.tar.gz (size 5099170)

· Additional fonts : CubXWindow.Demo-MoreFonts.tar.gz (size 1140465)
If you find the fonts included in the Cub'X-Window Demo version are not sufficient to display your X Window applications, you can add this font package to CubXWindow.app. To install this package please see end of this file. 

Cub'X-Window demo version will quit after a specific number of events equivalent to 15-20 minutes of use. (You can then re-start X Window).

Cub'X-Window Demo Version presents all features and display options you can access in Cub'X-Window v5.0. 
In order to limit the size of the demo a small number of user applications and fonts have been included. 
Description of the Cub'X-Window options is provided in the on-line help. 

For more information, please contact : 
Intuitive Systems, Inc.
599 North Mathilda Ave. Ste 19
Sunnyvale, CA 94086

tel : 408 245 8540
fax : 408 245 8541
cubx@intuisys.com

Cub'X-Window Installation Process

1. Installing Cub'X-Window Demo package

1 	Start Terminal.app located in /NextApps. 

2 	Log in as root in the terminal window: 
su <enter>

3 	Move to the directory in which you wish to install Cub'X-Window Demo (for example /LocalApps/Demos):
cd /LocalApps/Demos <enter>

4  	Enter the following command in the terminal:
gnutar zxvf CubXWindow.Demo-architecture.tar.gz
	where CubXWindow.Demo-architecture.tar.gz is the demo package of your choice. 

CubXWindow.app is now installed.

2. Creating symbolic links. 

Symbolic links must be created at specific locations on your system for X Window to run properly.  Cub'X-Window automatically creates these links the first time you start CubXWindow.app. 
The symbolic links are created at the following locations: 
/usr/X11
/usr/X11R5
/usr/X11R6
/usr/bin/X11
/usr/lib/X11
/usr/include/X11

3. Setting up your X user environment

You don't need to configure your X user environment: Cub'X-Window automatically accesses configuration files located at the following locations: 
- /usr/X11R6/lib/X11/xinit/xinitrc
- /usr/X11R6/lib/X11/twm/system.twmrc

If you have X user environment files in your home directory (.xinitrc, .xserverrc, .twmrc...) these will be the ones taken into account.

Please make sure to remove X environment files installed in your home directory by a previous version of Cub'X-Window or another X Window solution: these may prevent Cub'X-Window v5.0 demo to run properly. 

4. Starting Cub'X-Window

To start Cub'X-Window, double-click on CubXWindow.app.
The default configuration of Cub'X-Window displays X Window  in 8 bit pseudocolor visual, inside the NEXTSTEP environment. 
You can change the default settings in the Preferences panel (in the Info menu).  All Preferences options are described in the on-line help. 

 Troubleshooting:  
When starting CubXWindow.app, nothing happens. The CubXWindow Console (in Cub'X-Window's Tools menu) gives the error message: "sh: startx not found"

The symbolic links (step #2) have not been created when launching CubXWindow.app. The reason can be that the program in charge of the link creation (mkxlink) has had its access rights modified during the extraction of the CubXWindow package.
 
Please check the following: 
1 	Start Terminal.app located in /NextApps. 
2 	Log in as root in the terminal window: 
	su <enter>
3	Move into the folder CubXWindow.app
	cd CubXWindow.app <enter>
4	List the different files of this folder: 
	ls -l
  	In the listing, check the rights of mkxlink.  mkxlink should list as follows:
	-rwsr-xr-x  1 root       16384 <date> mkxlink*
	If in the access rights you read  -rwxr-xr-x and not -rwsr-xr-x
	you need to enter the following command:
	chmod u+s mkxlink <enter>
5	You can then restart CubXWindow.app

Cub'X-Window Demo font package Installation Process

The basic Cub'X-Window Demo includes a limited number of fonts, and this may prevent some of your X applications to display properly on Cub'X-Window Demo. 

If you encounter this problem, you may want to install CubXWindow.Demo-MoreFonts.tar.gz. 
This package adds the fonts courier, lucida, helvetica, times. Once decompressed these fonts will take about 4Mb. 

To add the font package to a Cub'X-Window Demo application:

1 	Start Terminal.app located in /NextApps. 

2 	Log in as root in the terminal window: 
su <enter>

3 	Move to the following directory in your CubXWindow.app demo application:
cd CubXWindow.app/X11R6/lib/X11 <enter>

4  	Enter the following command in the terminal:
gnutar zxvf CubXWindow.Demo-MoreFonts.tar.gz

The fonts will be added to the CubXWindow.app/X11R6/lib/X11/fonts directory. 

For more information, please contact : 

Intuitive Systems, Inc.
599 North Mathilda Ave. Ste 19
Sunnyvale, CA 94086

tel : 408 245 8540
fax : 408 245 8541
cubx@intuisys.com

Cub'X-Window is a trademark of Intuitive Systems, Inc.
X Window System is a trademark of the Massachusetts Institute of Technology
Intel is a trademark of Intel Corp.
NEXTSTEP is a trademark of NeXT Computer, inc.