co-Xist  -  X for NEXTSTEP
Release 3.3 

Pencom Software
January 1994

co-Xist (TM) release 3.3 is Pencom's implementation of X11R5, the industry standard X window system that provides a network-transparent and vendor-independent windowing environment. With co-Xist, NEXTSTEP users can display X applications that are running locally or remotely on a network within windows on NEXTSTEP for NeXT, Intel, and Hewlett-Packard systems. Developers can also use co-Xist to port or develop X-based applications for the native processor.

The co-Xist demo gives you a full X server plus a limited selection of X clients and fonts.  It runs for 30 minutes.  There are demos available to run on NeXT, Intel, and HP computers with NEXTSTEP 3.0 or higher.   There is also a triple-fat demo available.

About co-Xist

co-Xist 3.3 provides full support for applications and servers running under MIT's X Window System(TM) Version 11 Release 5 (X11R5), the industry-standard X window system. co-Xist supports the OSF/Motif 1.2.3 Graphical User Interface that provides a Common Desktop Environment look and feel for your X applications. co-Xist also supports an optional developer's X and Motif package which enables a developer to port existing applications based on X to the NeXT operating environment, or to create new ones.

For more information on co-Xist release 3.3, contact Pencom at any of the following:

	E-mail: 	co-Xist_info@pencom.com  
			(Please confirm if you can accept NeXT Mail)
	Phone: 	512-343-6666 or 800-736-2664
	Fax: 		512-343-9650

Installing co-Xist;¬Installing co-Xist

The basic steps for installing the co-Xist demo application are as follows:

I. 	Install the co-Xist software using the NeXT Installer application.

II. 	Run co-XistLinker to set up the links for co-Xist. 

III. 	Run UserInstaller to install the necessary X Window System initialization files. 
	For network installations, this step must be performed by each new co-Xist user on your system.

I. Installing the co-Xist Runtime System;¬Installing the co-Xist Demo

co-Xist is an X server that lets you execute X applications locally, and run X applications from other host systems. It includes all standard X11R5 and Motif applications, manual pages, and demonstration programs. The demo package, co-Xist.demo.pkg, requires the following total disk space:

	Single architecture installation - 6 MB
	For any two architectures - 9 MB
	For all three architectures - 12 MB

1. 	Log in as root. 

	Root privileges allow you to install and make links to the protected directories that we recommend. 

2. 	Find co-Xist.demo.pkg in the browser and double-click on it.

	The NeXT Installer window appears.

3. 	Click on the Install button in the Installer window.

4. 	The Installer dialog panel displays /LocalApps, the default installation directory. If you are installing in another directory, click Set to see the browser and type in the path.

5. 	Click on Install. The co-Xist files are copied onto your computer.

6. 	When the Installation completed message appears, close the Installer window and quit the installer.

Running the co-XistLinker;¬II. Running the co-XistLinker

The System Administrator must run the co-XistLinker application to set up symbolic links for the system. co-XistLinker automatically checks and/or creates symbolic links for all of the co-Xist and Motif packages installed.

7. 	List the directory in which you installed co-Xist. The co-XistLinker is located in that directory; double-click on its icon. 

	An information panel appears to describe the linking process. Read the introduction window completely.

8. 	Click on the Continue... button. The co-XistLinker window appears.  

9. Click on Setup to link your files.

	An information panel appears. When linking is completed, the panel says: 

	All the symbolic links for co-Xist created successfully!

	Note: If co-XistLinker does not run to completion, you need to run it again to break any links that were created, then run it a third time to make all links again.

10. Quit co-XistLinker.  If you wish, you can now log in as a non-root user.

Each co-Xist user should now run UserInstaller as described in the following section.

Running the co-Xist UserInstaller;¬III.  Running the co-Xist UserInstaller

Each co-Xist user must run the co-Xist UserInstaller before launching the co-Xist demo for the first time.  UserInstaller creates the default initialization and configuration files required by co-Xist and the X Window System.  UserInstaller is located in the same directory in which co-Xist was installed, typically /LocalApps. 

11. Using the file viewer, list the directory in which you installed co-Xist and double-click on the UserInstaller icon. 

	An information panel describes the UserInstaller process.

12. Click on the Install... button.  In the window, click on Network or Local, depending on where co-Xist is installed. 

13. The Path Modification window appears.

	If you had an X Windows package installed previously AND you have modified your path, select Don't Modify Path. 

	If you have not had an X Windows package installed previously, or you are not sure, select Modify Path Too.

