Getopt::Long::Descriptive::Usage.3pm

Langue: en

Autres versions - même langue

Version: 2010-02-14 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

Getopt::Long::Descriptive::Usage - the usage description for GLD

SYNOPSIS

   use Getopt::Long::Descriptive;
   my ($opt, $usage) = describe_options( ... );
 
   $usage->text; # complete usage message
 
   $usage->die;  # die with usage message

DESCRIPTION

This document only describes the methods of the Usage object. For information on how to use Getopt::Long::Descriptive, consult its documentation.

METHODS

new

   my $usage = Getopt::Long::Descriptive::Usage->new(\%arg);

You really don't need to call this. GLD will do it for you.

Valid arguments are:

   options     - an arrayref of options
   leader_text - the text that leads the usage; this may go away!

text

This returns the full text of the usage message.

leader_text

This returns the text that comes at the beginning of the usage message.

option_text

This returns the text describing the available options.

warn

This warns with the usage message.

die

This throws the usage message as an exception. 
   $usage_obj->die(\%arg);

Some arguments can be provided

   pre_text  - text to be prepended to the usage message
   post_text - text to be appended to the usage message

The "pre_text" and "post_text" arguments are concatenated with the usage message with no line breaks, so supply this if you need them.

AUTHOR

Hans Dieter Pearcey, "<hdp@cpan.org>"

BUGS

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Getopt-Long-Descriptive <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Getopt-Long-Descriptive>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. Copyright 2005 Hans Dieter Pearcey, all rights reserved.

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