diff options
| author | Sawyer X <xsawyerx@cpan.org> | 2020-09-25 23:25:27 +0200 |
|---|---|---|
| committer | Karl Williamson <khw@cpan.org> | 2021-07-03 13:34:35 -0700 |
| commit | ee5117509fdb6ed3324e9d129ac0de08d9873ea3 (patch) | |
| tree | 399f27f0bd25907862d0076103e10573dd5da683 /pod | |
| parent | 310f47b68123831258bf28d4105fd80f8ed59430 (diff) | |
| download | perl-ee5117509fdb6ed3324e9d129ac0de08d9873ea3.tar.gz | |
GH #18047: Initial phrasing for =head5 and =head6
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/perlpod.pod | 16 | ||||
| -rw-r--r-- | pod/perlpodspec.pod | 7 |
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 |