Thank you for your interest in axw3! Please follow the
instructions that follow. Bear in mind that version 0.2 of axw3
is a test-only release. Use it at your own risk. It may crash or
loop forever in some situations.

Compiling
---------

Extract the distribution files (as you've just done) and type

    $ make

If you want, move by hand the axw3 binary and config file to more
appropriate places, like /usr/local/sbin and /etc/ax25.

Testing
-------

1. If possible, patch call(1) in order to disallow the command
recognition feature and improve reliability. If you're using
ax25-utils-2.0.12c, a patch is provided within axw3 distribution
(in fact, we're providing a patched call binary too).

2. Edit the axw3.conf file accordingly to your local topology and
port name.

3. Configure your web browser to use a proxy server at port
2345. For Netscape 4 users, just select
Edit/Preferences/Advanced/Proxies and "manual proxy
configuration". At the HTTP proxy line, put the name of the
machine where you're running axw3 and 2345 as port number.

4. Start axw3 within an xterm or virtual console. It will block
your shell and display the progress of connections (this unusual
behaviour is just to make you become aware of crashes):

    $ ./axw3

You may specify the path of the configuration file using the -c
option as in the following example:

    $ axw3 -c /etc/ax25/axw3.conf

(if you're using xterm, may be a good idea ask it to save a lot
of scrolled out lines. To achieve this, start it with a large
argument to -sl, for instance "xterm -sl 2000 &". You can recover
the scrolled out lines using shift-pgup).

5. Disallow autoload of images and ask your browser to fetch your
preferred HTTP URL. Cross your fingers and see what happens.


If something goes wrong...
--------------------------

Try to identify the point where axw3 is making the wrong
thing. If you've a feeling about the diagnostic, please send an
email to ueda@ime.usp.br including the axw3 version number and
other stuff like its output. Thanks in advance,

Ricardo Ueda.

