CPAN::Admin(3)

💖 CPAN::Admin(3) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation and it's literally called CPAN::Admin — a whole CPAN shell made for the CPAN admins themselves. yes, the actual gatekeepers. 👑

---

✨ NAME ✨

CPAN::Admin — A CPAN Shell for CPAN admins 🫶

---

🦋 SYNOPSIS 🦋

perl -MCPAN::Admin -e shell

that's it. that's the whole vibe. 💅

---

💀 STATUS 💀

Note: this module is currently not maintained. 😭 If you need it and you fix it for your needs, please submit patches. be the change you want to see in the CPAN, fr fr. 🫶

---

🌸 DESCRIPTION 🌸

So CPAN::Admin is a subclass of CPAN (yes, it's giving nepo baby but in a good way ✨) and it adds two extra commands to the CPAN shell: register and modsearch.

🎀 register

register calls get on the named module, then assembles a couple of informations (description, language — the lil details, you know? 💅), and then calls Netscape with the -remote argument. The whole point is so that a form gets filled with all the assembled informations, and the registration can be performed with a single click. main character energy honestly.

But wait, there's a plot twist 🫢 — if the command line has more than one argument, register does not run a get. Instead it interprets the rest of the line as DSLI status, description, and userid, and sends them to netscape so the form is again mostly filled and can be edited or confirmed with a single click. iconic behavior.

Important: CPAN::Admin never performs the submission click for you. It is only intended to fill in the form on PAUSE and leave the confirmation to you. no cap, the final click is yours and yours alone. 💖

🔍 modsearch

modsearch simply passes the arguments to the search engine for the modules@perl.org mailing list at <http://www.xray.mpe.mpg.de> — that's where all registration requests are stored. and it does it in the exact same way as register, namely with the netscape -remote command. consistent queen. 👑

🌈 the experimental feature

An experimental feature has also been added — namely to color already registered modules in listings. So if you have Term::ANSIColor installed, the u, r, and m commands will show already registered modules in green. 🍓 it's giving aesthetic and functional, we love to see it.

---

🧚 PREREQUISITES 🧚

• URI::Escape
• a browser available in the path
• the browser must understand the -remote switch — and as far as I know, this is only available on UNIX 🐧
• the coloring of registered modules is only available if Term::ANSIColor is installed ✨

---

👑 LICENSE 👑

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 💜

---

and that's the whole page bestie, no skips, no summaries, every single detail preserved like the precious artifact it is 💅✨

sign-off vibes: this lil doc came from perl v5.42.0 and it's dated 2025-07-25 — so if you're reading this, shoutout to that exact snapshot of the manual, mwah 🫶🎀