Browse files

Document why POE doesn't use Dist::Zilla, so I have something to refe…

…rence when someone else suggests that it would be totally rad.
  • Loading branch information...
1 parent a67aa0e commit 8c2ab4868bf60f362f6da48073c247d29432eb25 @rcaputo committed May 1, 2011
Showing with 29 additions and 7 deletions.
  1. +27 −7 Makefile.PL
  2. +2 −0 docs/projects.otl
34 Makefile.PL
@@ -1,6 +1,33 @@
# rocco // vim: ts=2 sw=2 expandtab
+# Note to Dist::Zilla fans - This is NOT a standard Makefile.PL by ANY
+# stretch of the imagination. If you want to port it to Dist::Zilla,
+# you'll have a number of challenges ahead of you:
+# - Custom Makefile.PL code.
+# - Dynamic dependencies varying by $^O (see mylib/
+# and by $] (see IPv6 dependencies below).
+# - Dynamically generated tests. See PREOP in WriteMakefile(), below.
+# - Custom Makefile target "coverage". See MY::postamble, below.
+# I have tried using Dist::Zilla::Plugin::Makemaker::Awesome, but the
+# need to break encapsulation in order to make it work turned me away.
+# People who love Dist::Zilla are welcome to replace this perfectly
+# fine Makefile.PL, but you should be aware of some requirements
+# before I'll accept the change:
+# - Reproduce or improve upon all current Makefile.PL features. It's
+# all there for one reason or another. The reasons are still largely
+# pertinent. When in doubt, ask.
+# - Limit your changes to replacing Makefile.PL and $VERSION. I'd
+# rather be able to rely on error message line numbers than to add
+# more moving parts to my build and test workflows.
use strict;
use ExtUtils::MakeMaker;
@@ -154,13 +181,6 @@ check_for_modules(
sub MY::postamble {
return <<EOF;
-ppmdist: pm_to_blib
-\cI\$(TAR) --exclude '*/man[13]*' -cvf \\
-\cI\cI\$(DISTVNAME)-win32ppd.tar blib
-\cI\$(COMPRESS) \$(DISTVNAME)-win32ppd.tar
-ppddist: ppmdist
coverage: Makefile
\cI$^X mylib/coverage.perl
2 docs/projects.otl
@@ -89,6 +89,8 @@ Abstract
Eliminating deadlock detection means we can't fire SIGIDLE at appropriate times.
[_] % Determine an implementation strategy that doesn't suck.
Document it here, and make it part of the tasks for this item.
+ [_] % Convert the build process to Dist::Zilla
+ See notes at the start of Makefile.PL.

0 comments on commit 8c2ab48

Please sign in to comment.