$DY_ROOT/contrib/src/perl

DayPerl 1.4
===========

DayPerl is a wrapper which provides access to Daylight Toolkit from
perl language programs.  By running "parse_perlv" and then Makefile, a perl extension
is built using the Daylight Toolkit header files for dt_ function
definitions.

Perl5  (Perl 5.6 - 5.8) must be installed before DayPerl 1.4 is installed.

DayPerl was created by Alex Wong while at Chiron Corp.  Thanks Alex!

Compiled DayPerl files can be downloaded from http://www.daylight.com/support/contrib/dayperl/ for solaris, linux, irix and macosx.

To build DayPerl  
----------------
Run the parse_perlv.pl program. 
perl parse_perlv.pl  
make

The program will make a makefile_include specific to the platform and perl version that the script
is running on.
Make the DayPerl module and install it.

make (using dynamic libs)
or
make static (using static libs)

make test (using dynamic libs)
or
make test_static (using static libs)

su - root 
make install

*Note for SGI*
If you are using SGI and get errors during 'make test' remake DayPerl
using static libraries.

You must become the owner of perl to install the package.

Contents of this directory:
===========================

   _readme - this readme file
   dayperl.html - installation and help
   parse_perlv.pl - A script which builds the makefile_include
   Makefile
   Dayperl.xs - XS source file which describes the extension interface.
   typemap - Maps C types to perl types
   DayPerl.pm - DayPerl module source code.
   test.pl - test program

Examples can be found in the $DY_ROOT/contrib/src/perl/examples directory. 

New in 1.4:
-----------
  * Support for Perl 5.8
  * Support for Mac OSX

Known Bugs:
-----------
  * None.

See Also:
---------
  - The Daylight website FAQ pages for more DayPerl help.

-------------------------------------------------------------------------------
:parse_perlv.pl : A script which builds the makefile_include to be used to make DayPerl
:Makefile:Makefile for DayPerl
:Dayperl.xs:XS source file which describes the extension interface.
:typemap:Maps C types to perl types
:DayPerl.pm:DayPerl module source code.
:dayperl.html:installation and help