r47396 - in /branches/upstream/libpod-eventual-perl/current: Changes LICENSE MANIFEST META.json Makefile.PL README eg/dump.pl lib/Pod/Eventual.pm lib/Pod/Eventual/Simple.pm t/release-pod-coverage.t t/release-pod-syntax.t
jawnsy-guest at users.alioth.debian.org
jawnsy-guest at users.alioth.debian.org
Wed Nov 18 01:50:37 UTC 2009
Author: jawnsy-guest
Date: Wed Nov 18 01:50:32 2009
New Revision: 47396
URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=47396
Log:
[svn-upgrade] Integrating new upstream version, libpod-eventual-perl (0.093170)
Added:
branches/upstream/libpod-eventual-perl/current/t/release-pod-coverage.t
branches/upstream/libpod-eventual-perl/current/t/release-pod-syntax.t
Modified:
branches/upstream/libpod-eventual-perl/current/Changes
branches/upstream/libpod-eventual-perl/current/LICENSE
branches/upstream/libpod-eventual-perl/current/MANIFEST
branches/upstream/libpod-eventual-perl/current/META.json
branches/upstream/libpod-eventual-perl/current/Makefile.PL
branches/upstream/libpod-eventual-perl/current/README
branches/upstream/libpod-eventual-perl/current/eg/dump.pl
branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual.pm
branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual/Simple.pm
Modified: branches/upstream/libpod-eventual-perl/current/Changes
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/Changes?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/Changes (original)
+++ branches/upstream/libpod-eventual-perl/current/Changes Wed Nov 18 01:50:32 2009
@@ -1,7 +1,12 @@
Revision history for Pod-Eventual
+
+
+0.093170 2009-11-13
+ document *all four* event types
0.091480 2009-05-28 13:50:52 UTC
nonpod events are now monolithic for each nonpod segment
+ we call the correct method for the last event in input
0.091470 2009-05-27
eliminate verbatim events; verbatim detection is left to a higher
Modified: branches/upstream/libpod-eventual-perl/current/LICENSE
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/LICENSE?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/LICENSE (original)
+++ branches/upstream/libpod-eventual-perl/current/LICENSE Wed Nov 18 01:50:32 2009
@@ -1,9 +1,9 @@
This software is copyright (c) 2009 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
-the same terms as perl itself.
-
-Terms of Perl itself
+the same terms as the Perl 5 programming language system itself.
+
+Terms of the Perl programming language system itself
a) the GNU General Public License as published by the Free
Software Foundation; either version 1, or (at your option) any
Modified: branches/upstream/libpod-eventual-perl/current/MANIFEST
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/MANIFEST?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/MANIFEST (original)
+++ branches/upstream/libpod-eventual-perl/current/MANIFEST Wed Nov 18 01:50:32 2009
@@ -15,4 +15,6 @@
t/basic.t
t/blanks.t
t/non-pod.t
-t/nonempty.t
+t/nonempty.t
+t/release-pod-coverage.t
+t/release-pod-syntax.t
Modified: branches/upstream/libpod-eventual-perl/current/META.json
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/META.json?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/META.json (original)
+++ branches/upstream/libpod-eventual-perl/current/META.json Wed Nov 18 01:50:32 2009
@@ -1,13 +1,13 @@
{
"resources" : {
- "repository" : "http://github.com/rjbs/pod-eventual/tree"
+ "repository" : "http://github.com/rjbs/pod-eventual"
},
"meta-spec" : {
"version" : 1.4,
"url" : "http://module-build.sourceforge.net/META-spec-v1.4.html"
},
- "generated_by" : "Dist::Zilla::Plugin::MetaJSON version 1.091480",
- "version" : "0.091480",
+ "generated_by" : "Dist::Zilla version 1.093160",
+ "version" : "0.093170",
"name" : "Pod-Eventual",
"author" : [
"Ricardo SIGNES <rjbs at cpan.org>"
@@ -19,3 +19,4 @@
},
"abstract" : "read a POD document as a series of trivial events"
}
+
Modified: branches/upstream/libpod-eventual-perl/current/Makefile.PL
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/Makefile.PL?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/Makefile.PL (original)
+++ branches/upstream/libpod-eventual-perl/current/Makefile.PL Wed Nov 18 01:50:32 2009
@@ -7,13 +7,15 @@
WriteMakefile(
DISTNAME => 'Pod-Eventual',
NAME => 'Pod::Eventual',
- AUTHOR => 'Ricardo\ SIGNES\ \<rjbs\@cpan\.org\>',
- ABSTRACT => 'read\ a\ POD\ document\ as\ a\ series\ of\ trivial\ events',
- VERSION => '0.091480',
+ AUTHOR => "Ricardo\ SIGNES\ \<rjbs\@cpan\.org\>",
+ ABSTRACT => "read\ a\ POD\ document\ as\ a\ series\ of\ trivial\ events",
+ VERSION => '0.093170',
EXE_FILES => [ qw() ],
- (eval { ExtUtils::MakeMaker->VERSION(6.21) } ? (LICENSE => 'perl') : ()),
+ (eval { ExtUtils::MakeMaker->VERSION(6.31) } ? (LICENSE => 'perl') : ()),
PREREQ_PM => {
"Test::Deep" => '0',
"Mixin::Linewise::Readers" => '0.001',
},
+ test => {TESTS => 't/*.t'}
);
+
Modified: branches/upstream/libpod-eventual-perl/current/README
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/README?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/README (original)
+++ branches/upstream/libpod-eventual-perl/current/README Wed Nov 18 01:50:32 2009
@@ -1,12 +1,12 @@
This archive contains the distribution Pod-Eventual, version
-0.091480:
+0.093170:
read a POD document as a series of trivial events
This software is copyright (c) 2009 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
-the same terms as perl itself.
+the same terms as the Perl 5 programming language system itself.
Modified: branches/upstream/libpod-eventual-perl/current/eg/dump.pl
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/eg/dump.pl?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/eg/dump.pl (original)
+++ branches/upstream/libpod-eventual-perl/current/eg/dump.pl Wed Nov 18 01:50:32 2009
@@ -6,6 +6,9 @@
{
package Pod::Gather;
+our $VERSION = '0.093170';
+
+
use base 'Pod::Eventual';
sub handle_event { push @events, $_[1] }
}
Modified: branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual.pm?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual.pm (original)
+++ branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual.pm Wed Nov 18 01:50:32 2009
@@ -1,7 +1,8 @@
use strict;
use warnings;
package Pod::Eventual;
-our $VERSION = '0.091480';
+our $VERSION = '0.093170';
+
# ABSTRACT: read a POD document as a series of trivial events
use Mixin::Linewise::Readers;
@@ -115,7 +116,6 @@
1;
__END__
-
=pod
=head1 NAME
@@ -124,11 +124,14 @@
=head1 VERSION
-version 0.091480
+version 0.093170
=head1 SYNOPSIS
package Your::Pod::Parser;
+our $VERSION = '0.093170';
+
+
use base 'Pod::Eventual';
sub handle_event {
@@ -154,9 +157,52 @@
Pod::Eventual subclasses. If it isn't, Pod::Eventual's own C<handle_event>
will be called, and will raise an exception.
+=head1 METHODS
+
+=head2 read_handle
+
+ Pod::Eventual->read_handle($io_handle, \%arg);
+
+This method iterates through the lines of a handle, producing events and
+calling the C<handle_event> method.
+
+The only valid argument in C<%arg> (for now) is C<in_pod>, which indicates
+whether we should assume that we are parsing pod when we start parsing the
+file. By default, this is false.
+
+This is useful to behave differently when reading a F<.pm> or F<.pod> file.
+
+=head2 read_file
+
+This behaves just like C<read_handle>, but expects a filename rather than a
+handle.
+
+=head2 read_string
+
+This behaves just like C<read_handle>, but expects a string containing POD
+rather than a handle.
+
+=head2 handle_event
+
+This method is called each time Pod::Evental finishes scanning for a new POD
+event. It must be implemented by a subclass or it will raise an exception.
+
+=head2 handle_nonpod
+
+This method is called each time a non-POD segment is seen -- that is, lines
+after C<=cut> and before another command.
+
+If unimplemented by a subclass, it does nothing by default.
+
+=head2 handle_blank
+
+This method is called at the end of a sequence of one or more blank lines.
+
+If unimplemented by a subclass, it does nothing by default.
+
=head1 EVENTS
-There are three kinds of events that Pod::Eventual will produce. All are
+There are four kinds of events that Pod::Eventual will produce. All are
represented as hash references.
=head2 Command Events
@@ -215,51 +261,32 @@
{
type => 'text',
content => "a string of text ending with a\n",
- start_line => 16
- }
-
-=head1 METHODS
-
-=head2 read_handle
-
- Pod::Eventual->read_handle($io_handle, \%arg);
-
-This method iterates through the lines of a handle, producing events and
-calling the C<handle_event> method.
-
-The only valid argument in C<%arg> (for now) is C<in_pod>, which indicates
-whether we should assume that we are parsing pod when we start parsing the
-file. By default, this is false.
-
-This is useful to behave differently when reading a F<.pm> or F<.pod> file.
-
-=head2 read_file
-
-This behaves just like C<read_handle>, but expects a filename rather than a
-handle.
-
-=head2 read_string
-
-This behaves just like C<read_handle>, but expects a string containing POD
-rather than a handle.
-
-=head2 handle_event
-
-This method is called each time Pod::Evental finishes scanning for a new POD
-event. It must be implemented by a subclass or it will raise an exception.
-
-=head2 handle_nonpod
-
-This method is called each time a non-POD segment is seen -- that is, lines
-after C<=cut> and before another command.
-
-If unimplemented by a subclass, it does nothing by default.
-
-=head2 handle_blank
-
-This method is called at the end of a sequence of one or more blank lines.
-
-If unimplemented by a subclass, it does nothing by default.
+ start_line => 16,
+ }
+
+=head2 Blank events
+
+These events represent blank lines (or many blank lines) within a Pod section.
+
+Blank events look like this:
+
+ {
+ type => 'blank',
+ content => "\n\n\n\n",
+ start_line => 21,
+ }
+
+=head2 Non-Pod events
+
+These events represent non-Pod segments of the input.
+
+Non-Pod events look like this:
+
+ {
+ type => 'nonpod',
+ content => "#!/usr/bin/perl\nuse strict;\n\nuse Acme::ProgressBar\n\n",
+ start_line => 1,
+ }
=head1 AUTHOR
@@ -270,8 +297,7 @@
This software is copyright (c) 2009 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
-the same terms as perl itself.
-
-=cut
-
-
+the same terms as the Perl 5 programming language system itself.
+
+=cut
+
Modified: branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual/Simple.pm
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual/Simple.pm?rev=47396&op=diff
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual/Simple.pm (original)
+++ branches/upstream/libpod-eventual-perl/current/lib/Pod/Eventual/Simple.pm Wed Nov 18 01:50:32 2009
@@ -1,7 +1,8 @@
use strict;
use warnings;
package Pod::Eventual::Simple;
-our $VERSION = '0.091480';
+our $VERSION = '0.093170';
+
use Pod::Eventual;
BEGIN { our @ISA = 'Pod::Eventual' }
@@ -33,7 +34,6 @@
1;
__END__
-
=pod
=head1 NAME
@@ -42,7 +42,7 @@
=head1 VERSION
-version 0.091480
+version 0.093170
=head1 SYNOPSIS
@@ -73,8 +73,7 @@
This software is copyright (c) 2009 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
-the same terms as perl itself.
+the same terms as the Perl 5 programming language system itself.
-=cut
+=cut
-
Added: branches/upstream/libpod-eventual-perl/current/t/release-pod-coverage.t
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/t/release-pod-coverage.t?rev=47396&op=file
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/t/release-pod-coverage.t (added)
+++ branches/upstream/libpod-eventual-perl/current/t/release-pod-coverage.t Wed Nov 18 01:50:32 2009
@@ -1,0 +1,21 @@
+#!perl
+
+BEGIN {
+ unless ($ENV{RELEASE_TESTING}) {
+ require Test::More;
+ Test::More::plan(skip_all => 'these tests are for release candidate testing');
+ }
+}
+
+
+use Test::More;
+
+eval "use Test::Pod::Coverage 1.08";
+plan skip_all => "Test::Pod::Coverage 1.08 required for testing POD coverage"
+ if $@;
+
+eval "use Pod::Coverage::TrustPod";
+plan skip_all => "Pod::Coverage::TrustPod required for testing POD coverage"
+ if $@;
+
+all_pod_coverage_ok({ coverage_class => 'Pod::Coverage::TrustPod' });
Added: branches/upstream/libpod-eventual-perl/current/t/release-pod-syntax.t
URL: http://svn.debian.org/wsvn/pkg-perl/branches/upstream/libpod-eventual-perl/current/t/release-pod-syntax.t?rev=47396&op=file
==============================================================================
--- branches/upstream/libpod-eventual-perl/current/t/release-pod-syntax.t (added)
+++ branches/upstream/libpod-eventual-perl/current/t/release-pod-syntax.t Wed Nov 18 01:50:32 2009
@@ -1,0 +1,15 @@
+#!perl
+
+BEGIN {
+ unless ($ENV{RELEASE_TESTING}) {
+ require Test::More;
+ Test::More::plan(skip_all => 'these tests are for release candidate testing');
+ }
+}
+
+use Test::More;
+
+eval "use Test::Pod 1.00";
+plan skip_all => "Test::Pod 1.00 required for testing POD" if $@;
+
+all_pod_files_ok();
More information about the Pkg-perl-cvs-commits
mailing list