Installation

WebHDRtools - INSTALL.txt
=========================

There is currently no installer for webhdrtools, and none is planned.
Since the software consists of only a dozen or so files, it should not
be too difficult to get it working on your system.

While the instructions below make use of GNU stow, you can put the 
executables, Perl modules and man pages anywhere you like.  Just make
sure that all path variables are set correctly. More on this further down...

I'm a big fan of GNU stow.  It's small, fast, and flexible. And it keeps
all the files in one place.  You can get the software from its home page 
under http://www.gnu.org/software/stow/, or simply install it with your
package manager if it is available in your distribution's repository.

The following installation instructions assume that you have stow installed
and working, and that the stow root directory is under /usr/local/stow.

stow works by linking the files under a specific directory into the
/usr/local tree.  The first step therefore is to create a directory tree
for webhdrtools.  You'll need to issue most commands as root or through
the sudo command.  Commands run as root have a '#' prompt instead of a 
'$' prompt.

# cd /usr/local/stow
# mkdir webhdrtools-20130602
# cd webhdrtools-20130602
# mkdir -p bin man/man1 share/perl5/webhdrtools

Now extract the tar ball and chdir into the new directory:

$ cd ~/Downloads
$ tar xvzf webhdrtools-20130602.tgz
$ cd webhdrtools-20130602

Copy all files into the /usr/local/stow/webhdrtools-20130602 tree:

# cp bin/*.pl /usr/local/stow/webhdrtools-20130602/bin/
# chmod a+x /usr/local/stow/webhdrtools-20130602/bin/*.pl
# cp man/man1 /usr/local/stow/webhdrtools-20130602/share/man/man1/
# cp lib/*.pm /usr/local/stow/webhdrtools-20130602/share/perl5/webhdrtools/

This gives you the following tree structure:

/usr/local/stow/webhdrtools-20130602/
├── bin
│   ├── webhdr_jpgfixexif.pl
│   ├── webhdr_jpgheatmap.pl
│   ├── webhdr_jpginfo.pl
│   ├── webhdr_jpgsep.pl
│   ├── webhdr_rspavrg.pl
│   └── webhdr_rspplot.pl
└── share
    ├── perl5
    │   └── webhdrtools
    │       ├── Exif.pm
    │       ├── Exposure.pm
    │       ├── ImageLDR.pm
    │       └── RSP.pm
    └── man
        └── man1
            ├── webhdr_jpgfixexif.1
            ├── webhdr_jpgheatmap.1
            ├── webhdr_jpginfo.1
            ├── webhdr_jpgsep.1
            ├── webhdr_rspavrg.1
            └── webhdr_rspplot.1

Now run stow:

# cd /usr/local/stow
# stow webhdrtools-20130602

This symlinks the files under the /usr/local/stow/webhdrtools-20130602 tree
to /usr/local/bin, /usr/local/share/man/man1, and
/usr/local/share/perl5/webhdrtools.

If you wish to uninstall the software later on, simply run

# cd /usr/local/stow
# stow -D webhdrtools-20130602
# rm -Rf webhdrtools-20130602

Finally, make sure that your system knows where to look for files. 
/usr/local/bin should already be in your PATH environmental variable.
Equally, the man command should already look under /usr/local/share/man
for man pages.  If it doesn't, you'll need to work out where this is 
defined for your system.  Try /etc/man_db.conf first.

Chances are, however, that the only adjustment you need to make is
to add the line

export PERL5LIB="$PERL5LIB:/usr/local/share/perl5/webhdrtools"

to your ~/.bashrc file (only for yourself) or to /etc/profile (for all users).