From 7f778345977745b193c51e27f5d0d4383b674b5a Mon Sep 17 00:00:00 2001
From: "Paul \"LeoNerd\" Evans" <leonerd@leonerd.org.uk>
Date: Fri, 22 Sep 2023 15:58:11 +0100
Subject: [PATCH] Document that U<text> is the formatting code for underline

---
 pod/perlpod.pod     | 7 +++++++
 pod/perlpodspec.pod | 6 ++++++
 2 files changed, 13 insertions(+)

diff --git a/pod/perlpod.pod b/pod/perlpod.pod
index ed227b50dc362..69f581393eea2 100644
--- 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 2023 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 disctinct 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
index ca09d28555d3f..dc0363b74c702 100644
--- 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 2023 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">.