[latex3-commits] [latex3/babel] docs: 24.10 (faebc2d)
github at latex-project.org
github at latex-project.org
Wed Sep 18 17:26:58 CEST 2024
Repository : https://github.com/latex3/babel
On branch : docs
Link : https://github.com/latex3/babel/commit/faebc2d57745198fc6cf8370375dcdd8b73146dc
>---------------------------------------------------------------
commit faebc2d57745198fc6cf8370375dcdd8b73146dc
Author: Javier <email at localhost>
Date: Wed Sep 18 17:26:58 2024 +0200
24.10
>---------------------------------------------------------------
faebc2d57745198fc6cf8370375dcdd8b73146dc
docs/_includes/menu.html | 1 +
docs/index.md | 2 +-
docs/news/whats-new-in-babel-24.10.md | 61 +++++++++++++++++++++--------------
3 files changed, 39 insertions(+), 25 deletions(-)
diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index c656f92..3de6d47 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-24.10.html">24.10</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.9.html">24.9</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.8.html">24.8</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.7.html">24.7</a></li>
diff --git a/docs/index.md b/docs/index.md
index 0d6667b..a314070 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -48,7 +48,7 @@ case, it's advisable to install TeXLive.)
| Version | Most relevant changes
| --- | --- |
-| [24.10](news/whats-new-in-babel-24.10.html) | `\localename`, `mainlocalename`, `babelhyphenmins` |
+| [24.10](news/whats-new-in-babel-24.10.html) | `\localename`, `\mainlocalename`, `\babelhyphenmins` |
| [24.9](news/whats-new-in-babel-24.9.html) | Transforms: `digits.native`, CJK spacing (tentative). |
| [24.8](news/whats-new-in-babel-24.8.html) | `\BabelWrapText` and hook `foreign`. |
| [24.7](news/whats-new-in-babel-24.7.html) | Improved a few locales: Filipino, Geez, etc. |
diff --git a/docs/news/whats-new-in-babel-24.10.md b/docs/news/whats-new-in-babel-24.10.md
index 58e4b39..f33534b 100644
--- a/docs/news/whats-new-in-babel-24.10.md
+++ b/docs/news/whats-new-in-babel-24.10.md
@@ -1,6 +1,11 @@
# What's new in babel 24.10
-**Draft**
+2024-09-18
+
+<span style="color:red;">⚠</span> For a few years now, a message has
+been reporting the syntax `\selectlanguage{\<language>}` (with a macro
+instead of a name) was deprecated. Now this syntax has been removed
+altogether.
## `\localename`, `\mainlocalename`
@@ -13,18 +18,26 @@ Consider the following document:
\savelanguage$=$\languagename?
\ifx\savelanguage\languagename True\else False!?!?\fi
\end{document}
-```
-Is ‘english’ not the same as ‘english’? As explained in the manual,
+``` Is ‘english’ not the same as ‘english’? As explained in the manual,
there was a bug in `babel` which messed up catcodes. No alternative was
-provided, but now there is one: `\localename`. This name follows
-the new paradigm in `babel`, based on the concept of ‘locale’.
+provided, but now there is one: `\localename`. The name of this macro
+follows the new paradigm in `babel`, based on the concept of ‘locale’
+(like `\localenumeral`, `\localedate`, `\localeinfo`...).
In addition, there is a new macro named `\mainlocalename`, with the
-name of the main language.
+name of the main language. You can retrieve locale properties for the
+main language with, for example:
+```tex
+\getlocaleproperty\frtag{\mainlocalename}{captions/chapter}
+```
+
+They are not available in non-`etex` engines (`pdftex`, `xetex`,
+`luatex` and, of course, `etex` are).
## `\babelhyphenmins`
-(Under development.)
+There is a new command to deal with hyphenation in LaTeX (not available
+in Plain).
```tex
\babelhyphenmins*[<language-list>]{<left>}{<right>}[<hyphenationmin>]
@@ -36,32 +49,32 @@ sets of values, which I’m going to illustrate with Spanish:
* A technical limit imposed by the patterns, especially when they have
been generated with `patgen`. This limit in Spanish is 1/1, because it
- includes patterns like `4b. .b2`. Sadly, this limit is often unknown
- or has been lost.
+ includes patterns like `4b.` and `.b2`. Sadly, this limit is often
+ unknown or has been lost.
* The ‘traditional’ limit marked by typographical conventions in each
country (very likely the same language). Note sometimes there is not
a single convention even in the same country. In Spanish it’s 2/2.
-* The layout. If the text is wide, you can decide to raise the value
- to 2/3 or even 3/3.
+* The layout. If the text box is wide, you can decide to raise the
+ value to 2/3 or even 3/3.
Now, consider a document written in English with some words in other
languages with lower values (in Greek it’s 1/1!). This will lead to
-undesired typographical inconsistencies.
+undesired typographical inconsistencies. In other words, hyphenmins are
+language dependent only to some extent, and having a command to deal
+with them in a more general way can be useful.
-This explains why the language is optional.
+This explains why the first argument with the language list is optional
+– you may want to set the same value for all languages.
The starred version not only adjust the settings in the locales, but
-also sets them at once.
-
-In other words, hyphenmins are language dependent only to some extent,
-and having a command to deal with them in a more general way can be
-useful.
-
-It’s worth noting `\hyphenationmin` is language dependent in the TeX
-sense (it depends, globally, on the current `\language`), while
-`\righthyphenmin` and `\lefthyphenmin` are not (they depend only on the
-group). With this command its value can be unified in the whole
-document.
+also sets them at once (for a temporary local change). It’s not
+compatible with the first optional argument.
+
+It’s worth noting the `luatex` parameter `\hyphenationmin` is language
+dependent in the TeX sense (it depends, globally, on the current
+`\language`), while `\righthyphenmin` and `\lefthyphenmin` are not
+(they depend only on the group). With this command its value can be
+unified in the whole document.
More information about the latex3-commits
mailing list.