The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
Changes 06
MANIFEST 01
META.json 33
META.yml 020
Makefile.PL 24
README 22
lib/Dist/Zilla/Plugin/PodWeaver.pm 619
7 files changed (This is a version diff) 1355
@@ -1,5 +1,11 @@
 Revision history for Dist-Zilla-Plugin-PodWeaver
 
+3.093321  2009-11-28 22:24:14 America/New_York
+          make the ->weaver method public for subclassing
+
+3.093320  2009-11-28 22:10:59 America/New_York
+          pass the zilla into the weaver
+
 3.093170  2009-11-13
           fix a bug that caused config files to sometimes be ignored
           (reported by Jerome Quelin)
@@ -2,6 +2,7 @@ Changes
 LICENSE
 MANIFEST
 META.json
+META.yml
 Makefile.PL
 README
 dist.ini
@@ -6,8 +6,8 @@
       "version" : 1.4,
       "url" : "http://module-build.sourceforge.net/META-spec-v1.4.html"
    },
-   "generated_by" : "Dist::Zilla version 1.093160",
-   "version" : "3.093170",
+   "generated_by" : "Dist::Zilla version 1.093290",
+   "version" : "3.093321",
    "name" : "Dist-Zilla-Plugin-PodWeaver",
    "author" : [
       "Ricardo SIGNES <rjbs@cpan.org>"
@@ -21,6 +21,6 @@
       "List::MoreUtils" : "0",
       "Moose" : "0"
    },
-   "abstract" : "do horrible things to POD, producing better docs"
+   "abstract" : "weave your Pod together from configuration and Dist::Zilla"
 }
 
@@ -0,0 +1,20 @@
+---
+abstract: 'weave your Pod together from configuration and Dist::Zilla'
+author:
+  - 'Ricardo SIGNES <rjbs@cpan.org>'
+generated_by: 'Dist::Zilla version 1.093290'
+license: perl
+meta-spec:
+  url: http://module-build.sourceforge.net/META-spec-v1.4.html
+  version: 1.4
+name: Dist-Zilla-Plugin-PodWeaver
+requires:
+  Dist::Zilla: 1.004
+  List::MoreUtils: 0
+  Moose: 0
+  Moose::Autobox: 0
+  Pod::Elemental::PerlMunger: 0
+  Pod::Weaver: 3.093001
+resources:
+  repository: http://github.com/rjbs/dist-zilla-plugin-podweaver
+version: 3.093321
@@ -2,14 +2,16 @@
 use strict;
 use warnings;
 
+
+
 use ExtUtils::MakeMaker;
 
 WriteMakefile(
   DISTNAME  => 'Dist-Zilla-Plugin-PodWeaver',
   NAME      => 'Dist::Zilla::Plugin::PodWeaver',
   AUTHOR    => "Ricardo\ SIGNES\ \<rjbs\@cpan\.org\>",
-  ABSTRACT  => "do\ horrible\ things\ to\ POD\,\ producing\ better\ docs",
-  VERSION   => '3.093170',
+  ABSTRACT  => "weave\ your\ Pod\ together\ from\ configuration\ and\ Dist\:\:Zilla",
+  VERSION   => '3.093321',
   EXE_FILES => [ qw() ],
   (eval { ExtUtils::MakeMaker->VERSION(6.31) } ? (LICENSE => 'perl') : ()),
   PREREQ_PM    => {
@@ -1,9 +1,9 @@
 
 
 This archive contains the distribution Dist-Zilla-Plugin-PodWeaver, version
-3.093170:
+3.093321:
 
-  do horrible things to POD, producing better docs
+  weave your Pod together from configuration and Dist::Zilla
 
 This software is copyright (c) 2009 by Ricardo SIGNES.
 
@@ -1,8 +1,8 @@
 package Dist::Zilla::Plugin::PodWeaver;
-our $VERSION = '3.093170';
+our $VERSION = '3.093321';
 
 
-# ABSTRACT: do horrible things to POD, producing better docs
+# ABSTRACT: weave your Pod together from configuration and Dist::Zilla
 use Moose;
 use Moose::Autobox;
 use List::MoreUtils qw(any);
@@ -19,7 +19,8 @@ use Pod::Elemental::Selectors -all;
 use Pod::Weaver::Config::Assembler;
 
 
-sub _weaver {
+
+sub weaver {
   my ($self) = @_;
 
   my @files = glob('weaver.*');
@@ -60,7 +61,7 @@ sub munge_file {
 sub munge_perl_string {
   my ($self, $doc, $arg) = @_;
 
-  my $weaver  = $self->_weaver;
+  my $weaver  = $self->weaver;
   my $new_doc = $weaver->weave_document({
     %$arg,
     pod_document => $doc->{pod},
@@ -80,6 +81,7 @@ sub munge_pod {
   my $new_content = $self->munge_perl_string(
     $file->content,
     {
+      zilla    => $self->zilla,
       filename => $file->name,
       version  => $self->zilla->version,
       license  => $self->zilla->license,
@@ -103,17 +105,28 @@ __END__
 
 =head1 NAME
 
-Dist::Zilla::Plugin::PodWeaver - do horrible things to POD, producing better docs
+Dist::Zilla::Plugin::PodWeaver - weave your Pod together from configuration and Dist::Zilla
 
 =head1 VERSION
 
-version 3.093170
+version 3.093321
 
 =head1 DESCRIPTION
 
 PodWeaver is a work in progress, which rips apart your kinda-POD and
 reconstructs it as boring old real POD.
 
+=head1 METHODS
+
+=head2 weaver
+
+This method returns the Pod::Weaver object to be used.  The current
+implementation builds a new weaver on each invocation, because one or two core
+Pod::Weaver plugins cannot be trusted to handle multiple documents per plugin
+instance.  In the future, when that is fixed, this may become an accessor of an
+attribute with a builder.  Until this is clearer, use caution when modifying
+this method in subclasses.
+
 =head1 WARNING
 
 This code is really, really sketchy.  It's crude and brutal and will probably