| name | version-bump |
| description | Bump XML::LibXML's $VERSION across every version-bearing file in one shot. Use whenever the user asks to bump, change, set, or promote the XML::LibXML version (e.g. "bump to 2.0212", "promote the dev release to stable", "cut 2.0212_01"). Wraps a Perl script that auto-detects the current version from LibXML.pm and rewrites every file carrying the `# VERSION TEMPLATE: DO NOT CHANGE` marker plus the `<edition>` tag in docs/libxml.dbk. Optionally renames the topmost Changes entry when promoting a CPAN-underscore developer release. |
version-bump
Run from the repo root:
.claude/skills/version-bump/bump.pl <new_version>
Common flows:
| Goal | Command |
|---|
| Bump to a new release | .claude/skills/version-bump/bump.pl 2.0212 |
| Cut a developer/trial release | .claude/skills/version-bump/bump.pl 2.0212_01 |
Promote a dev release to stable (rewrites the top Changes header) | .claude/skills/version-bump/bump.pl 2.0212 --rename-changes |
| Preview without writing | .claude/skills/version-bump/bump.pl 2.0212 --check |
What the script does:
- detects the current version automatically from
LibXML.pm
- rewrites
$VERSION = "..." in every .pm file carrying # VERSION TEMPLATE: DO NOT CHANGE (LibXML.pm + lib/XML/LibXML/**)
- rewrites
<edition>...</edition> in docs/libxml.dbk
- with
--rename-changes: replaces the version on the topmost Changes header line and strips any trailing (developer/trial release) annotation
- warns (but does not block) if the new version ends in
0 — CLAUDE.md says trailing-zero versions are reserved
What the script does not do — handle these manually after running:
- add/update the
Changes entry body with the bullet list of fixes
- update the "Package History" section in
README.md
- run
make / tests / commit
After the script runs, sanity-check with:
grep -rn "$OLD_VERSION" LibXML.pm lib/ docs/libxml.dbk Changes
git diff --stat
