From ea5f1533cb0ad95a03a0770e3e99fec356ee93e6 Mon Sep 17 00:00:00 2001
From: Eike Rathke <erack@redhat.com>
Date: Sun, 16 Apr 2023 12:54:47 +0200
Subject: Document locale data ReservedWords

Change-Id: Ie7085e437f6c80a7d13c9d01a7259f97ab05649c
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/150454
Reviewed-by: Eike Rathke <erack@redhat.com>
Tested-by: Jenkins
---
 i18npool/source/localedata/data/locale.dtd | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

(limited to 'i18npool')

diff --git a/i18npool/source/localedata/data/locale.dtd b/i18npool/source/localedata/data/locale.dtd
index a867215421bc..616351e19f8f 100644
--- a/i18npool/source/localedata/data/locale.dtd
+++ b/i18npool/source/localedata/data/locale.dtd
@@ -634,18 +634,24 @@
 
 <!ELEMENT ReservedWords  (trueWord, falseWord, quarter1Word, quarter2Word, quarter3Word, quarter4Word, aboveWord, belowWord, quarter1Abbreviation, quarter2Abbreviation, quarter3Abbreviation, quarter4Abbreviation)>
 <!-- order is significant! -->
+<!-- trueWord and falseWord are displayed (uppercased) for the BOOLEAN number
+     format keyword. "true", "false" -->
 <!ELEMENT trueWord (#PCDATA)>
 <!ELEMENT falseWord (#PCDATA)>
+<!-- quarter1Word,... are displayed for the QQ number format keyword.
+     "1st quarter", "2nd quarter", ...; "1er trimestre", "2e trimestre", ... -->
 <!ELEMENT quarter1Word (#PCDATA)>
 <!ELEMENT quarter2Word (#PCDATA)>
 <!ELEMENT quarter3Word (#PCDATA)>
 <!ELEMENT quarter4Word (#PCDATA)>
-<!ELEMENT aboveWord (#PCDATA)>
-<!ELEMENT belowWord (#PCDATA)>
 <!-- aboveWord and belowWord are used as reference field content in Writer, it
      is a "physical" object relative position, not "numerical" relative.
--->
-<!ELEMENT quarter1Abbreviation (#PCDATA)>    <!-- "Q1" (quarter), "T1" (trimestre), ... -->
+     Like section "above" and section "below". -->
+<!ELEMENT aboveWord (#PCDATA)>
+<!ELEMENT belowWord (#PCDATA)>
+<!-- quarter1Abbreviation,... are displayed for the Q number format keyword.
+     "Q1" (quarter), "T1" (trimestre), ... -->
+<!ELEMENT quarter1Abbreviation (#PCDATA)>
 <!ELEMENT quarter2Abbreviation (#PCDATA)>
 <!ELEMENT quarter3Abbreviation (#PCDATA)>
 <!ELEMENT quarter4Abbreviation (#PCDATA)>
-- 
cgit