Help file for !RiscX
~~~~~~~~~~~~~~~~~~~~

 Application  : RiscX
     Purpose  : Contains the neccesary files to run an X server under
                RISC OS in either a single or multi-tasking environment.
     Version  : 0.06
      Author  : Leo White & Phillip Camp
        Date  : Fri 01st November 2002

 Leo White & Phillip Camp, 2000-2002

--------------------------------------------------------------------

  This is an Alpha release of RiscX.  As such it may not work on your
system, or may crash at any time although I use it myself on a fairly 
regular basis and it seems to be reasonable stable.

 Usage
 ~~~~~
 
   To start up the xserver, simply run the !RiscX application and
it will load up the neccessary support modules and open up a directory
containing a number of obey files.  The names of the obey files follow
the following format.

   [S](width)x(height)[x(depth)]
   
   S - Single tasking mode.
   
   width - Width of X session in pixels
   
   height - Height of X session in pixels.
   
   depth - The colour depth of the X server.  Default is 8bpp.
   
  These obey files are set up to run the X server once, and to search
  for a server willing to host an X session.

  Currently the Obey files only attempt to allocate 8MB of memory. As any X clients
  you run will allocate memory from the server, this value should be increased
  if you wish to run lots of X clients simultaneously, or want to run a memory
  hungry application (Such as Mozilla).  Most X clients assume they will be running
  on a machine with virtual memory, so don't handle running out of memory too
  well. So if an X client just exits, try increasing the amount of memory 
  RiscX starts up with and try running the X client again.
  
  Feel free to alter and add to these obey files.  To get a list of all the
  options run the riscx binary with the -help option.

<RiscX$Dir>.RiscX -help

  To get RiscX to search for a server running an X display manager 
  (The ones that bring up login prompts) add the -broadcast parameter.
  
  To get RiscX to attempt to connect to a specific server running an XDM,
  add 
  -query hostname
  where hostname is replaced by the hostname or IP address of the server.
  
  If none of the servers are running an X display manager then you can telnet
  into a machine and run an xterm specifying the RISC OS machine as the
  display to use.  i.e
  
  xterm -display riscpc:0
  
  then yoy can run X applications in the xterm and they should appear
  in RiscX.

  Exitting the X server
  ~~~~~~~~~~~~~~~~~~~~~
  
  In multi tasking mode, the X server will exit when you quit the front end
  application (!RiscXFE).

  In single tasking mode, the X server can be quit by pressing the menu button
  in the top left corner of the screen.

  The obey files are set up to run the X server once.  So it will automatically
  exit if the X session is terminated by the remote host.

  Errors
  ~~~~~~
  
  Any errors or warnigns will be written to the Output file inside the !RiscX
  directory.
  
----------------------------------------------------------------

History
~~~~~~~
  
  Version 0.07
  ~~~~~~~~~~~~
  
  - Added 4, 16, and 32bit depth support. Access via the -depth argument
  - Improved the efficency of screen updates in the multi tasking version
    of RiscX. Thus giving a speed increase.
  - Enabled LBX (Low Bandwidth X)
  
  Version 0.06
  ~~~~~~~~~~~~
  
  - Fixed single tasking mode... Which I accidently broke in the 
    previous version...

  Version 0.05
  ~~~~~~~~~~~~
  
  - Fixed a couple of redraw operations where the screen wasn't fully
    updated in the multi tasking mode.
  - When the mouse leaves the RiscX window it now releases any pressed
    mouse buttons.  This stops the mouse buttons getting stuck down.
  - Now attempts to use the taskwindow sleep upcall to stop it
    pulling as much CPU time when idling.  Tho this doesn't seem
    to have much affect under RISC OS 4.03

  Version 0.04
  ~~~~~~~~~~~~
  
  - Fixed bug where pointer events were being sent even if the pointer 
    hadn't moved.  This was causing any X client that grabbed the pointer
    to be overwhelmed with X events, making it unusably slow.
  - Added initial keyboard autorepeat support. Currently the delay and repeat
    rate are hardcoded.
  - Compiled up using the latest GCC and Unixlib, increasing the stability.
  - Cleaned up the wait loop so it runs a bit faster.
  
  Version 0.03
  ~~~~~~~~~~~~
  
  - Tided up the source for the modules and put them into CVS
  - Fixed a couple of initialisation bugs, so should now start up
    more reliably.
  - Fixed the 'mouse floating up the right hand side' bug.

  Version 0.02
  ~~~~~~~~~~~~
  
  - Fixed the pseudo milli second counter (Was going 10 times to fast)
  - Improve double clicks
  - Moved the font directories into a path variable instead.
  - Fixed problem with RiscXInput eating keys when RiscX didn't
    have the focus
  
  Version 0.01
  ~~~~~~~~~~~~
  
  - First release.

  
----------------------------------------------------------------

Conditions of Use
~~~~~~~~~~~~~~~~~
  RiscX has been built from the X11R6.4 source code released by
The Open group, and as such must include the following notices.


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.

----------------------------------------------------------------

Contacting The Author
~~~~~~~~~~~~~~~~~~~~~

  If you wish to contact me, e.g. to tell me about any bugs,
improvements etc. Or if you just want to send me large amounts of
money :) (Well you never know), then you can use the following
methods.

email : leo@beyondthought.co.uk
