[svn:Module-Build] r12878 - in Module-Build/trunk: . lib/Module/Build

Author: dagolden
Date: Sun Jun 21 20:24:01 2009
New Revision: 12878

Modified:
   Module-Build/trunk/Changes
   Module-Build/trunk/lib/Module/Build/Authoring.pod

Log:
Added docs about subclass chdir (RT#46919)

Modified: Module-Build/trunk/Changes
==============================================================================
--- Module-Build/trunk/Changes	(original)
+++ Module-Build/trunk/Changes	Sun Jun 21 20:24:01 2009
@@ -20,6 +20,8 @@
  - On MSWin32, bumped File::Spec prereq to 3.30 for a variety of fixes
  - Add support for VMS in Unix compatibility mode (RT#42157)
  - Added a can_action($name) method (RT#45172)
+ - Documented that subclass methods should not permanently change
+   current directory (RT#46919)
 
 0.33_02 - Mon Jun 15 12:23:55 EDT 2009
 

Modified: Module-Build/trunk/lib/Module/Build/Authoring.pod
==============================================================================
--- Module-Build/trunk/lib/Module/Build/Authoring.pod	(original)
+++ Module-Build/trunk/lib/Module/Build/Authoring.pod	Sun Jun 21 20:24:01 2009
@@ -102,7 +102,10 @@
 C<create_build_script()> method will ensure that the current value of
 C<@INC> (including the C</nonstandard/library/path>) is propagated to
 the Build script, so that My::Builder can be found when running build
-actions.
+actions.  If you find that you need to C<chdir> into a different directories
+in your subclass methods or actions, be sure to always return to the original
+directory (available via the C<base_dir()> method before returning control
+to the parent class.  This is important to avoid data serialization problems.
 
 For very small additions, Module::Build provides a C<subclass()>
 method that lets you subclass Module::Build more conveniently, without