From b7fe8d8ebcda066babe8e5555bb6f13e8fd1e271 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20=E2=80=9Cpep=E2=80=9D=20Buquet?= <pep@bouah.net>
Date: Thu, 24 Sep 2020 19:16:48 +0200
Subject: [PATCH] XEP-0060: Add integer-or-max datatype to use with Data Forms
 Validation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Maxime “pep” Buquet <pep@bouah.net>
---
 xep-0060.xml | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/xep-0060.xml b/xep-0060.xml
index 8c724a90..33d82a12 100644
--- a/xep-0060.xml
+++ b/xep-0060.xml
@@ -49,6 +49,12 @@
   &pgmillard;
   &stpeter;
   &ralphm;
+  <revision>
+    <version>1.20.0</version>
+    <date>2021-06-08</date>
+    <initials>pep</initials>
+    <remark><p>Add integer-or-max datatype to use with Data Forms Validation.</p></remark>
+  </revision>
   <revision>
     <version>1.19.1</version>
     <date>2021-03-04</date>
@@ -5911,6 +5917,29 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=subscribe;node=princely_musings
 xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings;item=ae890ac52d0df67ed7cfdf51b644e901
 ]]></example>
   </section2>
+
+  <section2 topic='Integration with Data Forms' anchor='usecase.xdata'>
+    <p>This section defines a datatype "integer-or-max" to be used with &xep0122;. An implementation may use this type to validate fields such as "pubsub#children_max", "pubsub#item_expire" or "pubsub#max_items".</p>
+    <code><![CDATA[
+<xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema' targetNamespace="http://jabber.org/protocol/pubsub#integer-or-max">
+  <xs:simpleType name='integer-or-max'>
+    <xs:union>
+      <xs:simpleType>
+        <xs:restriction base='integer'/>
+      </xs:simpleType>
+      <xs:simpleType>
+        <xs:restriction base='string'>
+          <xs:enumeration value='max'/>
+        </xs:restriction>
+      </xs:simpleType>
+    </xs:union>
+  </xs:simpleType>
+</xs:schema>
+]]></code>
+    <p>The meaning of a value of this type is defined in each field named above.</p>
+    <p>When the <link url='xep-0122.html#usecases-validation.range'>&lt;range/&gt; element</link> is used in combination with this datatype, it applies to the integer value.</p>
+  </section2>
+
 </section1>
 
 <section1 topic='Internationalization Considerations' anchor='i18n'>
@@ -6658,6 +6687,20 @@ xmpp:pubsub.shakespeare.lit?pubsub;action=retrieve;node=princely_musings
     </key>
   </keys>
 </querytype>
+]]></code>
+  </section2>
+
+  <section2 topic='Data Forms Validation Datatypes' anchor='registrar.xdata-validate'>
+    <p>The following datatype shall be registered for use with Data Forms Validation:</p>
+    <code caption='Data Forms Validation Datatypes Registry Submission'><![CDATA[
+<datatype>
+  <name>integer-or-max</name>
+    <desc>
+      Datatype used for text-single fields where the accepted value is
+      either an integer or the string "max".
+    </desc>
+    <doc>XEP-0060</doc>
+</datatype>
 ]]></code>
   </section2>
 </section1>