===============================================================
IMPORTANT NOTE ABOUT FOTOXX VERSION v.10.0
===============================================================

The EXIF key for user-defined tags has been changed to be more
compatible with other programs that use tags. After installing 
fotoxx v.10.0, existing tags must be converted. More details
can be found at: Menu Help > User Guide, topic "Convert Tags".

QUICK GUIDE:

If you have fotoxx tags you want to keep, do the following:
(1)  Back-up your image files
(2)  Do the function:  Tags > Convert Tags
This process is slow: about 100 images per minute.

If you have never used fotoxx tags, or if you have tags from 
another program you want to keep, then do the following:
(1)  DO NOT  run the function:  Tags > Convert Tags
(2)  Do the function:  Tags > Index Tags

If you have problems, write to me at: kornelix@yahoo.de
Nothing is erased, so you can continue to use the previous
version of fotoxx (9.9) until the problem is fixed.

==============================================================

Installation from source tarball:
  
Fotoxx has the following dependencies. The first three are 
required for installation and the remaining for operation. 
   g++                the Gnu C++ compiler and linker 
   libgtk2.0-dev      GTK graphics library (GUI base)
   libtiff4           read/write tiff-8/16 image files
   exiftool           read/write EXIF and tags data 
   ufraw              read digital camera RAW files
   xdg-utils          LSB standard Linux utilities 

After taking care of dependencies, install fotoxx as follows:

1. Download the tar file (fotoxx-N.N.tar.gz) to Desktop 
2. Open a terminal window 
3. $ cd Desktop                     # go to Desktop 
4. $ tar -xzf fotoxx-N.N.tar.gz     # unpack tar to ./fotoxx 
5. $ cd fotoxx                      # go there 
6. $ make -B                        # build executable 
7. $ su -c "make install"           # install files (as root) 
  
Missing dependencies will cause error messages in step 6. 
Install these from your repository and repeat step 6. 
 
The default install location is /usr/local. To change the 
install location, do the following before step 6 (make):
    $ export PREFIX=/your/location 

Step 7 moves all files to the following default locations:
   /usr/local/bin/fotoxx             binary executable 
   /usr/local/share/fotoxx/          icons, translations ... 
   /usr/local/share/doc/fotoxx/      user guide, README ... 
  
If $PREFIX is defined, files go there instead of /usr/local. 
If $DESTDIR is also defined, files go to $DESTDIR$PREFIX. 
  
For step 7, use "su -c" or "sudo" for root privileges.
If you have set PREFIX to a directory that you own, then 
root privileges are not needed for step 7.

Please review the user guide (help menu) before trying fotoxx.

NOTE TO PACKAGE BUILDERS:
The HTML file userguide-en.html is used for online help windows. 
Please do not split this into a separate documentation package.
The total size including images is about 0.5 MB.