Basic installation instructions for xlog
========================================

The simplest way to compile xlog is:

  1. The Hamradio Control Libraries will allow you to read the frequency of
     your rig over the serial port. You will need to have both headers and
     development libraries installed in order to compile xlog. 

  2. You also need a package called pkg-config in order for the configure
     script to work.

  3. pkg-config will look for a file called hamlib.pc. If this file is not
     installed in /usr/lib/pkgconfig, you should tell pkg-config where it is
     by modifying the environment variable PKG_CONFIG_PATH before calling
     configure, e.g:
     PKG_CONFIG_PATH="/usr/lib/pkgconfig:/usr/local/lib/pkgconfig".

  4. If you want to update the KDE/Gnome mime database while installing, use 
     ./configure --enable-mime-update. This is recommended if you install xlog
     to /usr or /usr/local.

  5. Xlog needs the gtk+2.0 development libraries to compile. On most 
     distributions the will be called libgtk2.0-dev or -devel. 
     Please use version 2.12.0 or higher.  

  6. The libxml2 development package is needed, on most distributions
     this is installed together with the gtk+ development package.

  7. You will need the libgnomeprint development files and headers. On my 
     system this package is called libgnomeprint2.2-dev. It might be called
     libgnomeprint2.2-devel on your box or something else.

This all means you need a fairly recent distribution to compile xlog.
Mandrake 10.1, SUSE 9.2 or Redhat Fedora Core 2 will all meet these
requirements. Xlog was developed on Debian Sarge (3.1).

  8. Type `./configure'.

  9. Type `make' to compile the package.

  10. Type `make install' to install the programs and data files. 

  11. When you want to strip the binary when installing, just type:
     `make install-strip'.

By default, `make install' will install the package's files in 
`/usr/local/bin', `/usr/local/man/man1', `/usr/local/share/xlog', etc.  
You can specify an installation prefix other than `/usr/local' by giving 
`configure' the option `--prefix=PATH'.