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-batch        convert camera RAW files to TIFF
   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 
set PREFIX to a directory that you own, then root privileges 
are not needed, and step 7 becomes simply "make install".

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 < 2 megabytes.

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

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. If you are updating
to Fotoxx 10.0 or later after using an earlier version, and if
you have been using tags, then you must convert the tags data in 
order not to lose them.

For details see 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:  Tools > 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:  Tools > Convert Tags
(2)  Do the function:  Tools > Rebuild Tags Index

If you have problems, write to me at: kornelix2@googlemail.com
Nothing is erased, so you can continue to use the previous
version of fotoxx until the problem is fixed.

