$DY_ROOT/contrib/src/perl

DayPerl 1.4
-----------

DayPerl is a wrapper which provides access to Daylight Toolkits from
perl language programs using a perl extension built using the header files
dt_ function definitions. 

Perl5 (Perl 5.6 - 5.8) is required.
The wrapper can be installed on solaris, linux, irix and macosx. 

Compiled DayPerl files can be downloaded from http://www.daylight.com/download/contrib/dayperl.html.


Contents of the dayperl-491.tar.gz file:
________________________________________

   _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


Building DayPerl:  
________________

1. Verify that DY_ROOT is defined to point to a Daylight 4.91 distribution. 

2. If necessary build 'contrib' under the the Daylight distribution before 
attempting to build the wrapper by typing `make install` in $DY_ROOY/contrib/src.

3. If you are using gcc rather than the SGI/Solaris compiler, edit the parse_perlv.pl file by
uncommenting the appropriate gcc compiler option and commenting out the SGI/Solaris compiler option.

4. To create a makefile_include specific to the platform and perl version being used
 and install the wrapper, type the following:

   perl parse_perlv.pl  
   make
   make test
   su - root
   make install

*Note for SGI*
If you are using SGI and get errors during 'make test' remake DayPerl
using static libraries (see below) and then proceed to the 'make install' step.

   make static
   make test_static

To test DayPerl:
_______________
Examples can be downlowded from http://www.daylight.com/download/contrib/dayperl.html.

   cd dayperl_examples
   perl cansmi.pl
   OCC

   Output should be: CCO OCC

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

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