@@ -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