/usr/share/perl5/Pod/Elemental/Transformer/Gatherer.pm is in libpod-elemental-perl 0.102361-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | package Pod::Elemental::Transformer::Gatherer;
{
$Pod::Elemental::Transformer::Gatherer::VERSION = '0.102361';
}
use Moose;
with 'Pod::Elemental::Transformer';
# ABSTRACT: gather related paragraphs under a shared header
use namespace::autoclean;
use Moose::Autobox 0.10;
use MooseX::Types::Moose qw(CodeRef);
use Pod::Elemental::Node;
has gather_selector => (
is => 'ro',
isa => CodeRef,
required => 1,
);
has container => (
is => 'ro',
does => 'Pod::Elemental::Node',
required => 1,
);
sub transform_node {
my ($self, $node) = @_;
my @indexes;
for my $i (0 .. $node->children->length - 1) {
push @indexes, $i if $self->gather_selector->($node->children->[ $i ]);
}
my @paras;
for my $idx (reverse @indexes) {
unshift @paras, splice @{ $node->children }, $idx, 1;
}
$self->container->children(\@paras);
splice @{ $node->children }, $indexes[0], 0, $self->container;
return $node;
}
1;
__END__
=pod
=head1 NAME
Pod::Elemental::Transformer::Gatherer - gather related paragraphs under a shared header
=head1 VERSION
version 0.102361
=head1 OVERVIEW
Like the Nester transformer, this Gatherer produces structure and containment
in a Pod document. Unlike that Nester, it does not find top-level elements,
but instead produces them.
It looks for all elements matching the C<gather_selector>. They are removed
from the node. In the place of the first found element, the C<container> node
is placed into the transformed node, and all the gathered elements are made
children of the container.
So, given this document:
Document
=head1 Foo
=over 4
=item * xyzzy
=item * abcdef
=back
=head1 Bar
=over 4
=item * 1234
=item * 8765
=back
...and this nester...
my $gatherer = Pod::Elemental::Transformer::Gatherer->new({
gather_selector => s_command( [ qw(over item back) ] ),
container => Pod::Elemental::Element::Pod5::Command->new({
command => 'head1',
content => "LISTS\n",
}),
});
Then this:
$nester->transform_node($document);
Will result in this document:
Document
=head1 Foo
=head1 LISTS
=over 4
=item * xyzzy
=item * abcdef
=back
=over 4
=item * 1234
=item * 8765
=back
=head1 Bar
=head1 ATTRIBUTES
=head2 gather_selector
This is a coderef (a predicate) used to find the paragraphs to gather up.
=head2 container
This is a Pod::Elemental::Node that will be inserted into the node, containing
all gathered elements.
=head1 AUTHOR
Ricardo SIGNES <rjbs@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Ricardo SIGNES.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|