
Xnest - RISC OS XServer
=======================

19th May 2005

Part of the Unix Porting Project - http://www.chocky.org/unix/

Ported by Peter Naulls and Alex Waugh
Contact: unix@chocky.org

Support for this program is only offered to subscribers to the
Unix Porting Project.


About
-----
This a port of Xnest to RISC OS.  The original intent of Xnest was to
allow "nested" X session on an exiting X server.  Because of the mechanisms
used on RISC OS, Xnest works as a stand-alone X Server intended as a
32-bit replacement for !RiscX and !Gnome and others.


X Servers
---------
An X server is a program which allows display of graphics as directed
by X client programs.  Normally under RISC OS, these programs will run
elsewhere, and send their graphics over the network to the X Server
(e.g. as directed by setting of the DISPLAY variable under a Unix shell).
although it's also possible to display RISC OS ports of X applications
compiled against Xlib.

 
Usage
-----
Xnest needs to have seen !RiscXLib first.  This is available from
http://www.riscos.info/xlib/

Xnest is simply started by double-clicking on it, and it opens a window
occupying around 2/3rds of the screen.  See the HTML manual for extra
options which can be added to the !Run file.

For an example usage of Xnest, connect to a Unix machine (telnet or SSH),
and do something like the following:

 $ export DISPLAY=puffin:0.0
 (where "puffin" is the name or IP address of your RISC OS machine)
 $ xeyes &


About
-----

Xnest is beta software.  It still has some bugs, which are mostly
incomplete parts of the ChoX11 library, which it relies upon to run
in RISC OS as an X client application (Xnest is both an X server and an
X client).

Xnest also has a "rootless" mode.  This means that there is no main
window, but instead, a RISC OS window is opened for each X client window,
meaning much better integration of applications into RISC OS.  The
functionality for this mode is not yet complete, and has been disabled.
It is hoped to include it in a future release.
