As you get acquainted with Pod::Usage, consider the normal layout of manual pages, and use it. You'll find that Pod::Usage::pod2usage provides the means to display just the SYNOPSIS portion or the whole manual. As for testing that the user gives you exactly one command-line "option": 
#!/usr/bin/perl

=head1 NAME

name_of_utility_or_module

=head1 SYNOPSIS

  brief example/template/summary of typical use(s), e.g.:

  prog_name -d
  prog_name -h
  prog_name -p foobar

=head1 DESCRIPTION

Paragraphs that describe the purpose, usage and various
behaviors of the utility or module in suitable detail...

=cut

use strict;
use Getopt::Std;
use Pod::Usage;

my %opt;
getopts('dp:h', \%opt);

pod2usage(2) if (keys %opt != 1);  # die here if too many options were
+ given

print "ok, here we go...\n";

if ( $opt{d} ) { 
   # do this..
}
if ( $opt{p} ) {
   # do that...
}
if ( $opt{h} ) {
    pod2usage(-exitstatus => 0, -verbose => 2); # exit & show full man
+ page
}

[download]

In reply to Re: File Backup Utility by graff
in thread File Backup Utility by misterMatt

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.