Created on: Thu 27 Jul 2006 09:43:26 PM
Last saved: Mon 09 Jan 2012 09:44:26 AM 

=================================================================
                            Overview
=================================================================
This directory contains supplemental build information to
configure and install PDL on a windows system with the cygwin
toolset (http://www.cygwin.com).

The cygwin library provides the missing unix/posix functionality
to allow unix applications to be more easily ported to windows.
A windows PC with cygwin looks like different flavor of unix.
Since cygwin looks like a unix, [almost] all of the standard
perl functionality works and PDL can build pretty much as it
does on other unix systems.

See the INSTALL file for instructions on building and
installing PDL on cygwin and for notes on building the external
dependencies.

See the PDL/win32 subdirectory for instructions on building a
native windows PDL.



=================================================================
                             WORKING
=================================================================
The cygwin PDL includes all the base PDL functionality          
including bad values support (if configured) as well as the     
following modules which depend on the presence of various       
external dependencies:                                          

 PDL::FFTW
  (Builds if FFTW version 2 has been hand built and installed,
   cygwin Setup.exe only provides FFTW version 3).

 PDL::Graphics::PGPLOT
  (Builds if the FORTRAN pgplot library has been hand built
   and installed, and if the *Perl* PGPLOT module is installed
   and FORTRAN)

 PDL::Graphics::TriD
  (Builds automatically if you have X11 and OpenGL + FreeGLUT
   installed).

 PDL::GSL::*
 PDL::GSLSF::*
  (Builds if GSL is installed via cygwin Setup.exe)

 PDL::IO::GD
  (Builds if the gd lib is installed via cygwin Setup.exe)

 PDL::GIS::Proj
 PDL::Transform::Proj4
  (Builds if the PROJ4 lib is installed via cygwin Setup.exe)

 PDL::Minuit
  (Builds if ExtUtils::F77 has been installed and FORTRAN)

 PDL::Slatec
  (Builds if ExtUtils::F77 has been installed.
   Needs a FORTRAN compiler.)

 PDL::IO::Browser
  (Build may pass if enabled, disabled by default for all OSes)
 
 pdl2
  (Installed by default.  To use the new features, you
   will need to install Devel::REPL and one of either
   Term::ReadLine::Perl or Term::ReadLine::Gnu.  The Gnu
   flavor is currently recommended for cygwin.)

and also

 PDL::ParallelCPU
  (Parallel pthread support will build and install by default
   since the cygwin DLL includes POSIX threads)



=================================================================
               GRAPHICS (non-CORE DISTRIBUTION)
=================================================================
These graphics modules are known to work but are not in the
core PDL distribution.  You'll need to install from CPAN
separately:

 PDL::Graphics::Gnuplot  Needs the gnuplot executable
  
 PDL::Graphics::Prima    Install Prima and PDL::Graphics::Prima
                         via the cpan shells cpan, cpanm...
			 Give interactive plotting support and
			 a full GUI toolkit that can be used to
			 implement graphical perl/PDL/Prima apps.



=================================================================
                           NOT WORKING
=================================================================
These modules with external dependencies are not yet available
for cygwin:

 PDL::Graphics::IIS
  
 PDL::Graphics::PLplot  (PLplot and the PDL module support
                         is not working out of the box.  If
			 you get plplot built and installed
			 for cygwin with PDL, let us know!)

 PDL::IO::HDF           (HDF4 has not been ported to cygwin
                         but HDF5 is available via the cygwin
			 setup program.  PDL::IO::HDF5 fails
			 to build due to unix/linux specific
			 library detection for libhdf5)
  
 PDL::IO::NDF           (NDF has not been ported to cygwin)