[Module-build-general] [PATCH] document up_to_date

[Dave R. <au...@ur...>]

This method is obviously useful for people writing customized build
processes, and should be documented, because otherwise everyone will write
their own ;)


-dave

/*=======================
House Absolute Consulting
www.houseabsolute.com
=======================*/

Index: Build.pm
===================================================================
RCS file: /cvsroot/module-build/Module-Build/lib/Module/Build.pm,v
retrieving revision 1.89
diff -u -u -r1.89 Build.pm
--- Build.pm	24 Jul 2003 19:22:36 -0000	1.89
+++ Build.pm	25 Jul 2003 04:14:03 -0000
@@ -766,6 +790,18 @@
 because the C<Build> script will C<chdir()> into this directory as
 soon as it begins execution.

+=item up_to_date($source_file, $derived_file)
+
+=item up_to_date(\@source_files, \@derived_files)
+
+This method can be used to compare a set of source files to a set of
+derived files.  If any of the source files are newer than any of the
+derived files, it returns false.  Additionally, if any of the derived
+files do not exist, it returns false.  Otherwise it returns true.
+
+The arguments may be either a scalar or an array reference of file
+names.
+
 =back

 =head1 ACTIONS