[latex3-commits] [git/LaTeX3-latex3-babel] docs: Start 3.77. (07a272b)

[Javier]

Repository : https://github.com/latex3/babel
On branch  : docs
Link       : https://github.com/latex3/babel/commit/07a272b6d27cd3ef30f786f6f6da73ee8a847625

>---------------------------------------------------------------

commit 07a272b6d27cd3ef30f786f6f6da73ee8a847625
Author: Javier <email at localhost>
Date:   Sun Jun 12 13:23:17 2022 +0200

    Start 3.77.


>---------------------------------------------------------------

07a272b6d27cd3ef30f786f6f6da73ee8a847625
 docs/_includes/menu.html             |  1 +
 docs/index.md                        |  1 +
 docs/news/whats-new-in-babel-3.77.md | 66 ++++++++++++++++++++++++++++++++++++
 3 files changed, 68 insertions(+)

diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index 0413a3d..210c98f 100644
--- a/docs/_includes/menu.html
+++ b/docs/_includes/menu.html
@@ -6,6 +6,7 @@
       <!-- -->
       <li><a href="#">News</a>
       <ul>
+        <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.77.html">3.77 (dev)</a></li>
         <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.76.html">3.76</a></li>
         <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.75.html">3.75</a></li>
         <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.74.html">3.74</a></li>
diff --git a/docs/index.md b/docs/index.md
index 273321a..21502ab 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -48,6 +48,7 @@ case, it's advisable to install TeXLive.)
 
 | Version | Most relevant changes
 | --- | --- |
+| [3.77](news/whats-new-in-babel-3.77.html) | More on calendars: `\today`.
 | [3.76](news/whats-new-in-babel-3.76.html) | Calendar converters.
 | [3.75](news/whats-new-in-babel-3.75.html) | `\BabelEnsureInfo` enabled by default. `\localeinfo*`.
 | [3.74](news/whats-new-in-babel-3.74.html) | Mainly fixes and improvements in math.
diff --git a/docs/news/whats-new-in-babel-3.77.md b/docs/news/whats-new-in-babel-3.77.md
new file mode 100644
index 0000000..68a4f97
--- /dev/null
+++ b/docs/news/whats-new-in-babel-3.77.md
@@ -0,0 +1,66 @@
+# What's new in babel 3.77
+
+(*Draft. Under development.* **Syntax liable to change**.)
+
+## More on calendars: `\localedate` and `\today`.
+
+Based on the CLDR and the ICU, now `ini` files contains some information
+on calendars. It’s used to set the default calendar in a few locales. 
+
+`\localedate` now accepts a valueless key named `convert`, which is
+basically syntactical sugar, because all it does is to convert
+arguments with the year, month and day in the gregorian calendar to the
+calendar set with `calendar=`. For example:
+```tex
+\localedate[calendar=islamic-civil, convert]{\year}{\month}{\day}
+```
+This will print the date in the Islamic Civil calendar using the format
+for the `islamic` date in the `ini` file, as loaded by `\babelprovide`.
+
+A new option in `\babelprovide` named calendar sets the defaults to be
+used in `\localedate`, which turn is used in by `\today`. So, if you
+want to apply the settings in the previous example to all dates, you
+may write somthing like:
+```tex
+\babelprovide[import, calendar=islamic-civil]{arabic}
+```
+(Of course, different territory locales can be assigned different
+default calendars.)
+
+[Note. Not sure how the default must apply to `\localedate`. It makes
+sense *not* converting if the data has been generated externally in a
+editing environment where LaTeX is just a component.]
+
+A special notation is used to enter the variant. For example:
+```tex
+\babelprovide[import, calendar=gregorian.izafa]{northernkurdish}
+```
+
+If the calendar is gregorian, you may omit it. A variant in this case
+is just preceded by a dot:
+```tex
+\babelprovide[import, calendar=.izafa]{northernkurdish}
+```
+
+Calendars are, actually, territory based. So the setting are those for
+the region in territory locales (with a region in the BCP 47 tag)
+or the ‘likely’ tag in language locales (without a region).
+
+Note the preferred calendar in the CLDR for the Arabic locales
+currently provided by `babel` is `gregorian`, except `ar-SA` (Saudi
+Arabia), named `arabic-saudi` or `arabic-sa`), which is new in version
+3.77.
+
+<span style="color:red;">⚠</span> Locales for IR (Iran) and AF
+(Afghanistan) now will print the date with the Persian calendar by
+default: Persian, Northern Luri, Mazanderani, Pashto.
+
+## Locales
+
+* As explained above, a new locale for Arabic has been added, namely,
+  `arabic-saudiarabia` (or 'arabic-sa`). By default its calendar is Umm
+  al-Qura.
+
+## Fixes
+
+* The format for the Thai calendar was incorrect.