Document that U<text> is the formatting code for underline

Perl · Jul 30, 2024 · 918b24d · 918b24d
1 parent 963e0b1
commit 918b24d
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/pod/perlpod.pod b/pod/perlpod.pod
@@ -380,6 +380,13 @@ Used for switches ("C<perl's BE<lt>-nE<gt> switch>"), programs
 emphasis ("C<be BE<lt>careful!E<gt>>"), and so on
 ("C<and that feature is known as BE<lt>autovivificationE<gt>>").
 
+=item C<UE<lt>textE<gt>> -- underline text
+
+This is a new addition in 2024 and may not be available in all processors or
+output formats.  Note further that some output formats cannot produce both
+italic and underline formatting and therefore even if both are recognised,
+they may not be visually distinct from each other.
+
 =item C<CE<lt>codeE<gt>> -- code text
 X<C> X<< CZ<><> >> X<POD, formatting code, code> X<code>
 

diff --git a/pod/perlpodspec.pod b/pod/perlpodspec.pod
@@ -467,6 +467,12 @@ See the brief discussion in L<perlpod/"Formatting Codes">.
 
 See the brief discussion in L<perlpod/"Formatting Codes">.
 
+=item C<UE<lt>textE<gt>> -- underline text
+
+See the brief discussion in L<perlpod/"Formatting Codes">.
+
+This was added in 2024 and might not be supported on all Pod parsers.
+
 =item C<CE<lt>codeE<gt>> -- code text
 
 See the brief discussion in L<perlpod/"Formatting Codes">.