summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorSawyer X <xsawyerx@cpan.org>2020-09-25 23:25:27 +0200
committerKarl Williamson <khw@cpan.org>2021-07-03 13:34:35 -0700
commitee5117509fdb6ed3324e9d129ac0de08d9873ea3 (patch)
tree399f27f0bd25907862d0076103e10573dd5da683 /pod
parent310f47b68123831258bf28d4105fd80f8ed59430 (diff)
downloadperl-ee5117509fdb6ed3324e9d129ac0de08d9873ea3.tar.gz
GH #18047: Initial phrasing for =head5 and =head6
Diffstat (limited to 'pod')
-rw-r--r--pod/perlpod.pod16
-rw-r--r--pod/perlpodspec.pod7
2 files changed, 19 insertions, 4 deletions
diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index 9f494a610e..ed227b50dc 100644
--- a/pod/perlpod.pod
+++ b/pod/perlpod.pod
@@ -69,6 +69,8 @@ are
=head2 Heading Text
=head3 Heading Text
=head4 Heading Text
+ =head5 Heading Text
+ =head6 Heading Text
=over indentlevel
=item stuff
=back
@@ -83,8 +85,8 @@ To explain them each in detail:
=over
=item C<=head1 I<Heading Text>>
-X<=head1> X<=head2> X<=head3> X<=head4>
-X<head1> X<head2> X<head3> X<head4>
+X<=head1> X<=head2> X<=head3> X<=head4> X<=head5> X<=head6>
+X<head1> X<head2> X<head3> X<head4> X<head5> X<head6>
=item C<=head2 I<Heading Text>>
@@ -92,7 +94,11 @@ X<head1> X<head2> X<head3> X<head4>
=item C<=head4 I<Heading Text>>
-Head1 through head4 produce headings, head1 being the highest
+=item C<=head5 I<Heading Text>>
+
+=item C<=head6 I<Heading Text>>
+
+Head1 through head6 produce headings, head1 being the highest
level. The text in the rest of this paragraph is the content of the
heading. For example:
@@ -106,6 +112,10 @@ The text in these heading commands can use formatting codes, as seen here:
Such commands are explained in the
"L<Formatting Codes|/"Formatting Codes">" section, below.
+Note that C<head5> and C<head6> were introduced in 2020 and in
+L<Pod::Simple> 3.41, released in October 2020, so they might not be
+supported on the Pod parser you use.
+
=item C<=over I<indentlevel>>
X<=over> X<=item> X<=back> X<over> X<item> X<back>
diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod
index 847c4a9652..7be15853a9 100644
--- a/pod/perlpodspec.pod
+++ b/pod/perlpodspec.pod
@@ -206,7 +206,7 @@ Pod commands:
=over
-=item "=head1", "=head2", "=head3", "=head4"
+=item "=head1", "=head2", "=head3", "=head4", "=head5", "=head6"
This command indicates that the text in the remainder of the paragraph
is a heading. That text may contain formatting codes. Examples:
@@ -215,6 +215,11 @@ is a heading. That text may contain formatting codes. Examples:
=head3 What B<Not> to Do!
+Both C<=head5> and C<=head6> were added in 2020 and might not be
+supported on all Pod parsers. L<Pod::Simple> 3.41 was released on October
+2020 and supports both of these providing support for all
+L<Pod::Simple>-based Pod parsers.
+
=item "=pod"
This command indicates that this paragraph begins a Pod block. (If we