Notes to setting up an environment for running TagSuite under OSX Snow Leopard.


  NB: To build the Mac OSX binaries (.app files) for distribution, you MUST
  use Perl 5.8 as this is the last ActivePerl distribution which includes Tk.
  Installing Tk from CPAN into later versions will work for "local" execution,
  but the ActiveState perlapp builder requires the binaries from their own
  "native" Tk version (ie, not CPAN) in order to build .apps containing code
  for the i386 and ppc. Perlapp will refuse to build if it cannot include the
  ppc code (idiot thing...)

1. Install ActiveState Perl v5.8

2. Start ppm (probably in /usr/local/ActivePerl-5.8/bin) and install:
   * Debug-Simple
   * Image-ExifTool
   * File-List
   * Text-Unidecode
   * DBM-Deep
   * Tk-Hypertext
   * Tk-Splashscreen

3. Start CPAN (sudo /usr/local/ActivePerl-5.10/bin/cpan) then:
   install Image::Resize
   install Cache::FileCache

4. You should now be able to run all programs, so unzip the tagsuite tar
   to someplace; let's call it <tagsuite home> for now.

     cd <tagsuite home>/src
     user$ /usr/local/ActivePerl-5.8/bin/perl tagsuite.pl

5. To build the OSX distro, cd to the src dir and execute:

        bin/osxmk.sh

This will build the binaries and create the tagsuite_x.x.x.osx.zip file in
the directory contianing <tagsuite home>.

If you are not using the perlapp builder, TagSuite has been validated under
ActivePerl 5.10 and would probably run under the standard perl included with
OSX after the required dependencies are loaded. ActivePerl 5.10 does NOT
include Tk, so you will have to install this using CPAN (use force as enough
of the test cases usually fail to prevent installation, as they do under Linux
too!)

The brute force way is just try executing it (from the src directory, of
course) and keep CPAN'ing the missing modules 'til it runs!


							Ron C.  2010-12-15