- SEE ALSO
- COPYRIGHT AND LICENCE
Dist::Zilla::Plugin::TrialVersionComment - Add a "# TRIAL" comment after your version declaration in trial releases
In your dist.ini:
This is a Dist::Zilla plugin that munges your .pm files to add a
# TRIAL comment after
$VERSION assignments, if the release is
If the distribution is not a
--trial release (i.e.
release_status in metadata is
stable), this plugin does nothing.
Other plugins that munge versions into files also add the
# TRIAL comment (such as [PkgVersion], [OurPkgVersion], and [RewriteVersion], so you would generally only need this plugin if you added the version yourself, manually.
Nothing currently parses these comments, but the idea is that things like Module::Metadata might make use of this in the future.
This is a rather silly plugin, and doesn't really add any value. I suppose if you are adding
$VERSION statements with
[PkgVersion] it could be useful, but in that case I think I'd rather patch
[PkgVersion] to add the comment as well, rather than going to all the effort of re-parsing the perl document again. I only really wrote this as an exercise in using PPI, to help diagnose some issues I was seeing with Acme::LookOfDisapproval and utf8-encoded perl code.
Inspiration for this module came about through multiple toolchain conversations with David Golden (xdg).
Bugs may be submitted through the RT bug tracker (or bug-Dist-Zilla-Plugin-TrialVersionComment@rt.cpan.org).
There is also a mailing list available for users of this distribution, at http://dzil.org/#mailing-list.
There is also an irc channel available for users of this distribution, at
I am also usually active on irc, as 'ether' at
Karen Etheridge <firstname.lastname@example.org>
David Golden <email@example.com>
This software is copyright (c) 2014 by Karen Etheridge.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.