$ cat lib/Mymod.pm
package Mymod;

use strict;
use warnings;
use Exporter;
our @EXPORT = qw(greet);

sub greet {print "Hello\n"}

1;

.....


$ cat lib/Mymod.pod 
=pod

=head1 NAME

Mymod - Perl module to say hello.

=head1 SYNOPSIS

    use Mymod;
    greet();

=head1 DESCRIPTION

Example module.

=cut


.......

$ PERL5LIB='./lib' perldoc -T Mymod
NAME
    Mymod - Perl module to say hello.

SYNOPSIS
        use Mymod;
        greet();

DESCRIPTION
    Example module.