File: Nonpod.pm

package info (click to toggle)
libpod-elemental-perl 0.103005-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 392 kB
  • sloc: perl: 1,497; makefile: 7
file content (76 lines) | stat: -rw-r--r-- 1,658 bytes parent folder | download
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
package Pod::Elemental::Element::Pod5::Nonpod;
# ABSTRACT: a non-pod element in a Pod document
$Pod::Elemental::Element::Pod5::Nonpod::VERSION = '0.103005';
use Moose;
with 'Pod::Elemental::Flat';
with 'Pod::Elemental::Autoblank';

#pod =head1 OVERVIEW
#pod
#pod A Pod5::Nonpod element represents a hunk of non-Pod content found in a Pod
#pod document tree.  It is equivalent to a
#pod L<Generic::Nonpod|Pod::Elemental::Element::Generic::Nonpod> element, with the
#pod following differences:
#pod
#pod =over 4
#pod
#pod =item * it includes L<Pod::Elemental::Autoblank>
#pod
#pod =item * when producing a pod string, it wraps the non-pod content in =cut/=pod
#pod
#pod =back
#pod
#pod =cut

use namespace::autoclean;

sub as_pod_string {
  my ($self) = @_;
  return sprintf "=cut\n%s=pod\n", $self->content;
}

__PACKAGE__->meta->make_immutable;

1;

__END__

=pod

=encoding UTF-8

=head1 NAME

Pod::Elemental::Element::Pod5::Nonpod - a non-pod element in a Pod document

=head1 VERSION

version 0.103005

=head1 OVERVIEW

A Pod5::Nonpod element represents a hunk of non-Pod content found in a Pod
document tree.  It is equivalent to a
L<Generic::Nonpod|Pod::Elemental::Element::Generic::Nonpod> element, with the
following differences:

=over 4

=item * it includes L<Pod::Elemental::Autoblank>

=item * when producing a pod string, it wraps the non-pod content in =cut/=pod

=back

=head1 AUTHOR

Ricardo SIGNES <rjbs@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2020 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