================================================
# xtide-README.fedora
# Written by Patrice Dumas and Mamoru Tasaka

# If you have some questions, please report it
# with redhat bugzilla:
# https://bugzilla.redhat.com/bugzilla/index.cgi
================================================

Availability and installation of harmonics files
================================================

To use xtide and related utilities (like xttpd, 
tideEditor), you need an harmonics file.
However, existing files cannot be distributed as part of Fedora, 
because their license restricts commercial redistribution and selling,
which is too restrictive for Fedora. These files should therefore 
be installed after the package installation by yourself.

Such files are available at:
http://www.flaterco.com/xtide/files.html
As the time of writing, the latest harmonics file is:
ftp://ftp.flaterco.com/xtide/harmonics-dwf-20060708.tcd.bz2
The utilities can only use uncompressed harmonics files.

There are 2 possibilities to have the utilities become aware of
the harmonics file location:

1) by editing /etc/xtide.conf, and setting the first line of the file
  to the path of the directory containing the harmonics files, or  
  to the harmonics file location (the utilities will also accept a colon `:' 
  delimited list of paths). 
  The second line of /etc/xtide.conf sets the directory which 
  contains world vector shoreline data. The second line can accept only
  one directory and cannot be colon-delimited.
  
  The default content of /etc/xtide.conf used by fedora is:

  /usr/share/xtide-harmonics/
  /usr/share/wvs-data/

  which means that all the files in /usr/share/xtide-harmonics
  are considered to be harmonics files and all under /usr/share/wvs-data
  are considered to be WVS data.

2) by setting the environment variable HFILE_PATH. You can also
   set WVS_PATH to specify the directory under which WVS data are
   stored.

You can run the provided script xtide-get_harmonics-data.sh
under /usr/sbin to install harmonics files to 
/usr/share/xtide-harmonics. This script requires 
administrator previledges.