/[xlog]/xlog/MANUAL
ViewVC logotype

Diff of /xlog/MANUAL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.14 by pa4tu, Sat Sep 25 16:10:23 2004 UTC revision 1.15 by pa4tu, Wed Sep 29 12:06:35 2004 UTC
# Line 1  Line 1 
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
# Line 33  the QSO in the QSO frame, and clicking o Line 33  the QSO in the QSO frame, and clicking o
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.
# Line 56  Here is a list of keys that can be used Line 56  Here is a list of keys that can be used
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
# Line 73  there. You can use wildcards or a list o Line 73  there. You can use wildcards or a list o
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
# Line 88  For contest logs, you can enable 2 empty Line 88  For contest logs, you can enable 2 empty
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
# Line 112  use Edit->Paste to copy the fields into Line 112  use Edit->Paste to copy the fields into
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
# Line 122  Please note that it maybe desirable to s Line 122  Please note that it maybe desirable to s
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.
# Line 144  so the original log will be safe. You sh Line 144  so the original log will be safe. You sh
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.
# Line 156  entry. This is especially useful in cont Line 156  entry. This is especially useful in cont
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
# Line 182  Your hamlib port can be configured in th Line 182  Your hamlib port can be configured in th
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'.
# Line 193  ktrack by LX2GT (starting at version 0.2 Line 193  ktrack by LX2GT (starting at version 0.2
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
# Line 202  for the file type when importing or expo Line 202  for the file type when importing or expo
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>.

Legend:
Removed from v.1.14  
changed lines
  Added in v.1.15

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26