1 |
***** NAME ***** |
----- NAME ----- |
2 |
xlog - GTK+ logging program for Amateur Radio Operators |
xlog - GTK+ logging program for Amateur Radio Operators |
3 |
|
|
4 |
***** SYNOPSIS ***** |
----- SYNOPSIS ----- |
5 |
xlog [option] |
xlog [option] |
6 |
|
|
7 |
***** OPTIONS ***** |
----- OPTIONS ----- |
8 |
-h Show summary of options. |
-h Show summary of options. |
9 |
-v Output version information and exit. |
-v Output version information and exit. |
10 |
|
|
11 |
***** DESCRIPTION ***** |
----- DESCRIPTION ----- |
12 |
xlog is a logging program for Amateur Radio Operators. The main window consists |
xlog is a logging program for Amateur Radio Operators. The main window consists |
13 |
of a button bar, QSO frame, and a browseable log. Logs will be saved to a flat |
of a button bar, QSO frame, and a browseable log. Logs will be saved to a flat |
14 |
text file. You can create, open and close logs as you need them. |
text file. You can create, open and close logs as you need them. |
15 |
|
|
16 |
***** USAGE ***** |
----- USAGE ----- |
17 |
QSO's are entered into the QSO frame on the left of the main window. Clicking |
QSO's are entered into the QSO frame on the left of the main window. Clicking |
18 |
the Date button will update the date field, the GMT button will update the GMT |
the Date button will update the date field, the GMT button will update the GMT |
19 |
field. When you add a call to the callsign field, xlog will look up the prefix |
field. When you add a call to the callsign field, xlog will look up the prefix |
33 |
Finally, selecting Edit -> Clear All from the menu will Clear all the fields in |
Finally, selecting Edit -> Clear All from the menu will Clear all the fields in |
34 |
the QSO frame. |
the QSO frame. |
35 |
|
|
36 |
***** KEYS ***** |
----- KEYS ----- |
37 |
Here is a list of keys that can be used to navigate through xlog: |
Here is a list of keys that can be used to navigate through xlog: |
38 |
Control a: Add a QSO. |
Control a: Add a QSO. |
39 |
Control d: Delete a selected QSO. |
Control d: Delete a selected QSO. |
56 |
Up Arrow: Select previous QSO. |
Up Arrow: Select previous QSO. |
57 |
Down Arrow: Select next QSO. |
Down Arrow: Select next QSO. |
58 |
|
|
59 |
***** PREFERENCES ***** |
----- PREFERENCES ----- |
60 |
In order to calculate the correct distance to your location, you have to enter |
In order to calculate the correct distance to your location, you have to enter |
61 |
your longitude and latitude in the Info page of the preferences dialog. Here |
your longitude and latitude in the Info page of the preferences dialog. Here |
62 |
you can also choose whether the distance should be displayed in Kilometers or |
you can also choose whether the distance should be displayed in Kilometers or |
73 |
.xlog will be automatically added, e.g. when using wildcards, 'p*' will load |
.xlog will be automatically added, e.g. when using wildcards, 'p*' will load |
74 |
all logs starting with 'p' and ending with '.xlog'. |
all logs starting with 'p' and ending with '.xlog'. |
75 |
|
|
76 |
***** PRINTING ***** |
----- PRINTING ----- |
77 |
You can either print a range or the whole log and you can choose which columns |
You can either print a range or the whole log and you can choose which columns |
78 |
are in the output. Printing can be done in 2 styles: landscape with 30 QSO's |
are in the output. Printing can be done in 2 styles: landscape with 30 QSO's |
79 |
per page and portrait with 50 QSO's per page. The loglines will be evenly |
per page and portrait with 50 QSO's per page. The loglines will be evenly |
88 |
advisable to disable the 'QSL Out', 'QSL In' and 'Remarks' columns. |
advisable to disable the 'QSL Out', 'QSL In' and 'Remarks' columns. |
89 |
Otherwise your log will not fit on the paper. |
Otherwise your log will not fit on the paper. |
90 |
|
|
91 |
***** QSL LABELS ***** |
----- QSL LABELS ----- |
92 |
glabels is a gnome application for printing business cards and labels, see |
glabels is a gnome application for printing business cards and labels, see |
93 |
http://snaught.com/glabels. It is designed to work with various laser/ink-jet |
http://snaught.com/glabels. It is designed to work with various laser/ink-jet |
94 |
peel-off label and business card sheets that you'll find at most office supply |
peel-off label and business card sheets that you'll find at most office supply |
112 |
with your mouse until the fit on the label. Save this file to use as a |
with your mouse until the fit on the label. Save this file to use as a |
113 |
template for your QSL labels. |
template for your QSL labels. |
114 |
|
|
115 |
***** LOG-EDITOR ***** |
----- LOG-EDITOR ----- |
116 |
The log-editor, when selected from the tools menu, can be used to display or |
The log-editor, when selected from the tools menu, can be used to display or |
117 |
hide a number of columns in the log. 2 columns allow free entry, they can be |
hide a number of columns in the log. 2 columns allow free entry, they can be |
118 |
given any name. Changes to the log columns will be committed once you save the |
given any name. Changes to the log columns will be committed once you save the |
122 |
when using ADIF export as described in the ADIF specifications at |
when using ADIF export as described in the ADIF specifications at |
123 |
http://www.hosenose.com/adif/adif.html, section 3: Field Definitions. |
http://www.hosenose.com/adif/adif.html, section 3: Field Definitions. |
124 |
|
|
125 |
***** DUPE CHECKING ***** |
----- DUPE CHECKING ----- |
126 |
A log can be checked for dupes from the tools menu. There are some restrictions |
A log can be checked for dupes from the tools menu. There are some restrictions |
127 |
on the frequency field when used in dupe checking. It should either contain a |
on the frequency field when used in dupe checking. It should either contain a |
128 |
'dot' after the MHz number or contain 3, 6 or 9 numbers after the Mhz number. |
'dot' after the MHz number or contain 3, 6 or 9 numbers after the Mhz number. |
129 |
When using hamlib, the total amount of numbers in the frequency field can be |
When using hamlib, the total amount of numbers in the frequency field can be |
130 |
selected in the hamlib page of the preferences dialog. |
selected in the hamlib page of the preferences dialog. |
131 |
|
|
132 |
***** LOG SORTING ***** |
----- LOG SORTING ----- |
133 |
If you select "Tools->Sort Log by Date", your log will be sorted by date and |
If you select "Tools->Sort Log by Date", your log will be sorted by date and |
134 |
time. Log sorting assumes that the whole log is created with the same locale. |
time. Log sorting assumes that the whole log is created with the same locale. |
135 |
Also, the log date should have the format "dd mmm yyyy" in your locale, e.g. |
Also, the log date should have the format "dd mmm yyyy" in your locale, e.g. |
144 |
and times before overwriting the original log. If the log is not correctly |
and times before overwriting the original log. If the log is not correctly |
145 |
sorted, start xlog from a terminal to see if sorting produces any errors. |
sorted, start xlog from a terminal to see if sorting produces any errors. |
146 |
|
|
147 |
***** DEFAULTS ***** |
----- DEFAULTS ----- |
148 |
Settings->Defaults will show a dialog where you can fill in default values for |
Settings->Defaults will show a dialog where you can fill in default values for |
149 |
logging. These values will be used when selecting 'Click All' from the menu. |
logging. These values will be used when selecting 'Click All' from the menu. |
150 |
|
|
151 |
***** WORKED BEFORE ***** |
----- WORKED BEFORE ----- |
152 |
When you select Worked Before from the tools menu, a dialog will be displayed |
When you select Worked Before from the tools menu, a dialog will be displayed |
153 |
which shows a sorted list of contacts while you are typing in the callsign |
which shows a sorted list of contacts while you are typing in the callsign |
154 |
entry. This is especially useful in contests. |
entry. This is especially useful in contests. |
156 |
The number of columns shown in this dialog can be adjusted from the |
The number of columns shown in this dialog can be adjusted from the |
157 |
settings->dialogs menu. |
settings->dialogs menu. |
158 |
|
|
159 |
***** TYPE AND SEARCH ***** |
----- TYPE AND SEARCH ----- |
160 |
When typing a callsign, the log is searched for a match. When a match is found, |
When typing a callsign, the log is searched for a match. When a match is found, |
161 |
your name, QTH, Locator and Remarks entries will be automatically filled in. |
your name, QTH, Locator and Remarks entries will be automatically filled in. |
162 |
You can switch this behaviour off in the preferences dialog. |
You can switch this behaviour off in the preferences dialog. |
163 |
|
|
164 |
***** HAMLIB ***** |
----- HAMLIB ----- |
165 |
When xlog is compiled with hamlib support you can read your rig's frequency |
When xlog is compiled with hamlib support you can read your rig's frequency |
166 |
over the serial port. You must select the model of your rig an the port used |
over the serial port. You must select the model of your rig an the port used |
167 |
from the list available in the hamlib page of the preferences dialog. If you |
from the list available in the hamlib page of the preferences dialog. If you |
182 |
dialog. You can enter things like: rts_state=ON,timeout=600,serial_speed=19200 |
dialog. You can enter things like: rts_state=ON,timeout=600,serial_speed=19200 |
183 |
here. |
here. |
184 |
|
|
185 |
***** DATA EXCHANGE ***** |
----- DATA EXCHANGE ----- |
186 |
xlog can exchange data with twpsk (version 2.0 and higher) by WA0EIR. When a |
xlog can exchange data with twpsk (version 2.0 and higher) by WA0EIR. When a |
187 |
callsign is entered, it will show up in twpsk's send widget (where you type |
callsign is entered, it will show up in twpsk's send widget (where you type |
188 |
your text) when hitting Shift+Alt+h. Shift+Alt+o will show 'hiscall de mycall'. |
your text) when hitting Shift+Alt+h. Shift+Alt+o will show 'hiscall de mycall'. |
193 |
with xlog. In order to do so, you need to enable the 2 free fields with the |
with xlog. In order to do so, you need to enable the 2 free fields with the |
194 |
log-editor. |
log-editor. |
195 |
|
|
196 |
***** IMPORTING and EXPORTING files ***** |
----- IMPORTING and EXPORTING files ----- |
197 |
xlog supports twlog, editest, ADIF, Trlog (tlf), EDI (VHF and higher contest |
xlog supports twlog, editest, ADIF, Trlog (tlf), EDI (VHF and higher contest |
198 |
format recommanded by IARU region 1) and Cabrillo import. Logs can be exported |
format recommanded by IARU region 1) and Cabrillo import. Logs can be exported |
199 |
to EDI, Trlog, ADIF and Cabrillo. The apropriate option menu should be selected |
to EDI, Trlog, ADIF and Cabrillo. The apropriate option menu should be selected |
202 |
When using EDI export, you should have enabled the locator field in the log. |
When using EDI export, you should have enabled the locator field in the log. |
203 |
Xlog will automatically calculate the distance and add it to the log. |
Xlog will automatically calculate the distance and add it to the log. |
204 |
|
|
205 |
***** FILES ***** |
----- FILES ----- |
206 |
/usr/local/share/xlog/dxcc/cty.dat contains the DXCC entries read by xlog. This |
/usr/local/share/xlog/dxcc/cty.dat contains the DXCC entries read by xlog. This |
207 |
file can be completed by adding entries to /usr/local/share/xlog/dxcc/xlog.dat. |
file can be completed by adding entries to /usr/local/share/xlog/dxcc/xlog.dat. |
208 |
|
|
209 |
***** SEE ALSO ***** |
----- SEE ALSO ----- |
210 |
The provided README for more information in setting up hamlib and the FAQ for a |
The provided README for more information in setting up hamlib and the FAQ for a |
211 |
list of frequently asked questions. |
list of frequently asked questions. |
212 |
|
|
213 |
***** BUGS ***** |
----- BUGS ----- |
214 |
Currently, xlog does not recognise the different call districts of Canada and |
Currently, xlog does not recognise the different call districts of Canada and |
215 |
the U.S. when calculation heading and distance. This is planned for a future |
the U.S. when calculation heading and distance. This is planned for a future |
216 |
version. |
version. |
217 |
|
|
218 |
***** AUTHORS ***** |
----- AUTHORS ----- |
219 |
xlog was written by Joop Stakenborg <pg4i at amsat.org> aka <pa3aba at |
xlog was written by Joop Stakenborg <pg4i at amsat.org> aka <pa3aba at |
220 |
debian.org> and Stephane Fillod <f8cfe at free.fr>. |
debian.org> and Stephane Fillod <f8cfe at free.fr>. |