Documentation with POD

B<> / I<> / C<> Bold / italic / code L<Module> / L<text|url> =head1.. =head4 =over / =item / =back =begin html... =end html / =for =pod / =cut Start/end of a POD block

package My::Math;

=head1 NAME

My::Math - Simple math utilities

=head1 VERSION

Version 1.00

=head1 SYNOPSIS

    use My::Math qw(add);
    my $sum = add(2, 3);   # 5

=head1 DESCRIPTION

B<My::Math> provides I<basic> arithmetic. See L<List::Util> for more.
Inline code looks like C<add($x, $y)>.

=head1 FUNCTIONS

=head2 add($x, $y)

Returns the sum of C<$x> and C<$y>.

=over 4

=item * Accepts numbers or numeric strings

=item * Dies on non-numeric input

=back

=head1 AUTHOR

Your Name E<lt>you@example.comE<gt>

=head1 LICENSE

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

=cut

1;

perldoc lib/My/Math.pm           # view
podchecker lib/My/Math.pm        # validate
pod2html lib/My/Math.pm > math.html
pod2man lib/My/Math.pm > math.3
pod2markdown lib/My/Math.pm      # Pod::Markdown (CPAN)