Dist::Zilla::Plugin::AlienBase::Doc - Generate boilerplate documentation for Alien::Base subclass
version 0.32
In your dist.ini:
[AlienBase::Doc] name = libfoo
In your Alien/Foo.pm:
package Alien::Foo; use strict; use warnings; use base qw( Alien::Base ); # ALIEN SYNOPSIS # ALIEN DESCRIPTION # ALIEN SEE ALSO 1;
This plugin generates some boiler plat documentation for your Alien::Base based Alien module. It will find the special codes ALIEN SYNOPSIS, ALIEN DESCRIPTION, and ALIEN SEE ALSO and replace them with the appropriate boilerplate POD documentation for how to use the module. The generated synopsis and see also sections are probably good enough as is. The description is a little more basic, and you may want to write a more detailed description yourself. It is, at least, better than nothing though!
The name of the Alien::Base subclass. The default is based on the distribution's main module.
The minimum version to suggest using as a prereq.
Types of the Alien. This can be specified multiple times. Valid types:
[required]
The name of the alienized project. For example libarchive or infozip.
List of modules to refer to in the SEE ALSO section. By default this is
Graham Ollis <plicease@cpan.org>
This software is copyright (c) 2017 by Graham Ollis.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
This distribution provides {{ $name }} so that it can be used by other Perl distributions that are on CPAN. It does this by first trying to detect an existing install of {{ $name }} on your system. If found it will use that. If it cannot be found, the source code will be downloaded from the internet and it will be installed in a private share location for the use of other modules.