1. About Gnome RIG

Gnome RIG is a graphical user interface to the Ham Radio Control Libraries,
which lets you control you communication radios and/or antenna rotators from
a personal computer. Gnome RIG is written using the Gtk+ and Gnome widgets and
it is intended to be used with version 1.1.2 or 1.1.3 of the Ham Radio Control
Libraries. 

Gnome RIG is in a very early stage and it supports only a very little subset
of the full Hamlib API (see NEWS for the currently supported features).


2. Compiling Gnome RIG

To compile Gnome RIG you will need:

* hamlib 1.1.2 or 1.1.3
* gtk+ 1.2 or later (not 2.0)
* gnome 1.4 or later (not 2.0) 
* gdk-pixbuf 0.8 or later
* GConf 1.0.4 or later (not 2.0)

These packages (except hamlib) are included in every modern non-specialized
linux distribution. You will also need the so-called development files of each
package which include the header files and static libraries.

To compile Gnome RIG you should run the accompaning 'configure' script and,
if you don't get any errors, type make. The program should now compile without
a single warning and you should end up with a binary called 'grig' in the 'src'
subdirectory. In case you are in doubt, this is the binary you should run...

If you want to install the program into your system, type 'make install' (can
usually only be done as root).


3. Using Gnome RIG

The first time you run Gnome RIG, it will ask you to specify some default values.
If you are in doubt of what you should do, just choose the "Dummy" backends. You
will be able to add other radios and antenna rotator later.

The default radio you specify is used when you start the program. If you somehow
choose a wrong radio or port and the program won't be able to start, you can
override the default settings or re-run the configuration druid using the
available command line options:

  -r, --radio=NUMBER          Use the radio with NUMBER (see --list-rigs)
  -a, --antenna=NUMBER        Use the rotator with NUMBER (see --list-rots)
  -i, --list-rigs             Show a list of configured radios and exit
  -o, --list-rots             Show a list of configured rotators and exit
  -d, --run-druid             Run first-time configuration druid

Please note, that --list-rigs and list-rots does not list all the radios/rotators
supported by Hamlib, but only the radios/rotator configured to be used in Gnome
RIG.

I hope you'll have fun using Gnome RIG. If you find any bugs or have any comments
feel free to contact me. Bugs and feature requests should be submitted using the
bug tracker on the project page: http://sourceforge.net/projects/groundstation.
Hamlib related bugs should be sent to the hamlib developer mailing list
hamlib-developer@lists.sourceforge.net.


Alexandru Csete, OZ9AEC
