[Module-build-checkins] Module-Build/lib/Module Build.pm,1.175,1.176
Status: Beta
Brought to you by:
kwilliams
|
From: Randy W. S. <si...@us...> - 2005-03-31 04:49:14
|
Update of /cvsroot/module-build/Module-Build/lib/Module In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv28318/lib/Module Modified Files: Build.pm Log Message: Read default commandline options from '$ENV{HOME}/.modulebuildrc' if it exists. Index: Build.pm =================================================================== RCS file: /cvsroot/module-build/Module-Build/lib/Module/Build.pm,v retrieving revision 1.175 retrieving revision 1.176 diff -u -d -r1.175 -r1.176 --- Build.pm 24 Mar 2005 00:06:18 -0000 1.175 +++ Build.pm 31 Mar 2005 04:48:15 -0000 1.176 @@ -489,6 +489,32 @@ =back +=head2 Default Commandline Options (F<.modulebuildrc>) + +When Module::Build starts up it will look for a file, +C<'$ENV{HOME}/.modulebuildrc'>. If the file exists it will use the +options specified there as defaults, as if they were typed on the +commandline. The defaults can be overridden by specifying new values +on the commandline. + +The action name must come at the beginning of the line followed by any +amount of whitespace and then the options. Options are given the same +as they would be on the commandline. They can be seperated by any +amount of whitespace, including newlines as long there is a space at +the beginning of the continued line. Any thing following a hash mark +is considered a comment, and is stripped before parsing. + +Besides the regular actions, there are two special options. You can +use the action name '*' (asterisk) for any global options that should +be applied to all actions. And there is the 'Build_PL' action which +specifies options to be applied when you invoke C<perl Build.PL>. + + * verbose=1 # global options + diff flags=-u + install install_base=/home/ken + --install_path html=/home/ken/docs/html + + =head2 How Installation Paths are Determined When you invoke Module::Build's C<build> action, it needs to figure |