Make pod generation more palatable to the existing toolchain
authorPeter Rabbitson <ribasushi@cpan.org>
Thu, 13 Dec 2012 10:37:37 +0000 (11:37 +0100)
committerPeter Rabbitson <ribasushi@cpan.org>
Fri, 14 Dec 2012 17:40:23 +0000 (18:40 +0100)
commita0c96f2461b2a46b242b8432deb0ad88880f73cd
treed9bdf8fa058330eac1309ab605f5897413b718c9
parenta14c7707e77a043858976ec702d3972780edbe6d
Make pod generation more palatable to the existing toolchain

While the installation toolchain seems to understand the concept of
PMLIBDIRS/PMLIBPARENTDIRS rather well, it turns out that both s.c.o.
and metacpan hav great troubles displaying the results. While there
is work underway to fix metacpan, the intermittency of the failures
prompted a rethink of how to handle all of this.

So instead we turn (ab)use of ExtUtils::MakeMaker to 11. The generation
scripts still dump their contents into .generated_pod/ as before.
However afterwards we hook the create_distdir EUMM target and split it
into several targets:

create_distdir : clonedir_generate_files clonedir_post_generate_files fresh_manifest create_distdir_copy_manifested clonedir_cleanup_generated_files

Then we use the pre-existing EUMM install facility to copy the generated
POD directly to lib/, create a manifest and a distdir, and then delete
everything we just copied from lib/, leaving the clone-dir as pristine
as it was before we started.
.gitignore
MANIFEST.SKIP
Makefile.PL
lib/DBIx/Class/Manual/ResultClass.pod.proto [moved from lib/DBIx/Class/Manual/ResultClass.pod with 92% similarity]
maint/Makefile.PL.inc/50_redefine_makefile_flow.pl [new file with mode: 0644]
maint/Makefile.PL.inc/51_autohandle_MANIFEST.pl [new file with mode: 0644]
maint/Makefile.PL.inc/52_autogen_README.pl [moved from maint/Makefile.PL.inc/51_autogen_README.pl with 76% similarity]
maint/Makefile.PL.inc/53_autogen_pod.pl
maint/Makefile.PL.inc/59_autogen_MANIFEST.pl [deleted file]
maint/Makefile.PL.inc/61_inject_dbicadmin_pod.pl [moved from maint/Makefile.PL.inc/52_inject_dbicadmin_pod.pl with 71% similarity]
maint/gen_pod_inherit