view release on metacpan or  search on metacpan

examples/pod/myapp.pod  view on Meta::CPAN

=head1 NAME

myapp - My Very Cool App

=head1 ABSTRACT

This app can do very cool things

=head1 DESCRIPTION

This is a very useful description for myapp.
This is a very useful description for myapp.
This is a very useful description for myapp.
This is a very useful description for myapp.


=head2 GLOBAL OPTIONS

    --verbose -v   [] be verbose (flag; multiple)
    --help -h         Show command help (flag)   
    --format          Format output              


=head2 SUBCOMMANDS

=head3  config

    myapp  config [options]

configuration

Options:

    --set   {} key=value pair(s) (multiple; mapping)


=head3  convert

    myapp  convert <type> <source> <value> <target>+

Various unit conversions

Parameters:

    type    *    The type of unit to convert    
    source  *    The source unit to convert from
    value   *    The value to convert           
    target  * [] The target unit (multiple)     

=head3  cook

    myapp  cook [options] <drink>

Cook something

Options:

    --with        Drink with ...  
    --sugar -s    add sugar (flag)

Parameters:

    drink  *  What to drink

=head3  data

    myapp  data [options]

output some data

Options:

    --item    


=head3  palindrome

    myapp  palindrome <string>

Check if a string is a palindrome

Parameters:

    string  *  

=head3  weather

    myapp  weather <subcommands>

Weather


=head3 weather cities

    myapp weather cities [options]

show list of cities

Options:

    --country -c   [] country name(s) (multiple)


=head3 weather countries

    myapp weather countries

show list of countries


=head3 weather show

    myapp weather show [options] <country> <city>+