Module::Install::XSUtil - Utility functions for XS modules
This document describes Module::Install::XSUtil version 0.09.
# in Makefile.PL use inc::Module::Install; # This is a special version of requires(). # If XS::SomeFeature provides header files, # this will add its include paths into INC requies_xs 'XS::SomeFeature'; # No need to include ppport.h. It's created here. use_ppport 3.19; # Enables C compiler warnings, e.g. -Wall -Wextra cc_warnings; # Sets some C pre-processor macros. cc_define q{-DUSE_SOME_FEATURE=42}; # Sets paths for header files cc_include_paths 'include'; # all the header files are in include/ # Sets paths for source files cc_src_paths 'src'; # all the XS and C source files are in src/ # Installs header files install_headers; # all the header files in @cc_include_paths
Module::Install::XSUtil provides a set of utilities to setup distributions which include XS module.
See XS::MRO::Compat and Method::Cumulative for example.
Does requires() and setup include paths and libraries for what $module provides.
requires()
Create ppport.h using Devel::PPPort::WriteFile().
Devel::PPPort::WriteFile()
This command calls configure_requires 'Devel::PPPort' => $version and adds -DUSE_PPPORT to ccflags.
configure_requires 'Devel::PPPort' => $version
-DUSE_PPPORT
Enables C compiler warnings.
Sets cpp macros as compiler options.
cpp
Sets source file directories which include *.xs or *.c.
Sets include paths for a C compiler.
Declares providing header files.
If @header_files are omitted, all the header files in include paths will be installed.
Low level API.
Perl 5.5.3 or later.
No bugs have been reported.
Please report any bugs or feature requests to the author.
Goro Fuji (gfx) <gfuji(at)cpan.org>.
ExtUtils::Depends.
Module::Install.
Module::Install::CheckLib.
Devel::CheckLib.
ExtUtils::MakeMaker.
Copyright (c) 2009, Goro Fuji (gfx). Some rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Module::Install::XSUtil, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Module::Install::XSUtil
CPAN shell
perl -MCPAN -e shell install Module::Install::XSUtil
For more information on module installation, please visit the detailed CPAN module installation guide.