NAME

Module::Build::Pluggable::XSUtil - Utility for XS

SYNOPSIS

use Module::Build::Pluggable (
    'XSUtil' => {
        cc_warnings => 1,
        ppport      => 1,
        xshelper    => 1,
        'c++'       => 1,
        'c99'       => 1,
    },
);

DESCRIPTION

Module::Build::Pluggable::XSUtil is a utility for XS library.

This library is port of Module::Install::XSUtil

OPTIONS

c++

use Module::Build::Pluggable (
    'XSUtil' => {
        'c++' => 1,
    },
);

This option checks C++ compiler's availability. If it's not available, Build.PL exits by 0.

c99

use Module::Build::Pluggable (
    'XSUtil' => {
        'c99' => 1,
    },
);

This option checks C99 compiler's availability. If it's not available, Build.PL exits by 0.

ppport

use Module::Build::Pluggable (
    'XSUtil' => {
        'ppport' => 1,
    },
);

Generate ppport.h automatically. If you want to specify the path for ppport.h, use following form:

use Module::Build::Pluggable (
    'XSUtil' => {
        'ppport' => 'lib/My/ppport.h',
    },
);

If you want to specify the version of ppport.h, use configure_requires in Module::Build::Pluggable->new.

xshelper

use Module::Build::Pluggable (
    'XSUtil' => {
        'xshelper' => 1,
    },
);

XSUtil generates xshelper.h. If you want to specify the path for xsutil.h, use following form:

use Module::Build::Pluggable (
    'XSUtil' => {
        'xshelper' => 'lib/My/xshelper.h',
    },
);

XSUtil generates ppport.h to same directory(xshelper.h depend to ppport.h).

cc_warnings

use Module::Build::Pluggable (
    'XSUtil' => {
        'cc_warnings' => 1,
    },
);

This option enables warnings flag for compiler.

Options for Build.PL

Under the control of this module, Build.PL accepts -g option, which sets Module::Build's extra_compiler_flags -g (or something like). It will disable optimization and enable some debugging features.

AUTHOR

Goro Fuji, is original author of Module::Install::XSUtil.

Tokuhiro Matsuno <tokuhirom AAJKLFJEF@ GMAIL COM>

SEE ALSO

Module::Install::XSUtil, Module::Build::Pluggable

LICENSE

Copyright (C) Tokuhiro Matsuno

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