- LICENSE AND COPYRIGHT
ShipIt::Step::ChangePodVersion - Keep VERSION in your Pod in sync with $VERSION
Just add it to the ShipIt config, maybe after the ChangeVersion-Step
steps = FindVersion, ChangeVersion, ChangePodVersion, CheckChangeLog, ...
And make sure you have a VERSION or at least a NAME section in your Pod.
=head1 VERSION version 123
This is a Step for ShipIt to keep your Pod VERSION in sync with your $VERSION. If a VERSION section is discovered in your Pod, it is tried to find and replace numbers or "." or "_" within this section with your new version.
You can write whatever you want before your version-number, but make sure it does not contain numbers or "." or "_".
In case no VERSION section is found, a VERSION section is created after the NAME section. If no NAME section is found, we die.
By default all your modules' Pod VERSION sections are updated to the files' $VERSION. Add ChangePodVersion.all to your shipit config and set it to 0 to change only the Pod of your distribution package.
In case no $VERSION is found in your package, we don't die, but continue with other packages.
Set this config value to 0 to deactivate VERSION Changes for all your dists modules. Only the dist-packages' Pod VERSION will be changed then.
The code to change all Modules' Pod VERSION is not automatically tested yet, because it is hard to write tests for it. I use it with HTTP::Exception now and didn't notice any problems, although automatic testing is better than having not experienced any problems. If you encounter problems, just deactivate it with ChangePodVersion.all = 0 and drop me an email.
<tmueller at cpan.org>
Please report any bugs or feature requests to
bug-shipit-step-changepodversion at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=ShipIt-Step-ChangePodVersion. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
RT: CPAN's request tracker
AnnoCPAN: Annotated CPAN documentation
Copyright 2010 Thomas Mueller.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.