14.When the "Installation Completed" panel appears, click on Quit to exit the UserInstaller.

15.Enable the second mouse button in order to run co-Xist by selecting the Preferences application.  Click on the Mouse icon and in the Menu Button area, select Enabled and Right.

The co-Xist demo is now ready for use. It will run for 30 minutes.

De-installing co-Xist;¬De-installing the co-Xist Demo

1.	Log in as root.

2. 	Go to the directory where the co-Xist demo application is installed (usually /LocalApps/co-Xist).

3. 	Double-click on the co-XistLinker icon. 

	An information panel appears to describe the linking process. 

4. 	Click on the Continue... button.

5. 	Click on Unsetup to unlink your files.

	An information panel appears. When linking is completed, the panel says:
	
	All the symbolic links for co-Xist undone successfully!

6. 	Quit co-XistLinker.

7. 	In the workspace, select the /NextLibrary/Receipts directory. Double-click on co-Xist.demo.pkg.

	The NeXT Installer is launched automatically and its window appears.

8. 	Delete co-Xist and its associated files by clicking on Delete. A message similar to the following appears:

	WARNING: co-Xist.demo will be deleted! Are you sure you want to delete co-Xist.demo.pkg?

9. 	Click on Delete.

	Wait for Deletion completed to appear.

10. Quit the Installer.   The co-Xist demo has been removed from your system.

Running co-Xist

1.	To run co-Xist, double-click the co-Xist.app icon from the File Viewer, or drag the co-Xist.app icon to your dock and double-click it there.

	You should see two xterms with twm window borders on your screen.  

2.	If you like, you can try out the different options for running co-Xist. By default, co-Xist runs in rootless (integrated) mode.  To change modes, select the Preferences...option from the Info drop-down menu on the co-Xist menu.  This will pop up a panel detailing the different co-Xist options described below.

	Note that each time you change an option, you must restart co-Xist for the change to take effect. 
	
a.	Click the Screen Mode button to toggle back and forth between takeover mode and integrated mode.  
	
b. 	Select the Normal rootless option to use rootless mode.  On NeXT hardware, you can also select the Accelerated option to use accelerated rootless mode.  (This mode is not available on Intel or HP hardware.)  

c.	Select the NEXTSTEP Window Manager option to cause the X clients to use NEXTSTEP's move and resize bars instead of the twm move and resize decorations.  

d.	Deselect all the rootless options to use rooted mode.  

e.	Change the Frame Buffer Depth to 8-bit Pseudo to try out pseudocolor emulation.  
	
3.	To try some of the X clients provided in the demo, go to one of the xterms in the default X configuration and type the client's name at the command line. The following clients and utilities are provided:

	bdftopcf 	Converts X fonts in the bitmap distribution
			format to the binary format X uses

	rgb		Rebuilds the X color database (only needed
			if you modify /usr/lib/X11/rgb.txt)

	twm		The tab window manager

	puzzle	X version of the classic sliding-piece puzzle

	xauth	Provides user-based X server access (requires
			additional X setup)

	xdpyinfo	Prints out information about the X server
			configuration

	xhost	Lists and modifies hosts allowed to connect to 
			the X server

	xmodmap	
			Lists and modifies the X server keyboard map
			and mouse button map

	xrdb		Lists and modifies the X server resource
			database (an alternative to the .Xdefaults file) 

	xset		Lists and modifies other X server internal
			data (try xset -q to see what can be changed)

	xterm	The X terminal emulator

4.	Since X is a network-transparent windowing system, you can also display X clients from other systems.  For example, if your NEXTSTEP system is named next1, and you have a Sun on the network named sun1, perform the following steps:

a. 	Enable sun1 to have access to the co-Xist X server by running the following command: 

		xhost + sun1

b. 	Telnet to sun1 and set the DISPLAY environment variable to point back to the NEXTSTEP system using one of the following commands:

	   	In Bourne shell:

		DISPLAY=next1:0
		export DISPLAY

	  	 In C shell:

		setenv DISPLAY next1:0

c. 	Now, any X client running on sun1 will still be running on sun1, but it will display on next1.  Run the following command:

		/usr/openwin/bin/xman

	For systems other than Sun, X clients typically reside in /usr/bin/X11. The steps involved are the same.

Thanks for trying out co-Xist release 3.3.