1Pod::Elemental::TransfoUrsmeerr:C:oPnotdr5i(b3u)ted PerlPoDdo:c:uEmleenmteanttiaoln::Transformer::Pod5(3)
2
3
4
6 Pod::Elemental::Transformer::Pod5 - the default, minimal semantics of
7 Perl5's pod element hierarchy
8
10 version 0.103006
11
13 Pod::Elemental::Transformer::Pod5->new->transform_node($pod_elem_document);
14
15 ...and that's it.
16
18 The Pod5 transformer is meant to be used to convert the result of a
19 "stock" Pod::Elemental::Document into something simpler to work with.
20 It assumes that the document conforms more or less to the convetions
21 laid out in perlpod and perlpodspec. It is not very strict, and makes
22 very few assumptions, described here:
23
24 • =begin/=end and =for enclose or produce regions within the document
25
26 • regions are associated with format names; format names that begin
27 with a colon enclose more pod-like content
28
29 • regions nest strictly; all inner regions must end before outer
30 regions
31
32 • paragraphs in non-pod regions are "data" paragraphs
33
34 • non-data paragraphs that start with spaces are "verbatim"
35 paragraphs
36
37 • groups of data or verbatim paragraphs can be consolidated
38
39 Further, all elements are replaced with equivalent elements that
40 perform the Pod::Elemental::Autoblank role, so all "blank" events can
41 be removed form the tree and ignored.
42
44 This library should run on perls released even a long time ago. It
45 should work on any version of perl released in the last five years.
46
47 Although it may work on older versions of perl, no guarantee is made
48 that the minimum required version will not be increased. The version
49 may be increased for any reason, and there is no promise that patches
50 will be accepted to lower the minimum required perl.
51
53 None. For now, it just does the same thing every time with no
54 configuration or options.
55
57 Ricardo SIGNES <cpan@semiotic.systems>
58
60 This software is copyright (c) 2022 by Ricardo SIGNES.
61
62 This is free software; you can redistribute it and/or modify it under
63 the same terms as the Perl 5 programming language system itself.
64
65
66
67perl v5.38.0 2023-07-2P1od::Elemental::Transformer::Pod5(3)