---------------------------------------------------
Citrus Perl Releases
---------------------------------------------------

Citrus Perl is a binary distribution of Perl with
pre-built modules for wxPerl built against both the
wxWidgets 2.8.x stable branch and the latest 2.9.x 
development branch. The current release version of 
Citrus Perl is built with Perl 5.16.1.

It is targetted at users wishing to develop
wxPerl GUI applications or Tk users wishing to 
migrate.

Other modules provided include:

DBD::Pg
DBD::mysql
DBD::SQLite
Tk
GD

The main distributions are provided as archives 
named in the format

citrusperl-standard-51601-linux-x86-016.tar.gz

where:

standard = The flavour of Citrus Perl. Available
           flavours are
           
           standard  - the normal distribution for
                       Windows, Linux RHEL 5 and 
                       above ( all recent Linux 
                       distributions ), OSX - Intel
                       Macs running 10.6 Snow Leopard
                       or greater.
                       
           el3       - a  distribution that will run
                       on RHEL 3 and 4
                       
           ubuntults - a  Linux distribution that uses
                       the latest libraries and features
                       available on recent Linux distros.
                       Notably this includes wxWebView.
                       Built on Ubuntu LTS (currently
                       12.04) this distribution can be 
                       used on other recent releases such 
                       as Fedora 17
                       
           universal - a distribution for OSX 10.5 
                       both ppc and Intel Macs

51601    = the version of Perl (5.16.1 in this case)

linux    = The operating system (linux/osx/msw)

x86      = Architecture. Linux and Windows archives
           are given the architectures x86 (32 bit)
           and x64 (64 bit x84_64/amd64). For OSX 
           architectures can be u32 (ppc & i386
           universal binaries), i32 (Intel only 
           32 bit i386 binaries) or i64 (Intel only 
           64 bit x86_64 binaries).

017      = the Citrus release number.


-----------------------------------------------------
INSTALLATION
-----------------------------------------------------

To install Citrus Perl, extract the archive to the
desired location an then to complete the installation
run the Citrus Perl Utilities

../perl/bin/citrusutils

on Linux and Windows.

For MacOSX open the application

../perl/bin/Citrus Perl Utilites

in Finder.

The Citrus Perl Utilities application includes help
that gives further information on Citrus Perl usage.
By running the Utilities application the first time
you relocate the Perl distribution so you must do
this.

You may change the name of the top level folder from
'perl' if you wish but you must do so before Citrus
Perl has been relocated. (before you run the utilties
application)

-----------------------------------------------------
LINUX INSTALLATION NOTES
-----------------------------------------------------

After installation the wxper_demo.pl application may
have a segmentation fault on startup. This is because
of missing runtime libraries on your system, normally
for freeglut and with unbuntults flavours for webkit.

For freeglut

    yum install freeglut
 or
    apt-get install freeglut3
    
For ubuntults flavour with wxWebView

    yum install webkitgtk
 or
    apt-get install libwebkitgtk-1.0