1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149
|
TWLOG README
DESCRIPTION:
This GUI program records basic Ham log information. It uses Motif,
so a statically linked version is included for those who don't have
Motif can run the statically linked program. This program is for
day to day logging, not contesting. There is no dup checking and
contest related things like that. My keyboard is where my logbook
use to be, so why not use the computer to log QSOs!
The interface can be customized without re-compiling. A resource
file allows you to modify the menus for the bands, modes, etc.
that you use.
Most of the log entries can be made with a button press or a single
key stroke. It records the date, start and end times, call sign,
band, mode, power, and signal reports. There is also a field
for general notes.
A second window allows you to search and edit the log file, and a
third widow provides online help. The helpfile contains much more detailed
information than this file and can also be view with any unix command or
editor at anytime.
USER INTERFACE:
The main interface has a data entry form and a menu bar. The data
entry form holds log information for one QSO. Most data can be entered
with a button press or a key stroke. The File button on the menu bar
lets you perform operations on the log file, like append the data entry
form to the log, edit, print the log, etc. A Help button on the menu
bar brings up other windows with online help.
INSTALLATION:
You may need root privileges for some of these steps, depending on
where you want to copy the files. The pathnames below are correct for
my system. Your's may vary.
To install the STATIC version, start with step 1.
To install the DYNAMIC version, start with step 2.
To compile and install your own runtime version, start with step 3.
1. If you do not have motif or lesstif libraries, you will need to install
the STATIC version. Copy twlog.static to some directory in your PATH
($HOME/bin, /usr/local/bin) and rename it twlog.
Skip to step 4.
2. To install the DYNAMIC version, copy twlog.dynamic to some directory
in your PATH ($HOME/bin, /usr/local/bin) and rename it twlog.
Skip to step 4.
3. To compile your own version, take a look at the makefile and
modify as needed for your system. You may have to change LIBDIR if
your libs are someplace else. Then, execute a make command to build
the executable. Copy twlog to some directory in your PATH ($HOME/bin,
/usr/local/bin).
4. Next, create a directory to hold your log files. I call it logfiles,
and put it under my home directory. (mkdir $HOME/logfiles)
Now, copy the helpfile into the new directory. (cp helpfile $HOME/logfiles).
5. Now, edit the file Twlog, and locate the line with:
twlog.dirpath: logfiles
Change logfiles to the complete path of the directory you created in step 4.
For me, the line looks like this:
twlog.dirpath: /home/ted/logfiles
NOTE: $HOME won't work here. It must be the complete path.
DO NOT put any spaces at the end of the line.
Save your changes and copy the resource file, Twlog, someplace where X will
find it. The easiest way to do this is step (a) below, as root. X will
find resource files in many places and if you are using something like
XAPPLRESDIR, then my guess is you already know what to do - HI.
(a) copy Twlog to the system app-defaults directory.
cp Twlog /usr/X11R6/lib/X11/app-defaults
-OR-
(b) cat it to the end of your .Xdefaults file
cat Twlog >> $HOME/.Xdefaults
-OR-
(c) to your resource file/directory (XAPPLRESDIR)
Remember where you copied Twlog! You will want to edit it again to
customize the main window to your needs.
TESTING:
If all went well, you should be able to run the program. cd to your home
directory and try to run twlog. If you don't see:
command not found: twlog
then the binary must be installed properly. If you get an error message
like this:
Error in Twlog resourse file
twlog.tzone: must be 0 or 1
then the binary was found, but the resource file was not found. Try putting it
in one of the other locations listed in step 5 above and check your X
environment. The manual pages for X will be of assistance.
Other possible error messages will complain about not finding your logfiles
directory or the helpfile. Remember where you copied Twlog? Go there and
edit it. Check the line - "twlog.dirpath: /home/ted/logfiles".
Make sure there are no spaces at the end of the line. Also, make sure the path
exists, and that the directory contains the helpfile.
If you see the main window, push the Help button on the menu bar and the Help
button in the pulldown menu. You should see a window with the helpfile. Read
the help file. It will tell you how to use the interface with a mouse and with
the keyboard(very fast). There is also a section called RESOURCE FILE that
explains how to modify the resource file and customize the interface for your
bands and modes. The helpfile can also be viewed with any unix command or
editor. The resource file itself contains comments as well.
If you are still having problems, send me all the info on the error to the
e-mail address below and I'll be glad to help.
If everything is OK, then still, send me e-mail. I'd like to hear what
you think of it. Are there any additional menu function, features needed,
bugs, typos, general comments, I wasted my time, WHATEVER! I have written
Motif interfaces for many years now and have found them intuitive and easy
to use.
I hope you do too.
PLS QSL TO: ted@bluestone.com
73,
Ted - WA0EIR
|