Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Module::Install::MakefUser3Contributed Perl DocumeModule::Install::Makefile(3)

NAME
       Module::Install::MakeMaker - Extension Rules for	ExtUtils::MakeMaker

SYNOPSIS
       In your Makefile.PL:

	   use inc::Module::Install;
	   WriteMakefile();

DESCRIPTION
       This module is a	wrapper	around ExtUtils::MakeMaker.  It	exports	two
       functions: "prompt" (an alias for "ExtUtils::MakeMaker::prompt")	and
       "WriteMakefile".

       The "WriteMakefile" function will pass on keyword/value pair functions
       to "ExtUtils::MakeMaker::WriteMakefile".	The required parameters	"NAME"
       and "VERSION" (or "VERSION_FROM") are not necessary if it can find them
       unambiguously in	your code.

CONFIGURATION OPTIONS
       This module also	adds some Configuration	parameters of its own:

   NAME
       The NAME	parameter is required by ExtUtils::MakeMaker. If you have a
       single module in	your distribution, or if the module name indicated by
       the current directory exists under lib/,	this module will use the
       guessed package name as the default.

       If this module can't find a default for "NAME" it will ask you to
       specify it manually.

   VERSION
       ExtUtils::MakeMaker requires either the "VERSION" or "VERSION_FROM"
       parameter.  If this module can guess the	package's "NAME", it will
       attempt to parse	the "VERSION" from it.

       If this module can't find a default for "VERSION" it will ask you to
       specify it manually.

MAKE TARGETS
       ExtUtils::MakeMaker provides you	with many useful "make"	targets. A
       "make" target is	the word you specify after "make", like	"test" for
       "make test". Some of the	more useful targets are:

       o   all

	   This	is the default target. When you	type "make" it is the same as
	   entering "make all".	This target builds all of your code and	stages
	   it in the "blib" directory.

       o   test

	   Run your distribution's test	suite.

       o   install

	   Copy	the contents of	the "blib" directory into the appropriate
	   directories in your Perl installation.

       o   dist

	   Create a distribution tarball, ready	for uploading to CPAN or
	   sharing with	a friend.

       o   clean distclean purge

	   Remove the files created by "perl Makefile.PL" and "make".

       o   help

	   Same	as typing "perldoc ExtUtils::MakeMaker".

       This module modifies the	behaviour of some of these targets, depending
       on your requirements, and also adds the following targets to your
       Makefile:

       o   cpurge

	   Just	like purge, except that	it also	deletes	the files originally
	   added by this module	itself.

       o   chelp

	   Short cut for typing	"perldoc Module::Install".

       o   distsign

	   Short cut for typing	"cpansign -s", for Module::Signature users to
	   sign	the distribution before	release.

SEE ALSO
       Module::Install,	CPAN::MakeMaker, CPAN::MakeMaker::Philosophy

AUTHORS
       Adam Kennedy <adamk@cpan.org>

       Audrey Tang <autrijus@autrijus.org>

       Brian Ingerson <INGY@cpan.org>

COPYRIGHT
       Some parts copyright 2008 - 2012	Adam Kennedy.

       Copyright 2002, 2003, 2004 Audrey Tang and Brian	Ingerson.

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

perl v5.32.1			  2017-04-04	  Module::Install::Makefile(3)

NAME | SYNOPSIS | DESCRIPTION | CONFIGURATION OPTIONS | MAKE TARGETS | SEE ALSO | AUTHORS | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Module::Install::Makefile&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help