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.

Xlog can read your rig's frequency, mode and signal strength, if compiled
with hamlib support. 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.

FONTS AND THEMING
-----------------
Fonts are handled by the GTK theme engine. When you use the gnome2 desktop, 
start up gnome-font-properties. Otherwise, edit ~/.gtkrc-2.0 and add a line
like:

gtk-font-name = "Times New Roman 14"

Or whatever. GNOME 2 applies its own settings to GTK2 programs with the 
gnome-settings-daemon. When the daemon is running, GTK2 programs will use the 
GNOME settings instead of those present in .gtkrc-2.0.

There is also an application called gtk-theme-switch2, which you can use to 
adjust both appearance and font, whether you use gnome or not.

XLOG USAGE
----------
Read the manual page for a description on how to use xlog, or select help ->
Documentation -> Manual from the menu.
Dxcc lookups are done and heading and distance to a station is displayed. 
Dxcc information is derived from cty.dat. 

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://www.qsl.net/pg4i/linux/xlog.html.
You may also find rpm packages there and links to packages for other
distributions or operating systems.

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, where you can ask questions about
xlog.
