From f00bc6c171f47fb72cbb0c6ad093095079d713e1 Mon Sep 17 00:00:00 2001
From: Karl Williamson <khw@cpan.org>
Date: Wed, 20 Nov 2024 11:19:37 -0700
Subject: [PATCH] perlpodspec: Note t that "=item *" has nothing else

=item * foo bar

is not supposed to be a bullet list; it is a text (definition) list
whose first character is an asterisk.

This is implied later on in the existing documentation where it says
that

 The "=item [text]" paragraph should not match
 C<m/\A=item\s+\d+\.?\s*\z/> or C<m/\A=item\s+\*\s*\z/>, nor should it
 match just C<m/\A=item\s*\z/>.

The text already says numbered lists must match
<m/\A=item\s+\d+\.?\s*\z/.  This commit adapts that text to the bullet
list case.
---
 pod/perlpodspec.pod | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod
index d576228a7c51..5874632f43ad 100644
--- a/pod/perlpodspec.pod
+++ b/pod/perlpodspec.pod
@@ -1425,9 +1425,9 @@ Each "=over" ... "=back" region should be one of the following:
 
 =item *
 
-An "=over" ... "=back" region containing only "=item *" commands,
-each followed by some number of ordinary/verbatim paragraphs, other
-nested "=over" ... "=back" regions, "=for..." paragraphs, and
+An "=over" ... "=back" region containing only C<m/\A=item\s+\*\s*\z/>
+commands, each followed by some number of ordinary/verbatim paragraphs,
+other nested "=over" ... "=back" regions, "=for..." paragraphs, and
 "=begin"..."=end" regions.
 
 (Pod processors must tolerate a bare "=item" as if it were "=item