NAME
   Module::Build::Pluggable::PDL - Plugin to Module::Build to build PDL
   projets

VERSION
   version 0.23

SYNOPSIS
       # Build.PL
       use strict;
       use warnings;
       use Module::Build::Pluggable ('PDL');

       my $builder = Module::Build::Pluggable->new(
           dist_name  => 'PDL::My::Module',
           license    => 'perl',
           requires   => { },
       );
       $builder->create_build_script();

DESCRIPTION
   This is a plugin for Module::Build (using Module::Build::Pluggable) that
   will assist in building PDL distributions. Please see the
   Module::Build::Authoring documentation if you are not familiar with it.

   Add Prerequisites
           requires => { 'PDL' => '2.000' },
           build_requires => {
               'PDL'                => '2.000',
               'ExtUtils::CBuilder' => '0.23',
           },

       You can, or course, require your own versions of these modules by
       adding them to "requires =" {}> as usual.

   Process ".pd" files
       The "lib" directory of your distribution will be searched for ".pd"
       files and, immediately prior to the build phase, these will be
       processed by "PDL::PP" into ".xs" and ".pm". files as required to
       continue the build process. These will then be processed by
       "Ext::CBuilder" as normal. These files are also added to the list of
       file to be cleaned up.

       In addition, an entry will be made into "provides" for the ".pm"
       file of the "META.json/yml" files. This will assist PAUSE,
       search.cpan.org and metacpan.org in properly indexing the
       distribution and

   Generate ".pod" file from the ".pd"
       When building the distribution ("./Build dist" or "./Build
       distdir"), any ".pd" file found in the "lib" directory will
       converted into ".pod" files. This produces a standalone version of
       the documentation which can be viewed on search.cpan.org,
       metacpan.org, etc. When these sites attempt to display the pod in
       the ".pd" files directly, there is often formatting and processing
       issues.

       This is accomplished by first processing the files with "PDL::PP"
       and then "perldoc -u".

   Add Include Dirs
           include_dirs => PDL::Core::Dev::whereami_any() . '/Core';

       The "PDL/Core" directory is added to the "include_dirs" flag.

   Add Extra Linker Flags
           extra_linker_flags =>  $PDL::Config{MALLOCDBG}->{libs}
             if $PDL::Config{MALLOCDBG}->{libs};

       If needed, the MALLOCDBG libs will be added to the
       "extra_linker_flags".

SEE ALSO
   This is essentially a rewrite of David Mertens' Module::Build::PDL to
   use Module::Build::Pluggable. The conversion to Module::Build::Pluggable
   fixes multiple inheritance issues with subclassing Module::Build. In
   particular, I needed to be able use the
   Module::Build::Pluggable::Fortran in my PDL projects.

   Thank you David++ for Module::Build::PDL.

   Of course, all of this just tweaks the Module::Build setup.

AUTHOR
   Mark Grimes, <[email protected]>

COPYRIGHT AND LICENSE
   This software is copyright (c) 2013 by Mark Grimes, <[email protected]>.

   This is free software; you can redistribute it and/or modify it under
   the same terms as the Perl 5 programming language system itself.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.