
WeirdX FAQ
====================================================================
Last modified: Mon Mar  6 16:53:08 UTC 2000

the latest info can be found at
http://www.jcraft.com/weirdx/
--------------------------

Summary of Contents:

1 - Introduction 
     1.1 What is WeirdX? 
     1.2 Where can I get WeirdX? 
     1.3 Why is it named "WeirdX"?

2 - Installation 
     2.1 What are required to use WeirdX?

3 - Usage 

4 - Configuration 
     4.1 What Java properties are accepted?

5 - Miscellaneous Questions 
     5.1 How about SSH?

========================================================================

-=-=-=-=-=-=-
Introduction:
-=-=-=-=-=-=-

1.1 What is WeirdX? 
----------------------------------
WeirdX is a pure JavaTM X Window System server.
WeirdX handles X window protocol directly,
so any proxy programs are not needed on X client side.
WeirdX had originated from an early version of WiredX-Lite. 

1.2 Where can I get WeirdX? 
----------------------------------
The official site to get new developmental versions is
http://www.jcraft.com/weirdx/ . 

1.3 Why it is named "WeirdX"?
----------------------------------
That name has come from the development cycle of authors.
First of all, X clients had be executed on WeirdX at random.
Then, if 'weird' behaviors had been observed, 
they had started dull bug hunting procedures, dumping X protocol
sequences, interpreting them by eye balls,
checking spec-docs of X protocols, etc,.
If bugs had been identified and they had been fixed, 
fixed code had been feed-backed to the source tree.
These cycles has been repeated tons of times.
You may find weird behaviors in current version.
Some of them are forgiven to be fixed, because of poor functionalities
of Java 1.1.* APIs.

1.4 What X protocols are supported?
----------------------------------
At present, only X Core protocol is supported partially.
In the core protocol, some requests are given up to be
implemented. For example, the request "WarpPointer" is not
supported. Do you know how to move a mouse pointer by Java APIs?
  
-=-=-=-=-=-=-
Installation:
-=-=-=-=-=-=-

2.1 What are required to use WeirdX?
You need JDK 1.1.* and Swing 1.1.* or Java2.
And of course, you must have a unix box, on which X clients run. 
If you want to run WeirdX as an applet,
you need Java plug-in, JRE 1.1.2 or Java2 and
web browsers: Internet Explorer or Netscape Navigator.
Don't use Java2 plug-in on Opera. Opera will crash.

2.2 What platforms are supported?
Ideally, WeirdX will be available on any platform, which supports
JDK 1.1.* and Swing 1.1.*. Confirmed platforms are listed below.
If you succeed to run WeirdX on other platforms, please write to
weirdx@jcraft.com. Your info will be added here.

- Windows 95
- Windows 98
- Windows NT
- OS/2
- Intel Solaris 2.6.0
- Intel GNU/Linux, J2SE v.1.2.2 (feedback from David Golden)
- Alpha OSF1, J2SDK.v.1.2.1 (feedback from Keith Schincke)
- MacOS 9 with MRJ 2.1.4, MacOS 8.6 with MRJ 2.1.x 
  (feedback from Tarun Reddy, Eric Albert)

-=-=-=-
Usage:
-=-=-=-

-=-=-=-=-=-=-=-
Configuration:
-=-=-=-=-=-=-=-

4.1 What Java properties are accepted?
Supported properties are listed below,

- weirdx.display.width: numeral
- weirdx.display.height: numeral
- weirdx.displaynum: numeral
- weirdx.windowmode: InBrowser | MultiWindow
- weirdx.display.visual: TrueColor16 | PseudoColor8 | StaticGray8
- weirdx.display.acl: [+hostname[,+hostname[,...]]]
- weirdx.display.threebutton: yes | no
- weirdx.display.keymap: a name of keymap. 
- weirdx.display.charset: [charset[,charset[,...]]] 
- weirdx.xrexec: yes | no
- weirdx.xdmcp.mode: query | broadcast
- weirdx.xdmcp.address: ip-address
- weirdx.myaddress: ip-address
- weirdx.extension: names of extensions.
A sample file, "config/props" is included in a distribution.

-=-=-=-=-=-=-=-=-=-=-=-=-
Miscellaneous Questions:
-=-=-=-=-=-=-=-=-=-=-=-=-

5.1 How about SSH?
Of course, WeirdX will work with SSH.
Here, the feedback from James B. Davis(james.davis@pobox.com) is
quated.
  I've got FSecure ssh on my WinNT laptop with weirdX 1.0.7.
  When I set displaynum to 0, a remote client via a ssh session comes
  right up.
