CPAN-LISTCHANGES(1p)

💖 cpan-listchanges — bestie's guide to CPAN-LISTCHANGES(1p) 💖

okay so imagine you're staring at a module on CPAN like "what even changed??" and nobody's answering. that's literally this tool. it's cpan-listchanges, it's a Perl thing, and it lists the changes for CPAN modules so you don't have to go dig through a changelog file like some kind of detective. no cap.

---

✨ SYNOPSIS ✨

here's the vibe. five ways to run it, all of them iconic:

# See what's changed in Plack between your local and the latest on CPAN
cpan-listchanges Plack

# See what's changed for URI between 1.56 and 1.58 (Use @ and ..)
cpan-listchanges URI@1.56..1.58

# See what's changed for Plack 0.9965 and CPAN current (Use HEAD for the latest)
cpan-listchanges Plack@0.9965..HEAD

# See the whole changelog for Catalyst::Runtime
cpan-listchanges --all Catalyst::Runtime

# See what's changed for modules that require upgrades
cpan-listchanges `cpan-outdated -p`

so like, <pink>just name a module</pink> and it compares your local version to the newest one on CPAN. <purple>or use @ and .. to pin a range</purple> — <cyan>and HEAD means the latest, periodt</cyan>. want the entire changelog, no comparisons, just everything? --all has you. and the last one is my fave fr fr — you pipe in cpan-outdated -p and it tells you what changed for every module that's begging for an upgrade. 🫶

---

🎀 OPTIONS 🎀

• -a, --all — <hotpink>spills the ENTIRE content of Changes</hotpink>, no version comparison, no filtering, no "but what if". just the whole thing. 🌸

---

🦋 SEE ALSO 🦋

• App::cpanminus — 👑
• App::cpanoutdated — 💅

go check those out, they're the besties this one hangs with.

---

and that's the whole page, bestie!! no gatekeeping here. 💜

this was lovingly documented as part of perl v5.36.0, dated 2022-12-09, and yeah — it lives at CPAN-LISTCHANGES(1p) in the User Contributed Perl Documentation section. mwah. 💖✨