
How to install jws
==================

- Get the source[1].

- If you're using HP-UX and lack the Xau library, go to contrib/Xau (it
  contains sources from X11R5), and compile with "xmkmf -a; make
  EXTRA_INCLUDES=-I.".

- Change to the src/ directory, choose the appropriate Makefile.* (e.g.
  copy or link it to Makefile) and make.

- Install jlock, jreq, jterm and jws in your $PATH.

- Set the appropriate environment variables[2] in your ".xsession".

- Create JWS-MAGIC-COOKIE-1 entries for `hostname`:0 and localhost:0 in
  your ".xsession" (16 bytes is probably a good size).  These bytes
  should be random and hard to guess for an attacker.  Look at the way
  your system creates MIT-MAGIC-COOKIE-1 entries for a start.  An entry
  for `hostname`/unix:0 is not required.

- Start jws from your ".xsession".  A "-<N>" parameter may be specified
  which determines how many windows are visible simultaneously ("-2" is
  default).

-----
[1] http://www.joerch.org/download/
[2] doc/config

