App::TemplateCMD::Templates - Default templates for templatecmd to use.
This documentation refers to App::TemplateCMD::Templates version 0.0.2.
use Template; use Template::Provider::FromDATA; use App::TemplateCMD::Templates; # Get the template provider my $provider = Template::Provider::FromDATA->new({ CLASSES => 'App::TemplateCMD::Templates', }); # Create the new template object my $template = Template->new({ LOAD_TEMPLATES => [$provider], }); # use the templates as desired
This module exists to provide the default templates for App::TemplateCMD
get_data ()
Returns the DATA file handle for this module
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gmail.com).
Patches are welcome.
Ivan Wills - (ivan.wills@gmail.com)
Copyright (c) 2009 Ivan Wills (14 Mullion Close, NSW, Australia 2077). All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. 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.
[% file %] - <One-line description of commands purpose>
[% INCLUDE perl/pod/VERSION.pl %] [% INCLUDE perl/pod/USAGE.pl %] [% INCLUDE perl/pod/DESCRIPTION.pl %] [% INCLUDE perl/pod/METHODS.pl %] [% INCLUDE perl/pod/detailed.pl %] =head1 AUTHOR
[% contact.fullname %] - ([% contact.email %])
[% module %] - <One-line description of module's purpose>
[% INCLUDE perl/pod/VERSION.pl %] [% INCLUDE perl/pod/SYNOPSIS.pl %] [% INCLUDE perl/pod/DESCRIPTION.pl %] [% INCLUDE perl/pod/METHODS.pl %] [% INCLUDE perl/pod/detailed.pl %] =head1 AUTHOR
[% contact.fullname %] - ([% contact.email %]) <Author name(s)> (<contact address>)
[% INCLUDE perl/pod/VERSION.pl %] [% INCLUDE perl/pod/SYNOPSIS.pl %] [% INCLUDE perl/pod/DESCRIPTION.pl %] [% INCLUDE perl/pod/METHODS.pl %]
[% INCLUDE perl/pod.pl return => module, sub => 'new' -%]
[% INCLUDE perl/pod/detailed.pl %] =head1 AUTHOR
[% FOREACH sig = sigs %] [%- matches = sig.match('^,?(\w+)[(](.*)$') -%] =head3 [% matches.0 %] ([% matches.1.split(',').join(', ') %]) [% FOREACH arg = matches.1.split(',') %] Arg: [% arg %] - type (detail) - description [% END %] Return: type - description
[% matches.0 %] ([% matches.1.split(',').join(', ') %])
[% arg %]
Description:
[% END %]
[% sub || 'sub' %] ( [% FOREACH var = vars %]$[% var %],[% END %] )
$[% var %]
Return: [% return %] -
A full description of the module and its features.
May include numerous subsections (i.e., =head2, =head3, etc.). __perl/pod/METHODS.pl__
A separate section listing the public components of the module's interface.
These normally consist of either subroutines that may be exported, or methods that may be called on objects belonging to the classes that the module provides.
Name the section accordingly.
In an object-oriented module, this section should begin with a sentence (of the form "An object of this class represents ...") to give the reader a high-level context to help them understand the methods that are subsequently described. __perl/pod/NAME.pl__
__perl/pod/SYNOPSIS.pl__
use [% module %]; # Brief but working code example(s) here showing the most common usage(s) # This section will be as far as many users bother reading, so make it as # educational and exemplary as possible. __perl/pod/USAGE.pl__ =head1 SYNOPSIS [% module %] [option] OPTIONS: -o --other other option -v --verbose Show more detailed option --version Prints the version information --help Prints this help information --man Prints the full documentation for [% module %]
__perl/pod/VERSION.pl__ =head1 VERSION
This documentation refers to [% module %] version 0.1. __perl/pod/detailed.pl__ =head1 DIAGNOSTICS
A list of every error and warning message that the module can generate (even the ones that will "never happen"), with a full explanation of each problem, one or more likely causes, and any suggested remedies.
A full explanation of any configuration system(s) used by the module, including the names and locations of any configuration files, and the meaning of any environment variables or properties that can be set. These descriptions must also include details of any configuration language used.
A list of all of the other modules that this module relies upon, including any restrictions on versions, and an indication of whether these required modules are part of the standard Perl distribution, part of the module's distribution, or must be installed separately.
A list of any modules that this module cannot be used in conjunction with. This may be due to name conflicts in the interface, or competition for system or program resources, or due to internal limitations of Perl (for example, many modules that use source code filters are mutually incompatible).
A list of known problems with the module, together with some indication of whether they are likely to be fixed in an upcoming release.
Also, a list of restrictions on the features the module does provide: data types that cannot be handled, performance issues and the circumstances in which they may arise, practical limitations on the size of data sets, special cases that are not (yet) handled, etc.
The initial template usually just has:
Please report problems to [% contact.fullname %] ([% contact.email %]).
Patches are welcome. __perl/pod/package.pl__ [% IF not vars %][% vars = [ 'search' ] %][% END -%] [% IF not module %][% module = 'Module::Name' %][% END -%] =head1 NAME
To install App::TemplateCMD, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::TemplateCMD
CPAN shell
perl -MCPAN -e shell install App::TemplateCMD
For more information on module installation, please visit the detailed CPAN module installation guide.