				HamLog 0.9.1
		        Amateur-Radio Logging Program

1.1	How to compile the program
1.2	I speak Portuguese

2.	Data files used by this program

3. 	Help using the program
3.1 	 Main Window
3.2	 Contact Lists

4. 	New Contact
4.1 	 Adding new fields to the data base

5. 	Misc Information




------------------------------------------------------------------------------
1.1 How to compile the program

Hello,

	this is an Amateur Station Logging program. You will find this
useful if you are a radio-amateur operator. I've done this on my spare time
but i think its a fine program. It has bugs, some of them i know and some of
them you will tell me, won't you? :)
	
        To compile this you will need a recent GTK/GLIB installation since
I've used the development branch of this toolkit, and try the just the 
following:

	make clean
	make

If you have problems please tell me, the contact information is below.

If you can compile this on a different system than Linux x86 tell me!

------------------------------------------------------------------------------
1.1 I speak Portuguese


	If you speak PORTUGUESE and you want to see the menus and other stuff
in Portuguese you can change the line on the Makefile:

CCFLAGS=-g -Wall -UPORTUGUES `gtk-config --cflags`
	
	to
	
CCFLAGS=-g -Wall -DPORTUGUES `gtk-config --cflags`


------------------------------------------------------------------------------
2. Data files used by this program

   This program uses several data files for the following:
   
   	- contacts
	- city
	- country
   	- band
	- type of modulation
   	- type of antenna
	
   Each one of them is created automatically and you can add values to them
when you use the program, so you don't need to edit them directly but you can
if you want to. But BEWARE that if the program itself finds errors on the file
it will delete the line with errors! You can guess the format of the 5 last
files after using the program and looking at them.You can also edit the
contacts file but this is DANGEROUS, because each contact is stored on a
different line and if you use a text editor that does line wrapping you will
get in trouble.
   When you save or exit the program , these data files are saved and a backup
is made for each one (.bak)

------------------------------------------------------------------------------
3. Help using the program

	To use this program after you have it compiled, you need only the
binary file, and create a directory and run the program there. When i have
the time i will had something better than this.

------------------------------------------------------------------------------
3.1 Main Window

	The main window has the Menu, a Tree Window and a List Window
	On the Tree Window you can see 4 fields:
	
		[+] Call Sign
		[+] Band
		[+] City
		[+] Country
		
	Pressing one of the [+] will bring you with the call signs, bands
	city's and country's that you have made a QSO. If you use the program
	for the first time you won't see nothing!
	
	
	If you have something like this:
	
	
		[-] Band
		 |
		 |- 40m, 7.000 - 7.100MHz
		 |- ...

------------------------------------------------------------------------------
3.2 Contact Lists

	and if you select the 40 meters band you will see all the QSO you
have made on the list on the right. If you want to change or see in detail a
QSO just select the line you want and a new window will appear.There you can
change the name, put some observations, select the type of antenna, etc etc.
	

------------------------------------------------------------------------------
4. New Contact
	
	If you select this option on the File Menu of the Main Window, a new 
contact window will appear. You can then set the Call Sign, the name of the
remote station, etc.

	By now the program doesn't refresh the Tree Window, so you won't see
new call signs or any other field that you have added until you exit and
restart the program, although the List Window is updated. This will be changed
in the future!

------------------------------------------------------------------------------
4.1 Adding new fields to the data base

	To select the band, type of antenna,etc, the program will bring you
another window where you can select the one you want. If you want to add a
new one just use the text entry and them press the enter key. The program will
automatically add this to the database files when you save or exit.
	If you insert a new value that is already on the list, the program
won't add the new one but will select the one it has found.

------------------------------------------------------------------------------
5. Misc Information

You can reach me on

	Nuno Sucena Almeida <slug@student.dee.uc.pt>


I've developed this program with the following:

System:
	Linux 2.2.1 x86

Utilities:
	gcc version 2.7.2.3
	GNU Make version 3.77
	Jed 0.98.7

Libs:
	libgtk-1.1.so.16
        libgdk-1.1.so.16
        libgmodule-1.1.so.16
        libglib-1.1.so.16
	libc.so.6
