From 038e989d0bce010f347bc1964aeef77c17ed86a8 Mon Sep 17 00:00:00 2001
From: frosch <frosch@openttd.org>
Date: Sun, 28 Jan 2024 01:25:59 +0100
Subject: [PATCH] Add: Support for time-unit parameters from OpenTTD#11341.
 (#168)

---
 docs/manual/string_commands.rst      | 106 ++++++++++++++-------------
 webtranslate/parameter_info_table.py |   5 ++
 2 files changed, 60 insertions(+), 51 deletions(-)

diff --git a/docs/manual/string_commands.rst b/docs/manual/string_commands.rst
index 587399c..0399f4d 100644
--- a/docs/manual/string_commands.rst
+++ b/docs/manual/string_commands.rst
@@ -149,55 +149,59 @@ Formatting Code <http://www.unicode.org/unicode/reports/tr9/#Directional_Formatt
 Positional GameScript string commands
 =====================================
 
-====================== ====== ==============================================================
-Command                Plural Effect
-====================== ====== ==============================================================
-``{COLOUR}``              no  Change the colour for following text.
-``{STRING1}``             no  Replaced by {STRING} in the translation.
-``{STRING2}``             no  Replaced by {STRING} in the translation.
-``{STRING3}``             no  Replaced by {STRING} in the translation.
-``{STRING4}``             no  Replaced by {STRING} in the translation.
-``{STRING5}``             no  Replaced by {STRING} in the translation.
-``{STRING6}``             no  Replaced by {STRING} in the translation.
-``{STRING7}``             no  Replaced by {STRING} in the translation.
-``{INDUSTRY}``            no  Industry, takes an industry number.
-``{CARGO_LONG}``          no
-``{CARGO_SHORT}``         no  Short cargo description, only ``### tons``, or ``### litres``.
-``{CARGO_TINY}``          no  Tiny cargo description with only the amount.
-``{CARGO_LIST}``          no
-``{POWER}``               no
-``{POWER_TO_WEIGHT}``     no
-``{VOLUME_LONG}``         no
-``{VOLUME_SHORT}``        no
-``{WEIGHT_LONG}``         no
-``{WEIGHT_SHORT}``        no
-``{FORCE}``               no
-``{VELOCITY}``            no
-``{HEIGHT}``              no
-``{DATE_TINY}``           no
-``{DATE_SHORT}``          no
-``{DATE_LONG}``           no
-``{DATE_ISO}``            no
-``{STRING}``              no
-``{RAW_STRING}``          no  Replaced by {STRING} in the translation.
-``{COMMA}``              yes  Number with comma.
-``{DECIMAL}``            yes  Number with comma and fractional part.
-``{NUM}``                yes  Signed number.
-``{ZEROFILL_NUM}``       yes  Unsigned number with zero fill, e.g. ``02``.
-``{BYTES}``              yes  Unsigned number with "bytes", i.e. ``1.02 MiB`` or ``123 KiB``.
-``{HEX}``                yes  Hexadecimally printed number.
-``{CURRENCY_LONG}``      yes
-``{CURRENCY_SHORT}``     yes  Compact currency.
-``{WAYPOINT}``            no
-``{STATION}``             no
-``{DEPOT}``               no
-``{TOWN}``                no
-``{GROUP}``               no
-``{SIGN}``                no
-``{ENGINE}``              no
-``{VEHICLE}``             no
-``{COMPANY}``             no
-``{COMPANY_NUM}``         no
-``{PRESIDENT_NAME}``      no
-====================== ====== ==============================================================
+============================ ====== ============================================================================
+Command                      Plural Effect
+============================ ====== ============================================================================
+``{COLOUR}``                    no  Change the colour for following text.
+``{STRING1}``                   no  Replaced by {STRING} in the translation.
+``{STRING2}``                   no  Replaced by {STRING} in the translation.
+``{STRING3}``                   no  Replaced by {STRING} in the translation.
+``{STRING4}``                   no  Replaced by {STRING} in the translation.
+``{STRING5}``                   no  Replaced by {STRING} in the translation.
+``{STRING6}``                   no  Replaced by {STRING} in the translation.
+``{STRING7}``                   no  Replaced by {STRING} in the translation.
+``{INDUSTRY}``                  no  Industry, takes an industry number.
+``{CARGO_LONG}``                no
+``{CARGO_SHORT}``               no  Short cargo description, only ``### tons``, or ``### litres``.
+``{CARGO_TINY}``                no  Tiny cargo description with only the amount.
+``{CARGO_LIST}``                no
+``{POWER}``                     no
+``{POWER_TO_WEIGHT}``           no
+``{VOLUME_LONG}``               no
+``{VOLUME_SHORT}``              no
+``{WEIGHT_LONG}``               no
+``{WEIGHT_SHORT}``              no
+``{FORCE}``                     no
+``{VELOCITY}``                  no
+``{HEIGHT}``                    no
+``{UNITS_DAYS_OR_SECONDS}``     no  Time duration in days or seconds, depending on timekeeping units setting.
+``{UNITS_MONTHS_OR_MINUTES}``   no  Time duration in months or minutes, depending on timekeeping units setting.
+``{UNITS_YEARS_OR_PERIODS}``    no  Time duration in years or periods, depending on timekeeping units setting.
+``{UNITS_YEARS_OR_MINUTES}``    no  Time duration in years or minutes, depending on timekeeping units setting.
+``{DATE_TINY}``                 no
+``{DATE_SHORT}``                no
+``{DATE_LONG}``                 no
+``{DATE_ISO}``                  no
+``{STRING}``                    no
+``{RAW_STRING}``                no  Replaced by {STRING} in the translation.
+``{COMMA}``                    yes  Number with comma.
+``{DECIMAL}``                  yes  Number with comma and fractional part.
+``{NUM}``                      yes  Signed number.
+``{ZEROFILL_NUM}``             yes  Unsigned number with zero fill, e.g. ``02``.
+``{BYTES}``                    yes  Unsigned number with "bytes", i.e. ``1.02 MiB`` or ``123 KiB``.
+``{HEX}``                      yes  Hexadecimally printed number.
+``{CURRENCY_LONG}``            yes
+``{CURRENCY_SHORT}``           yes  Compact currency.
+``{WAYPOINT}``                  no
+``{STATION}``                   no
+``{DEPOT}``                     no
+``{TOWN}``                      no
+``{GROUP}``                     no
+``{SIGN}``                      no
+``{ENGINE}``                    no
+``{VEHICLE}``                   no
+``{COMPANY}``                   no
+``{COMPANY_NUM}``               no
+``{PRESIDENT_NAME}``            no
+============================ ====== ============================================================================
 
diff --git a/webtranslate/parameter_info_table.py b/webtranslate/parameter_info_table.py
index 24ca361..01d865a 100644
--- a/webtranslate/parameter_info_table.py
+++ b/webtranslate/parameter_info_table.py
@@ -116,6 +116,11 @@
     ParameterInfo("FORCE",             [PP_],      0,    False, True ),
     ParameterInfo("VELOCITY",          [PP_],      0,    False, True ),
     ParameterInfo("HEIGHT",            [PP_],      0,    False, True ),
+    ParameterInfo("UNITS_DAYS_OR_SECONDS",   [PP_], 0,   False, True ),
+    ParameterInfo("UNITS_MONTHS_OR_MINUTES", [PP_], 0,   False, True ),
+    ParameterInfo("UNITS_YEARS_OR_PERIODS",  [PP_], 0,   False, True ),
+    ParameterInfo("UNITS_YEARS_OR_MINUTES",  [PP_], 0,   False, True ),
+
     ParameterInfo("DATE_TINY",         [P__],      None, False, True ),
     ParameterInfo("DATE_SHORT",        [P__],      None, True,  True ),
     ParameterInfo("DATE_LONG",         [P__],      None, True,  True ),