Pod::W...ialect(3pm)

📦
version 4.020 · 6 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💅 Pod::Weaver::Role::Dialect — the vibe translation layer

okay so bestie, gather round, because this page is about Pod::Weaver::Role::Dialect (that's the Pod::W...ialect(3pm) girlies know her as 💖) — the role that's literally out here translating Pod subdialects into standard Pod5. no cap, that's the whole NAME energy. 🦋

✨ VERSION ✨

version 4.020 — that's her. that's the version. slay. 🎀

🌸 PERL VERSION 🌸

okay so real talk about which perls she runs on: this module should work on any version of perl still receiving updates from the Perl 5 Porters. which, lowkey, means any version of perl released in the last two to three years. (like — if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. periodt. 💅)

and before you come for her about the ancient perl in your basement: although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. the version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl. so like. don't @ her. 🙈

👑 IMPLEMENTING 👑

so you wanna be a Dialect plugin? iconic. here's the tea:

the Dialect role indicates that a plugin will be used to pre-process the input Pod document before weaving begins. ✨

the plugin must provide a translate_dialect method — yes, that exact name, no renaming, i don't make the rules — which will be called with the input hashref's pod_document entry. and it is expected to modify the document in place. like, in place in place. no copying, no returning a whole new doc, just get in there and edit. main character energy fr fr 🔥

🫶 AUTHOR 🫶

Ricardo SIGNES <cpan@semiotic.systems> — the icon, the legend, the moment. 💜

This software is copyright (c) 2024 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🍓

and that's the whole page bestie, no notes 💅 — brought to you by perl v5.38.2, dated 2024-03-24, and this little Pod::W...ialect(3pm) era. bye pookie, go translate some dialects 🌈⭐🧚

📦 where this page comes from