The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


ShipIt::Step::ChangePodVersion - Keep VERSION in your Pod in sync with $VERSION


Version 0.04


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.


Thomas Mueller, <tmueller at>


Please report any bugs or feature requests to bug-shipit-step-changepodversion at, or through the web interface at 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.

    perldoc ShipIt::Step::ChangePodVersion

You can also look for information at:


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 for more information.