maint/Makefile.PL.inc/53_autogen_pod.pl

   1 use File::Path();
   2 use File::Glob();
   3
   4 # leftovers in old checkouts
   5 unlink 'lib/DBIx/Class/Optional/Dependencies.pod'
   6   if -f 'lib/DBIx/Class/Optional/Dependencies.pod';
   7 File::Path::rmtree( File::Glob::bsd_glob('.generated_pod'), { verbose => 0 } )
   8   if -d '.generated_pod';
   9
  10 my $pod_dir = 'maint/.Generated_Pod';
  11 my $ver = Meta->version;
  12
  13 # cleanup the generated pod dir (again - kill leftovers from old checkouts)
  14 if (-d $pod_dir) {
  15   File::Path::rmtree( File::Glob::bsd_glob("$pod_dir/*"), { verbose => 0 } );
  16 }
  17 else {
  18   mkdir $pod_dir or die "Unable to create $pod_dir: $!";
  19 }
  20
  21 # generate the OptDeps pod both in the clone-dir and during the makefile distdir
  22 {
  23   print "Regenerating Optional/Dependencies.pod\n";
  24   require DBIx::Class::Optional::Dependencies;
  25   DBIx::Class::Optional::Dependencies->_gen_pod ($ver, $pod_dir);
  26
  27   postamble <<"EOP";
  28
  29 clonedir_generate_files : dbic_clonedir_gen_optdeps_pod
  30
  31 dbic_clonedir_gen_optdeps_pod :
  32 \t\$(ABSPERLRUN) -Ilib -MDBIx::Class::Optional::Dependencies -e "DBIx::Class::Optional::Dependencies->_gen_pod(qw($ver $pod_dir))"
  33
  34 EOP
  35 }
  36
  37
  38 # generate the inherit pods both in the clone-dir and during the makefile distdir
  39 {
  40   print "Regenerating project documentation to include inherited methods\n";
  41
  42   # if the author doesn't have them, don't fail the initial "perl Makefile.pl" step
  43   do "maint/gen_pod_inherit" or print "\n!!! FAILED: $@\n";
  44
  45   postamble <<"EOP";
  46
  47 clonedir_generate_files : dbic_clonedir_gen_inherit_pods
  48
  49 dbic_clonedir_gen_inherit_pods :
  50 \t\$(ABSPERLRUN) -Ilib maint/gen_pod_inherit
  51
  52 EOP
  53 }
  54
  55
  56 # copy the contents of $pod_dir over to lib/
  57 # (yes, overwriting is fine, though nothing should reside there)
  58 {
  59   postamble <<"EOP";
  60
  61 clonedir_post_generate_files : dbic_clonedir_copy_generated_pod
  62
  63 dbic_clonedir_copy_generated_pod :
  64 \t\$(RM_F) $pod_dir.packlist
  65 \t\$(ABSPERLRUN) -MExtUtils::Install -e 'install([ from_to => {qw($pod_dir lib write $pod_dir.packlist)}, verbose => 0, uninstall_shadows => 0, skip => [] ]);'
  66
  67 EOP
  68 }
  69
  70
  71 # everything that came from $pod_dir, needs to be removed from our lib/
  72 {
  73   postamble <<"EOP";
  74
  75 clonedir_cleanup_generated_files : dbic_clonedir_cleanup_generated_pod_copies
  76
  77 dbic_clonedir_cleanup_generated_pod_copies :
  78 \t\$(ABSPERLRUN) -MExtUtils::Install -e 'uninstall(qw($pod_dir.packlist))'
  79
  80 EOP
  81 }
  82
  83 # keep the Makefile.PL eval happy
  84 1;