view release on metacpan or  search on metacpan

script/tubergen  view on Meta::CPAN

 
 =for author, to fill in
     Put a thorough description of your program
 
 
 =head1 OPTIONS
 
 =for author, to fill in
     Description of all command-line options
 
 =over
 
 =item --help
 
 print a somewhat more verbose help, showing usage, this description of
 the options and some examples from the synopsis.
 
 =item --man
 
 print out the full documentation for the script.
 
 =item --usage
 
 print a concise usage line and exit.
 
 =item --version
 
 print the version of the script.
 
 =back
 
 =head1 DIAGNOSTICS
 
 =for author, to fill in
     List and describe all warnings/error messages
 
 =over
 
 =item C<< Error message here, perhaps with %s placeholders >>
 
 [Error description...]
 
 =item C<< Another error message here >>
 
 [Error description...]
 
 [You get the idea...]
 
 =back
 
 
 =head1 CONFIGURATION AND ENVIRONMENT
 
 =for author, to fill in
     Explain any configuration that can be used by the program, via some
     file or via environment variables.
 
 [% name %] requires no configuration files or environment variables.
 
 
 =head1 BUGS AND LIMITATIONS
 
 =for author, to fill in
     List any known bugs and limitations of your program
 
 No bugs have been reported.
 
 
 =head1 AUTHOR
 
 [% author %] <[% email %]>
 
 
 =head1 LICENCE AND COPYRIGHT
 
 Copyright (c) [% year %], [% author %] <[% email %]>
 
 =for author, to fill in
    Put your licensing terms here, leaving the terms for the embedded
    modules. If you're fine with the Artistic License 2.0, you can find
    them in the two paragraphs below, delete them if you want to use
    something different.
 
 This program is free software.  You can redistribute it and/or
 modify it under the terms of the Artistic License 2.0.
 
 This program is distributed in the hope that it will be useful,
 but without any warranty; without even the implied warranty of
 merchantability or fitness for a particular purpose.
 
 This program embeds all modules from distribution Data::Tubes, that is
 Copyright (C) 2016 by Flavio Poletti and licensed under the Artistic
 License 2.0. See L<https://metacpan.org/pod/Data::Tubes> for further
 details.
 
 This program embeds Log::Log4perl::Tiny, that is Copyright (C) 2010-2016
 by Flavio Poletti and licensed under the Artistic License 2.0. See
 L<https://metacpan.org/pod/Log::Log4perl::Tiny> for further details.
 
 This program embeds Template::Perlish, that is Copyright (C) 2008-2016
 by Flavio Poletti and licensed under the Artistic License 2.0. See
 L<https://metacpan.org/pod/Template::Perlish> for further details.
 
 This program embeds Try::Tiny, that is Copyright (c) 2009 by יובל קוג'מן
 (Yuval Kogman) and licensed under The MIT (X11) License. See
 L<https://metacpan.org/pod/Try::Tiny> for further details.
 
 =cut

END_OF_TEMPLATE
   $template =~ s{^\ }{}gmxs;
   $template =~ s{\n\z}{}mxs;
   return $template;
}

__END__

=pod

=encoding utf8

script/tubergen  view on Meta::CPAN

=item -e email-address

the email address of the author of the program, used to initialize the
POD section of the newly minted program. This option is required.

=item --help

print a somewhat more verbose help, showing usage, this description of
the options and some examples from the synopsis.

=item --man

print out the full documentation for the script.

=item --name program-name

=item -n program-name

the name assigned to the program. This is used to both initialize the
POD section of the newly minted program, and as the file name where it
is saved to. You can override the filename with option
L<output|/"--output filename">. This option is required.

=item --output filename

=item -o filename

the filename where the program should be saved. Defaults to the value
assigned to L<name|/"--name program-name">.

=item --usage

print a concise usage line and exit.

=item --version

print the version of the script.

=item --year year

=item -y year

X<year>

The year to set for starting the copyright of the newly minted program
in the relevant POD section. Defaults to the current year.

=back

=head1 DIAGNOSTICS

tubergen will complain if any of the required option is missing. It will
also complain if you try to define unknown options.

=head1 CONFIGURATION AND ENVIRONMENT

tubergen requires no configuration files or environment variables.


=head1 BUGS AND LIMITATIONS

No bugs have been reported, but you can do this through Issues at
L<https://github.com/polettix/Data-Tubes/issues>.


=head1 AUTHOR

Flavio Poletti polettix@cpan.org


=head1 LICENCE AND COPYRIGHT

Copyright (c) 2016, Flavio Poletti polettix@cpan.org

This program is free software.  You can redistribute it and/or
modify it under the terms of the Artistic License 2.0.

This program is distributed in the hope that it will be useful,
but without any warranty; without even the implied warranty of
merchantability or fitness for a particular purpose.

This program embeds all modules from distribution Data::Tubes, that is
Copyright (C) 2016 by Flavio Poletti and licensed under the Artistic
License 2.0. See L<https://metacpan.org/pod/Data::Tubes> for further
details.

This program embeds Mo and Mo::default from distribution Mo, that is
Copyright (c) 2011-2013. Ingy döt Net and licensed under the same terms
of Perl itself. See L<See http://www.perl.com/perl/misc/Artistic.html>
for the license and L<https://metacpan.org/pod/Mo> for further details.

This program embeds Log::Log4perl::Tiny, that is Copyright (C) 2010-2016
by Flavio Poletti and licensed under the Artistic License 2.0. See
L<https://metacpan.org/pod/Log::Log4perl::Tiny> for further details.

This program embeds Template::Perlish, that is Copyright (C) 2008-2016
by Flavio Poletti and licensed under the Artistic License 2.0. See
L<https://metacpan.org/pod/Template::Perlish> for further details.

This program embeds Try::Tiny, that is Copyright (c) 2009 by יובל קוג'מן
(Yuval Kogman) and licensed under The MIT (X11) License. See
L<https://metacpan.org/pod/Try::Tiny> for further details.

=cut