				CL 5.81aw README
				================

System Requirements:
--------------------
CL was tested on RedHat Linux 7.2 and 7.3, and Debian GNU/Linux testing (and
should work on Debian GNU/Linux 3.0 (woody)) on i386 compatible machines.

Installing CL:
--------------
 1. Unpack cl.tar.gz using

	tar xzf cl.tar.gz

    The contents of the package is unpacked into directory `cl'.  It contains
    CL binaries (both staticaly and dynamicaly linked), supporting Perl
    scripts, binaries and run-time files of the Mozilla browser version 1.1,
    and fonts.

 2. Run

	cl/bin/initcl

    which is a Perl script.

Running CL:
-----------
CL can be run either by using script cl/bin/runcl which also launches the
Mozilla browser for you, or by running cl/bin/cl.  In the latter case you have
to start Mozilla yourself (cl/mozilla/mozilla) and point it to the address CL
displays when started.

CL may terminate with error

	bind(127.0.0.1:<number>): Address already in use

This means that the port <number> is bound by another program (possibly a copy
of CL run by a different user).  The runcl script tries to avoid such situation
and select a free port automaticaly, but, due to delay between runcl finding a
port being free and CL binding that port, other program may bind the port found
before your copy of CL.  In such a case, choose an arbitrary port number from
range 1024--65535 and pass it to cl or runcl via the command line option

	-p<number chosen> 

which must be the first argument to cl and runcl.

If you have used the Mozilla browser before, Mozilla that comes with CL will
honor your user preferences.  Proxy server settings are among these.  In case
you receive complaints like `Host localhost.your.domain does not exist', select
Preferences... from the Edit menu, choose category Advanced > Proxies in the
Preferences dialog box, and check `Direct connection to the Internet' radio
button (or set up manual proxy configuration with no proxy for localhost, or
ask your network administrator to modify the automatic proxy configuration
script you use to access localhost directly).

Note: CL may crash, save your work often.  If you come across a bug, try to
find out how to reproduce it and contact voda@diku.dk or kluka@fmph.uniba.sk .


					    Last modified on 2002-09-09 by JKl'
