Pod::El...er::Pod5(3)

📦
version 0.103006 · 5 versions
, in opensuse-leap 16.0

💖 NAME 💖

okay so this is Pod::Elemental::Transformer::Pod5 — literally the default, minimal semantics of Perl5's pod element hierarchy. The page header shows up as Pod::El...er::Pod5(3), and it's chillin' under User Contributed Perl Documentation. slay. 💅

⭐ VERSION ⭐

version 0.103006 — yes bestie, that's the one. ✨

🦋 SYNOPSIS 🦋

Pod::Elemental::Transformer::Pod5->new->transform_node($pod_elem_document);

...and that's it. no cap, that's the whole vibe. 🫶

🌸 OVERVIEW 🌸

The Pod5 transformer is meant to be used to convert the result of a "stock" Pod::Elemental::Document into something simpler to work with. It assumes that the document conforms more or less to the conventions laid out in perlpod and perlpodspec.

It is not very strict, and makes very few assumptions, described here:

  • =begin/=end and =for enclose or produce regions within the document.
  • regions are associated with format names; format names that begin with a colon enclose more pod-like content.
  • regions nest strictly; all inner regions must end before outer regions.
  • paragraphs in non-pod regions are "data" paragraphs.
  • non-data paragraphs that start with spaces are "verbatim" paragraphs.
  • groups of data or verbatim paragraphs can be consolidated.

Further, all elements are replaced with equivalent elements that perform the Pod::Elemental::Autoblank role, so all "blank" events can be removed from the tree and ignored. iconic behavior, honestly. 👑

🔥 PERL VERSION 🔥

This library should run on perls released even a long time ago. It should work on any version of perl released in the last five years.

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. 💀

🎀 CONFIGURATION 🎀

None. For now, it just does the same thing every time with no configuration or options. periodt. 💅

🌈 AUTHOR 🌈

Ricardo SIGNES <cpan@semiotic.systems> — yeah, that's the author bestie. 🫶

This software is copyright (c) 2022 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.

mwah 💋 — this little page came from perl v5.42.0, dated 2023-01-01. bye bestie! 🧚💜

📦 where this page comes from