Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Number	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Quote	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
QuoteLike	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Regexp	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
_QuoteEngine	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
ArrayIndex.pm	1.33 KB	-rw-rw-rw-	2019-07-09 19:15
Attribute.pm	3.74 KB	-rw-rw-rw-	2019-07-09 19:15
BOM.pm	2.46 KB	-rw-rw-rw-	2019-07-09 19:15
Cast.pm	1.7 KB	-rw-rw-rw-	2019-07-09 19:15
Comment.pm	3.36 KB	-rw-rw-rw-	2019-07-09 19:15
DashedWord.pm	1.93 KB	-rw-rw-rw-	2019-07-09 19:15
Data.pm	1.93 KB	-rw-rw-rw-	2019-07-09 19:15
End.pm	2.39 KB	-rw-rw-rw-	2019-07-09 19:15
HereDoc.pm	8.79 KB	-rw-rw-rw-	2019-07-09 19:15
Label.pm	1.08 KB	-rw-rw-rw-	2019-07-09 19:15
Magic.pm	5.57 KB	-rw-rw-rw-	2019-07-09 19:15
Number.pm	3.21 KB	-rw-rw-rw-	2019-07-09 19:15
Operator.pm	2.9 KB	-rw-rw-rw-	2019-07-09 19:15
Pod.pm	3.03 KB	-rw-rw-rw-	2019-07-09 19:15
Prototype.pm	2.47 KB	-rw-rw-rw-	2019-07-09 19:15
Quote.pm	2.43 KB	-rw-rw-rw-	2019-07-09 19:15
QuoteLike.pm	1.59 KB	-rw-rw-rw-	2019-07-09 19:15
Regexp.pm	2.48 KB	-rw-rw-rw-	2019-07-09 19:15
Separator.pm	1.29 KB	-rw-rw-rw-	2019-07-09 19:15
Structure.pm	4.7 KB	-rw-rw-rw-	2019-07-09 19:15
Symbol.pm	5.24 KB	-rw-rw-rw-	2019-07-09 19:15
Unknown.pm	12.33 KB	-rw-rw-rw-	2019-07-09 19:15
Whitespace.pm	11.72 KB	-rw-rw-rw-	2019-07-09 19:15
Word.pm	9.13 KB	-rw-rw-rw-	2019-07-09 19:15
_QuoteEngine.pm	5.86 KB	-rw-rw-rw-	2019-07-09 19:15

Rename

package PPI::Token::Pod;

=pod

=head1 NAME

PPI::Token::Pod - Sections of POD in Perl documents

=head1 INHERITANCE

PPI::Token::Pod
  isa PPI::Token
      isa PPI::Element

=head1 DESCRIPTION

A single C<PPI::Token::Pod> object represents a complete section of POD
documentation within a Perl document.

=head1 METHODS

This class provides some additional methods beyond those provided by its
L<PPI::Token> and L<PPI::Element> parent classes.

=cut

use strict;
use Params::Util qw{_INSTANCE};
use PPI::Token   ();

our $VERSION = '1.270'; # VERSION

our @ISA = "PPI::Token";

#####################################################################
# PPI::Token::Pod Methods

=pod

=head2 merge @podtokens

The C<merge> constructor takes a number of C<PPI::Token::Pod> objects,
and returns a new object that represents one combined POD block with
the content of all of them.

Returns a new C<PPI::Token::Pod> object, or C<undef> on error.

=cut

sub merge {
	my $class = (! ref $_[0]) ? shift : return undef;

# Check there are no bad arguments
	if ( grep { ! _INSTANCE($_, 'PPI::Token::Pod') } @_ ) {
		return undef;
	}

# Get the tokens, and extract the lines
	my @content = ( map { [ $_->lines ] } @_ ) or return undef;

# Remove the leading =pod tags, trailing =cut tags, and any empty lines
	# between them and the pod contents.
	foreach my $pod ( @content ) {
		# Leading =pod tag
		if ( @$pod and $pod->[0] =~ /^=pod\b/o ) {
			shift @$pod;
		}

# Trailing =cut tag
		if ( @$pod and $pod->[-1] =~ /^=cut\b/o ) {
			pop @$pod;
		}

# Leading and trailing empty lines
		while ( @$pod and $pod->[0]  eq '' ) { shift @$pod }
		while ( @$pod and $pod->[-1] eq '' ) { pop @$pod   }
	}

# Remove any empty pod sections, and add the =pod and =cut tags
	# for the merged pod back to it.
	@content = ( [ '=pod' ], grep { @$_ } @content, [ '=cut' ] );

# Create the new object
	$class->new( join "\n", map { join( "\n", @$_ ) . "\n" } @content );
}

=pod

=head2 lines

The C<lines> method takes the string of POD and breaks it into lines,
returning them as a list.

=cut

sub lines {
	split /(?:\015{1,2}\012|\015|\012)/, $_[0]->{content};
}

#####################################################################
# PPI::Element Methods

### XS -> PPI/XS.xs:_PPI_Token_Pod__significant 0.900+
sub significant() { '' }

#####################################################################
# Tokenizer Methods

sub __TOKENIZER__on_line_start {
	my $t = $_[1];

# Add the line to the token first
	$t->{token}->{content} .= $t->{line};

# Check the line to see if it is a =cut line
	if ( $t->{line} =~ /^=(\w+)/ ) {
		# End of the token
		$t->_finalize_token if $1 eq 'cut';
	}

0;
}

=pod

=head1 SUPPORT

See the L<support section|PPI/SUPPORT> in the main module.

=head1 AUTHOR

Adam Kennedy E<lt>adamk@cpan.orgE<gt>

=head1 COPYRIGHT

This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the
LICENSE file included with this module.

=cut