/usr/share/perl5/Pod/README.pod is in libpod-readme-perl 1.1.2-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 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 | =head1 NAME
Pod::Readme - Intelligently generate a README file from POD
=head1 VERSION
v1.1.2
=head1 SYNOPSIS
In a module's POD:
=head1 NAME
MyApp - my nifty app
=for readme plugin version
=head1 DESCRIPTION
This is a nifty app.
=begin :readme
=for readme plugin requires
=head1 INSTALLATION
...
=end :readme
=for readme stop
=head1 METHODS
...
Then from the command-line:
pod2readme lib/MyModule.pm README
=head1 DESCRIPTION
This module filters POD to generate a F<README> file, by using POD
commands to specify which parts are included or excluded from the
F<README> file.
See the L<Pod::Readme> documentation for more details on the POD
syntax that this module recognizes.
See L<pod2readme> for command-line usage.
=head1 INSTALLATION
See
L<How to install CPAN modules|http://www.cpan.org/modules/INSTALL.html>.
=head2 Required Modules
This distribution requires Perl v5.10.1.
This distribution requires the following modules:
=over 4
=item * L<Class::Method::Modifiers> (version 2.00)
=item * L<CPAN::Changes> (version 0.30)
=item * L<CPAN::Meta>
=item * L<File::Slurp>
=item * L<Getopt::Long::Descriptive>
=item * L<IO::String>
=item * L<Moo> (version 1.004005)
=item * L<Moo::Role>
=item * L<MooX::HandlesVia>
=item * L<namespace::autoclean>
=item * L<Path::Tiny> (version 0.018)
=item * L<Role::Tiny>
=item * L<Test::Deep>
=item * L<Test::Exception>
=item * L<Try::Tiny>
=item * L<Type::Tiny>
=item * L<Types::Standard>
=back
This distribution recommends the following modules:
=over 4
=item * L<Pod::Man>
=item * L<Pod::Markdown>
=item * L<Pod::Simple::LaTeX>
=item * L<Type::Tiny::XS>
=back
=head1 RECENT CHANGES
=head2 Bug Fixes
=over 4
=item *
Regex in changes plugin fixed to work with Perl 5.21 deprecated syntax [khwilliamson].
=back
See the F<Changes> file for a longer revision history.
=head1 CAVEATS
This module is intended to be used by module authors for their own
modules. It is not recommended for generating F<README> files from
arbitrary Perl modules from untrusted sources.
=head1 SEE ALSO
See L<perlpod>, L<perlpodspec> and L<podlators>.
=head1 AUTHORS
The original version was by Robert Rothenberg <rrwo@cpan.org> until
2010, when maintenance was taken over by David Precious
<davidp@preshweb.co.uk>.
In 2014, Robert Rothenberg rewrote the module to use filtering instead
of subclassing a POD parser.
=head2 Acknowledgements
Thanks to people who gave feedback and suggestions to posts about the
rewrite of this module on L<http://blogs.perl.org>.
=head2 Suggestions, Bug Reporting and Contributing
This module is developed on GitHub at
L<http://github.com/bigpresh/Pod-Readme>
=head1 LICENSE
Copyright (c) 2005-2014 Robert Rothenberg. All rights reserved.
This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
|