[latex3-commits] [latex3/babel] docs: More on locale naming (sources, list of deprecated names). (cff00cc)

[github at latex-project.org]

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

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

commit cff00cc51f667b3dd13ed5de80e792ee301d9a30
Author: Javier <email at localhost>
Date:   Sat May 27 18:32:52 2023 +0200

    More on locale naming (sources, list of deprecated names).


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

cff00cc51f667b3dd13ed5de80e792ee301d9a30
 docs/guides/locale-naming.md | 43 ++++++++++++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 13 deletions(-)

diff --git a/docs/guides/locale-naming.md b/docs/guides/locale-naming.md
index ba63723..2d11c19 100644
--- a/docs/guides/locale-naming.md
+++ b/docs/guides/locale-naming.md
@@ -24,7 +24,11 @@ registry (eg, `polytonicgreek`), although some simplifications can be
 necessary, because some names are “too” descriptive. See also the
 [templates](https://github.com/latex3/babel/tree/main/locale-templates)
 for about 500 locales already available. As a secondary source,
-[Glottolog](https://glottolog.org/) is used, too.
+[Glottolog](https://glottolog.org/) is used, too. (Wikipedia articles
+can be taken as a complementary but unreliable source, and its
+information must be verified; on the other hand, internal data, like
+[this one](https://en.wikipedia.org/wiki/Module:Lang/data), is
+useful for both names and tags.)
 
 A few locales with a region or a script have in the CLDR a more precise
 name. For example, `ro-MD` is “Moldavian”. They will be normalized in
@@ -34,17 +38,30 @@ When there are ‘short’ additional names (without hyphens), prefer
 ‘plain’ demonyms (even if vernacular) over composed names (eg,
 `british` better than `UKenglish`). This reflects the evolution of the
 `english` style, because the names `american` and `british` predate
-`USenglish` and `UKenglish`. Note the names `ukenglish` and `usenglish`
-(all lowercase) are *not* supported by `babel`, even if they work in
-some operating systems.
-
-The following names are deprecated: `brazil` (for `brazilian`),
-`bahasai` (for `indonesian`), `bahasam` (for `malay`), `frenchb`,
-`francais`, `canadien` (for `french`), lsorbian (for `lowersorbian`),
-`newzealand`, `portuges` [*sic*] (for `portuguese`), usorbian (for
-`uppersorbian`), `vietnam` (for `vietnamese`), `russianb` (for
-`russian`). Therefore, they are not included in `name.babel`. Some
-anomalous names (related to `german` and `serbian`) should be fixed in
-the future, but how to deal with them is under study.
+`USenglish` and `UKenglish`. Further, the main names in the CLDR for
+`en-US` and `en-GB` are `American English` and `British English`. Note
+the names `ukenglish` and `usenglish` (all lowercase) are *not*
+supported by `babel` as `ldf` files, even if they work in some
+operating systems.
+
+The following names are deprecated (use the name after the arrow):
+* `brazil` → `brazilian`
+* `bahasai` → `indonesian`
+* `bahasam`, `meyalu` [*sic*] → `malay`
+* `classiclatin` → `classicallatin`
+* `ecclesiasticlatin` → `ecclesiasticallatin`
+* `frenchb`, `francais`, `canadien` → `french`
+* `germanb` → `german`, `ngerman` (see below)
+* `lsorbian` → `lowersorbian`
+* `portuges` [*sic*] → `portuguese`
+* `samin` → `northernsami` 
+* `ukraineb` → `ukrainian`
+* `usorbian` → `uppersorbian`
+* `vietnam` → `vietnamese`
+* `russianb` → `russian`
+
+Therefore, they are not included in `name.babel`. Some anomalous names
+(related to `german` and `serbian`) should be fixed in the future, but
+how to deal with them is under study.