/ 
Dist-Zilla-Plugin-ModuleBuild-OptionalXS-0.01
River stage zero No dependents
/ Dist::Zilla::Plugin::ModuleBuild::OptionalXS

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.