From 0e833af1bb1151eaf5efc3174c87b389c6588ddb Mon Sep 17 00:00:00 2001
From: martindholmes <mholmes@uvic.ca>
Date: Thu, 16 Apr 2026 11:16:49 -0700
Subject: [PATCH] Fix for issue #2876: deprecate the use of valList as a direct
 child of elementSpec.

---
 P5/Source/Specs/elementSpec.xml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/P5/Source/Specs/elementSpec.xml b/P5/Source/Specs/elementSpec.xml
index ca2c991de6..ffb9ab56ce 100644
--- a/P5/Source/Specs/elementSpec.xml
+++ b/P5/Source/Specs/elementSpec.xml
@@ -134,6 +134,13 @@
       </elementSpec>
     </egXML>
   </exemplum>
+  <remarks xml:lang="en" versionDate="2026-04-16" validUntil="2027-09-01">
+    <p><gi>elementSpec</gi> currently allows <gi>valList</gi> as a direct child,
+    but this usage is deprecated and will be removed on 2027-09-01. 
+    If a <gi>valList</gi> is used to specify the content model of an element,
+    it should be placed inside the <gi>content</gi> child of the 
+    <gi>elementSpec</gi>.</p>
+  </remarks>
   <listRef>
     <ptr target="#TDTAG"/>
     <ptr target="#TD"/>