[latex3-commits] [latex3/babel] docs: 24.8 (54ef904)

[github at latex-project.org]

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

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

commit 54ef904bb9833a35da65bce6a4f6c792d73eb3fc
Author: Javier <email at localhost>
Date:   Sun Aug 18 12:36:21 2024 +0200

    24.8


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

54ef904bb9833a35da65bce6a4f6c792d73eb3fc
 docs/_includes/menu.html             |  1 +
 docs/index.md                        |  2 +-
 docs/news/whats-new-in-babel-24.8.md | 36 ++++++++++++++++++++++--------------
 3 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index 28fa783..6c9488b 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.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>
         <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.6.html">24.6</a></li>
         <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.5.html">24.5</a></li>
diff --git a/docs/index.md b/docs/index.md
index a190b8d..7bca495 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.8](news/whats-new-in-babel-24.8.html) | (dev) `\BabelWrapText` and hook `foreign`. |
+| [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. |
 | [24.6](news/whats-new-in-babel-24.6.html) | Improved transforms: `kern`, `norule`, `after`. |
 | [24.5](news/whats-new-in-babel-24.5.html) | Minor changes and fixes. |
diff --git a/docs/news/whats-new-in-babel-24.8.md b/docs/news/whats-new-in-babel-24.8.md
index 5d0878e..496a611 100644
--- a/docs/news/whats-new-in-babel-24.8.md
+++ b/docs/news/whats-new-in-babel-24.8.md
@@ -1,16 +1,16 @@
-# What's new in babel 24.7
+# What's new in babel 24.8
 
-**Draft**
+2024-08-18
 
 There is a minimal internal change in the lua algorithm for bidi,
 just a few lines of code, to improve how it’s applied in horizontal
-boxes. See issue #25.
+boxes. See [issue #25](https://github.com/latex3/babel/issues/25).
 
-## New hook foreign
+## New hook `foreign`
 
-Actually it’s not new, but it wasn’d documented because the interface
-was not finished. Now it’s and you can define actions to be executed at
-`\begindocument` and also manipulate the string with a new command
+Actually it’s not new, but it wasn’t documented because its interface
+was not finished. Now it is and you can define actions to be executed at
+`\begindocument`, as well as manipulate the string with a new command
 `\BabelWrapText`.
 
 Here is an example:
@@ -19,15 +19,23 @@ Here is an example:
 \AddBabelHook[danish]{two}{foreign}{\BabelWrapText{(##1)}}
 ```
 `##1` is the string, ie, the second mandatory argument in
-`\foreignlanguage`, and it's first wrapped with `[]`, and the result is
-in turn wrapped with `()`, so that we get `([...])` (where `...` is the
-string).
+`\foreignlanguage`, and it's first wrapped with `[]`; the result in
+turn is used to wrap the second declaration, with `()` , so that we get
+`[(...)]` (where `...` is the string). In other words, the last
+definition is the innermost one, and therefore here `##1` is the
+original string (something you have to bear in mind if tokens have to
+be parsed somehow).
+
+Without the optional argument, it’s applied to all languages.
+
+There is an internal macro named `\BabelText`, which can by used to
+define directly what to do with the string (eg, with `\def`). It can be
+useful in some cases, but the best option is to stick to
+`\BabelWrapText`.
 
-Without the optional argument, it’s applied to all languages
+## Improvements in locales
 
-There is an internal macro named `\BabelText`, which can by used de
-define directly what to do with the string. It can be useful in some
-cases, but the best option is to stick to `\BabelWrapText`. 
+Some cleaning up in a few locales, thanks to [Stephen Huan](https://github.com/stephen-huan).