.\"
.TH XDX 1 "Xdx 2.91" "Joop Stakenborg" "Ham radio"
.
.SH NAME
Xdx \- TCP/IP DX-cluster client for Amateur Radio
.
.SH SYNOPSIS
.B xdx
.RB [\| \-c
.IR cty.dat \|]
.RB [\| \-h \|]
.RB [\| \-V \|]
.
.\" --------------------------------------------------------------------
.SH DESCRIPTION
.\" --------------------------------------------------------------------
.
Xdx is a DX-cluster client for the X Window System which
shows a list of DX announcements and a separate list of WWV, WCY,
\*(lqTo ALL\*(rq and other server messages in a single X11 window.
.
Xdx uses the telnet protocol to connect to a DX-Cluster host
via TCP/IP.
.
While host connections are most commonly made via the Internet, any medium
capable of carrying TCP/IP, such as packet radio, may be used.
.
Host connection details are saved between sessions.
.
.
.\" --------------------------------------------------------------------
.SH OPTIONS
.\" --------------------------------------------------------------------
.
The following options are recognized by Xdx.
.TP
.BI \-c\  cty.dat \fR,\ \fB\-\-cty_dat= cty.dat
Load a desired country data file.
.
.IP
Country data files are used to determine the DX Century Club (DXCC)
entity shown in the Country column.
.
Updated country files are available from
.UR http://\:www.country\-files.com/\:cty/\:cty.dat
country\-files.com
.UE
.
Although a country file is installed as a part of Xdx,
it will quickly become out of date as updates are made available
frequently.
.
Announcements of updated country files are sent to the Xdx
mailing list.
.
See the
.B BUGS
section below for the mailing list address.
.
.IP
See the
.B ENVIRONMENT
and
.B FILES
sections below for other methods of loading an updated country file.
.
.TP
.BR \-h ", " \-\-help
Print short Xdx usage message detailing available options
and exit.
.
.TP
.BR \-V ", " \-\-version
Print Xdx version and short copyright information then exit.
.
.
.\" --------------------------------------------------------------------
.SH ENVIRONMENT
.\" --------------------------------------------------------------------
.
.TP
.B XDX_CTY
If
.RB $ XDX_CTY
is set, its value is the location of the
.I cty.dat
file.
.
Using the
.B \-c
option overrides this environment variable.
.
.
.\" --------------------------------------------------------------------
.SH FILES
.\" --------------------------------------------------------------------
.
.TP
$\fBHOME\fI/.xdx/cty.dat
.
Xdx will load the country file found in the preferences
directory, normally $\fBHOME\fI/.xdx\fR, if the
.B \-c
option is not given or the
.B XDX_CTY
environment variable is not set.
.
This is a convenient way to keep an up-to-date or custom
.I cty.dat
for use just with Xdx.
.
.
.
.\" --------------------------------------------------------------------
.SH NOTES
.\" --------------------------------------------------------------------
.
Xdx has a new maintainer, Nate Bargmann, N0NB.
.
.PP
Development is currently hosted at
.UR https://github.com/N0NB/xdx
GitHUb
.UE
.
.PP
Xdx has been translated into several languages.
.
More translations are welcome.
.
Please contact the maintainer to contribute.
.
.
.\" --------------------------------------------------------------------
.SH BUGS
.\" --------------------------------------------------------------------
.
Please report bugs to
.UR xdxclusterclient-discuss@lists.sourceforge.net
xdxcluster\-client\-discuss
.UE
.
.
.\" --------------------------------------------------------------------
.SH SEE ALSO
.\" --------------------------------------------------------------------
.
From the menu, select Help\->Manual after starting Xdx for
a full manual.