FAQ
---
Please read the FAQ file after reading this document if you have any problems.

HAMLIB SUPPORT
--------------
If your rig supports data retrieval over the serial line, you should have
a look at the Hamradio Control Libraries (hamlib) project page, at
http://sf.net/projects/hamlib. Get version at least version 1.1.3 if you can.

Xlog can read your rig's frequency, mode and signal strength, if compiled
with hamlib support. See the INSTALL file for details. Hamlib support should
be enabled from the preferences dialog box.

TESTING HAMLIB
--------------
At his point you should probably read your rig's manual, to see how you
should hook up your rig to the serial port. For my kenwood rig, I need
a standard serial cable with two 9-pin connectors. You also need write
permission to the serial port. On my system, this means I need to add
myself to the dialout group, with a command like:

	adduser 'username' dialout

Next, you can test hamlib with rigctl, a binary distributed with hamlib.
See which rigs are supported:

	rigctl --list

Then start rigctl with your model number, e.g. '210' for a kenwood TS-870S,
hooked up to COM2:

	rigctl -r /dev/ttyS1 -m 210

Now you can check out if mode, PTT, frequency, signal strength and power
(all used by xlog) are retrieved. At the 'Rig command:' prompt, type:

	'f': retrieve frequency
	'm': retrieve mode
	't': retrieve PTT (TX/RX mode)
	'l' and then 'STRENGTH': retrieve signal strength (-54=S0 and 0=S9)
	'l' and then 'RFPOWER': retrieve rig power (0.39 = 100 Watts)

The hamlib FAQ at http://hamlib.sf.net/faq.html gives some answers to common
problems. You could also ask around on the hamlib mailing list, see:
http://lists.sourceforge.net/lists/listinfo/hamlib-developer.

XLOG USAGE
----------
Read the manual page for a description on how to use xlog (man xlog).
Dxcc lookups are done and heading and distance to a station is displayed. 
Dxcc information is derived from cty.dat. 

Printing is supported by using latex, so you need to install the tetex package.
Xlog can exchange data with twpsk (version 2.0 and higher) by WA0EIR, 
gmfsk by OH2BNS (starting at version 0.4) and ktrack (starting at version
0.2.1) by LX2GT.

BINARY PACKAGES
---------------
Debian packages are at http://packages.debian.org/xlog.
The xlog home page is at http://people.debian.org/~pa3aba/xlog.html.
You will also find rpm packages there. Slackware packages are at
http://sharon.esrac.ele.tue.nl/pub/slackware/pre-current/contrib/ham/logging.

DEVELOPMENT
-----------
If you are interested in xlog development, go to 
http://savannah.nongnu.org/projects/xlog. Information about a mailing list for
xlog development is available on this page.

Send comments to: xlog-discussion@nongnu.org, for a list of authors see the 
AUTHORS file.
