[latex3-commits] [latex3/babel] docs: Document \BabelUppercaseMapping (and Lower). (76c532e)

[github at latex-project.org]

Repository : https://github.com/latex3/babel
On branch  : docs
Link       : https://github.com/latex3/babel/commit/76c532eadcb8e7df19e88947c06be186e8fe5e0d

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

commit 76c532eadcb8e7df19e88947c06be186e8fe5e0d
Author: Javier <email at localhost>
Date:   Sat Jun 24 19:05:13 2023 +0200

    Document \BabelUppercaseMapping (and Lower).


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

76c532eadcb8e7df19e88947c06be186e8fe5e0d
 docs/contact.md                      | 11 ++++++--
 docs/news/whats-new-in-babel-3.90.md | 54 +++++++++++++++++++++++++++++++++---
 2 files changed, 59 insertions(+), 6 deletions(-)

diff --git a/docs/contact.md b/docs/contact.md
index 4c18fee..5ff4157 100644
--- a/docs/contact.md
+++ b/docs/contact.md
@@ -1,3 +1,10 @@
-Testing
+The recommended way to report bug or make suggestions is the issue
+tracker. If for some reason you can’t or don’t want to use it, you can
+contact with the following form. 
 
- <iframe src="https://docs.google.com/forms/d/e/1FAIpQLSd9FL2BT_P48WeEkl-SPXSWmmAIUBG6ww4_XlRI7lqMwFJm7w/viewform?embedded=true" width="640" height="1000" frameborder="0" marginheight="0" marginwidth="0">Loading…</iframe>
\ No newline at end of file
+I regret I don’t answer questions about how to use `babel` (or about
+how to use TeX or LaTeX), which are best addressed to public forums,
+like <a href="https://tex.stackexchange.com/">TeX Stack Exchange</a>
+(which I read regularly).
+
+ <iframe src="https://docs.google.com/forms/d/e/1FAIpQLSd17Nn6p51we43czXh4anGL6anR_TjGAuVu4sG06XWTa_LqZg/viewform?embedded=true" width="640" height="1000" frameborder="0" marginheight="0" marginwidth="0">Loading…</iframe>
\ No newline at end of file
diff --git a/docs/news/whats-new-in-babel-3.90.md b/docs/news/whats-new-in-babel-3.90.md
index d1a3df6..773469f 100644
--- a/docs/news/whats-new-in-babel-3.90.md
+++ b/docs/news/whats-new-in-babel-3.90.md
@@ -2,12 +2,58 @@
 
 **Draft**
 
-## Improvements in Arbic justification
+## Casing
+
+The option `casing` introduced experimentally in version 3.88 should
+work. Here is again the explanation
+
+There is a new option in `\babelprovide` to set the default casing
+rules in a few languages. They are (from `interface3.pdf`):
+* Armenian: `yiwn`, which maps U+0587 to capital ech and yiwn on
+  uppercasing.
+* German: `eszett`, which maps the lowercase *Eszett* to a *großes
+  Eszett*.
+* Greek: `iota`, which converts the *ypogegrammeni* (subscript muted
+  iota) to capital iota when uppercasing.
+
+For example:
+```tex
+\usepackage[greek]{babel}
+\babelprovide[casing=iota]{greek}
+```
+
+New in 3.90 is a few of macros devised as a high level interface for
+declaring case mappings, based on the locale name as declared by or
+with `babel`. They are the equivalent of `\DeclareUppercaseMapping` and
+`\DeclareLowercaseMapping` (see `usrguide.pdf`):
+
+* `\BabelUppercaseMapping{<locale name>}{<codepoint>}{<output>}`
+* `\BabelLowercaseMapping{<locale name>}{<codepoint>}{<output>}`
+
+(TODO: Titlecase)
+
+The purpose is twofold:
+* A user-friendly way to declare them, because often BCP 47 tags are not
+  known (and sometimes can be complex).
+* If for some reason the tag changes (eg, you decide to tag `english`
+  as `en-001` instead of `en-US`), the new mappings will be still
+  assigned to that language.
+  
+For example:
+```
+\BabelUppercaseMapping{medievallatin}{`u}{V}
+```
+
+There are still some rough edges when declaring a mapping with the `x`
+extension, or when two `babel` languages share the same BCP 47 tag. These
+issues will be sorted out in future releases. 
+
+## Improvements in Arabic justification
 
 Kashida are built by adding the Unicode ARABIC TATWEEL character. Now a
-limit can be set with ... Its design can vary greatly with the font,
-and so does the exact value of this parameter (which is currently
-global).
+limit can be set with ... The width of the glyph can vary greatly with
+the font, and so does the exact value of this parameter (which is
+currently global).
 
 ## Locale names