extutils::helpers(3) [mojave man page]

ExtUtils::Helpers(3)					User Contributed Perl Documentation				      ExtUtils::Helpers(3)

NAME

       ExtUtils::Helpers - Various portability utilities for module builders

VERSION

       version 0.021

SYNOPSIS

	use ExtUtils::Helpers qw/build_script make_executable split_like_shell/;

	unshift @ARGV, split_like_shell($ENV{PROGRAM_OPTS});
	write_script_to('Build');
	make_executable('Build');

DESCRIPTION

       This module provides various portable helper functions for module building modules.

FUNCTIONS

   build_script()
       This function returns the appropriate name for the Build script on the local platform.

   make_executable($filename)
       This makes a perl script executable.

   split_like_shell($string)
       This function splits a string the same way as the local platform does.

   detildefy($path)
       This function substitutes a tilde at the start of a path with the users homedir in an appropriate manner.

   man1_pagename($filename)
       Returns the man page filename for a script.

   man3_pagename($filename, $basedir)
       Returns the man page filename for a Perl library.

   manify($input_filename, $output_file, $section, $opts)
       Create a manpage for the script in $input_filename as $output_file in section $section

ACKNOWLEDGEMENTS

       Olivier Mengue and Christian Walde made "make_executable" work on Windows.

AUTHORS

       o   Ken Williams <kwilliams@cpan.org>

       o   Leon Timmermans <leont@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2004 by Ken Williams, Leon Timmermans.

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

perl v5.18.2							    2013-05-06						      ExtUtils::Helpers(3)

Module::Build::Tiny(3pm)				User Contributed Perl Documentation				  Module::Build::Tiny(3pm)

NAME

       Module::Build::Tiny - A tiny replacement for Module::Build

VERSION

       version 0.034

SYNOPSIS

	use Module::Build::Tiny;
	Build_PL();

DESCRIPTION

       Many Perl distributions use a Build.PL file instead of a Makefile.PL file to drive distribution configuration, build, test and
       installation.  Traditionally, Build.PL uses Module::Build as the underlying build system.  This module provides a simple, lightweight,
       drop-in replacement.

       Whereas Module::Build has over 6,700 lines of code; this module has less than 120, yet supports the features needed by most distributions.

   Supported
       o   Pure Perl distributions

       o   Building XS or C

       o   Recursive test files

       o   MYMETA

       o   Man page generation

       o   Generated code from PL files

   Not Supported
       o   Dynamic prerequisites

       o   HTML documentation generation

       o   Extending Module::Build::Tiny

       o   Module sharedirs

   Directory structure
       Your .pm and .pod files must be in lib/.  Any executables must be in script/.  Test files must be in t/. Dist sharedirs must be in share/.

USAGE

       These all work pretty much like their Module::Build equivalents.

   perl Build.PL
   Build [ build ]
   Build test
   Build install
       This supports the following options:

       o   verbose

       o   install_base

       o   installdirs

       o   prefix

       o   install_path

       o   destdir

       o   uninst

       o   config

       o   pure-perl

       o   create_packlist

AUTHORING

       This module doesn't support authoring. To develop modules using Module::Build::Tiny, usage of Dist::Zilla::Plugin::ModuleBuildTiny or
       App::ModuleBuildTiny is recommended.

CONFIG FILE AND ENVIRONMENT

       Options can be provided in the "PERL_MB_OPT" environment variable the same way they can with Module::Build. This should be done during the
       configuration stage.

   Incompatibilities
       o   Argument parsing

	   Module::Build has an extremely permissive way of argument handling, Module::Build::Tiny only supports a (sane) subset of that. In
	   particular, "./Build destdir=/foo" does not work, you will need to pass it as "./Build --destdir=/foo".

       o   .modulebuildrc

	   Module::Build::Tiny does not support .modulebuildrc files. In particular, this means that versions of local::lib older than 1.006008
	   may break. Upgrading it resolves this issue.

SEE ALSO

       Module::Build

AUTHORS

       o   Leon Timmermans <leont@cpan.org>

       o   David Golden <dagolden@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Leon Timmermans, David Golden.

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

perl v5.18.2							    2014-01-21						  Module::Build::Tiny(3pm)