[Module-build-checkins] Module-Build/lib/Module Build.pm,1.175,1.176

[Randy W. S. <si...@us...>]

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