Andrew Rodland > Dist-Zilla-Plugin-ModuleBuild-OptionalXS-0.01 > Dist::Zilla::Plugin::ModuleBuild::OptionalXS

Download:
Dist-Zilla-Plugin-ModuleBuild-OptionalXS-0.01.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.01   Source  

NAME ^

Dist::Zilla::Plugin::ModuleBuild::OptionalXS - Build a module that has an XS component that only optionally needs to be built.

VERSION ^

version 0.01

SYNOPSIS ^

In your dist.ini:

    [ModuleBuild::OptionalXS]

DESCRIPTION ^

This module is a Dist::Zilla plugin for building modules that have an XS component, but that are able to build and function even if there is no C compiler to build the XS component.

BUILD.PL ARGUMENTS ^

Like Dist::Zilla::Plugin::ModuleBuild::XSorPP this module supports --pp and --xs options to override the C compiler detection. With --pp, the XS component won't be built, even if a C compiler is available. With --xs, Module::Build will try to build the XS component even if it thinks that a C compiler isn't available (this will almost definitely fail).

USING WITH HEADERS AND PPPORT ^

When using this plugin, c_source => 'c' will be added to your Module::Build options. Any include files that you want to use from your .xs files can be placed in the c directory. If you want to include ppport.h, add

    [PPPort]
    filename = c/ppport.h

to your dist.ini.

AUTHOR ^

Andrew Rodland <arodland@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2011 by Andrew Rodland.

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

syntax highlighting: