LOCALE:...OSER.3PM(1)

📦
version 0.74 · 15 versions
, in alpine 3.23

💅 NAME

So like, the header of this page says LOCALE:...OSER.3PM(1) (yes it's cut off, that's just how the man page header do be) — and the actual name of the game is Locale::Po4a::Chooser, the module that manages all the po4a modules for you. Basically the group-chat admin of the po4a universe 🫶

✨ DESCRIPTION ✨

Okay bestie, gather round, because Locale::Po4a::Chooser is a module to manage po4a modules. That's literally its whole job. 👑

So back in the day — and we're talking previously — all po4a binaries used to know all po4a modules (pod, man, sgml, etc). Sounds fine, right? Wrong. 😭 This made the addition of a new module boring — and by boring I mean genuinely annoying, because you had to make sure that the documentation is synchronized in all modules, and that each of them can access the new module. Exhausting. No thank you. 🙈

But now? Now it's a slay. ✨ You just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument. That's it. That's the whole vibe. 💅

And then there's Locale::Po4a::Chooser::list() — this iconic function lists the available formats, and exits with the value passed as argument. So the way this works irl:

  • we call Locale::Po4a::Chooser::list(0) when requested for the list of formats — chill, happy, exit 0, we ate 🍓
  • we call Locale::Po4a::Chooser::list(1) when passed an invalid format name — not chill, exit 1, and honestly? fair 💀

🦋 SEE ALSO 🦋

About po4a:

About modules:

(yes I listed every single one, because the original lists every single one, and we don't do "etc." erasure on this page 📋💖)

🌸 AUTHORS 🌸

The literal icons who made this:

  • Denis Barbier <barbier@linuxfr.org>
  • Martin Quinson (mquinson#debian.org)

Copyright © 2002-2005, 2014, 2017 SPI, Inc.

This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file).

ngl the license text is short but please actually read it before you go redistributing things, bestie — it's GPL v2.0 or later, and the receipts live in the COPYING file 🎀

And that's the whole page, periodt. 🫶 This lil beauty came to you courtesy of perl v5.42.0, dated 2025-07-13 — so go forth, call Locale::Po4a::Chooser::new(), and know that the module-choosing is handled. 💜🦋

📦 where this page comes from