
X Windows Replacement Library for RISC OS
-----------------------------------------

http://www.riscos.info/xlib/
Peter Naulls <peter@chocky.org>

Release 0.20
15th June 2004


About
-----

ChoX11 is in short, a replacement for Xlib, the library which forms the
bottom part of the X Windows system for X clients, and is responsible for
putting messages "on the wire" and talking to the X Server.

The importance of X applications to RISC OS cannot be understated.
There are hundreds, if not thousands of X applications which could potentially
be ported to RISC OS to plug gaps in the software base.  In addition, this
software is continually developed with no or little effort from RISC OS
developers.

All X Windows applications at the bottom level rely upon Xlib, including
those using the  many popular toolkit libraries such as Xt, GTK+, Motif, Qt.
Improvements in ChoX11 will allow apps built with these libraries to run
natively in RISC OS.  Please support ChoX11.


How?
----

For various reasons, the performance of X Server plus X clients in RISC OS
isn't particularly hot, and also requires running a bulky X Server, when
in most cases, you just want to run things on your machine, and don't need
all the extra functionality.

ChoX11 replaces Xlib when linking a program, and talks directly to the
RISC OS Wimp instead.  It relies on DeskLib for its functionality.  A
sample program and Makefile is included.  You will also require a 32-bit
RiscXLib.  These are available from http://www.riscos.info/

When linking your program, instead of using "-lX11" to link with XLib,
use "ChoX11:libCX11.o Desklib:Desklib.o" or similar.  You will still
need to link with all the other X libraries of course.



Developing
----------

ChoX11 is still a little way from completion.  This release is made available
so that interested parties may experiment.  This release is unsupported,
except to Unix Porting Project subscribers (http://www.chocky.org/unix/).

The source is available separately for those who wish to contribute.

It is possible to use ChoX11 in a cross compiling environment with
GCCSDK.  I recommend in this instance cross compiling and installing
XFree86 for RISC OS yourself.  Instructions and patches for this are
on http://www.riscos.info/xlib/



Copyright
---------

ChoX11 includes source from Xlib, and therefore the notice below is
included.  ChoX11 may be used freely for any purpose, but you are
encouraged to contribute.

The parts not taken from Xlib are mostly written by Peter Naulls,
and Alan Buckley with contributions by Chris Williams and Ian Jeffray.


Copyright (C) 1998   The Open Group

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish, dis-
tribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the fol-
lowing conditions:

The above copyright notice and the following permission notice shall be
included in all copies of the Software:

THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF MERCHANTABIL-
ITY, FITNESS FOR A PARTICULAR PURPOSE AND NON- INFRINGEMENT. IN NO EVENT
SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABIL-
ITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.

Except as contained in this notice, the name of The Open Group shall not
be used in advertising or otherwise to promote the use or other dealings
in this Software without prior written authorization from The Open
Group.

X Window System is a trademark of The Open Group.

