[latex3-commits] [git/LaTeX3-latex3-babel] docs: More on 3.87. Changes wrt `\babelposthyphenation` (wip). (d9ccf43)

[Javier]

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

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

commit d9ccf438c58d9f2c521a4643ab2091f8ed8b2aab
Author: Javier <email at localhost>
Date:   Sun Mar 26 09:10:10 2023 +0200

    More on 3.87. Changes wrt `\babelposthyphenation` (wip).


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

d9ccf438c58d9f2c521a4643ab2091f8ed8b2aab
 .../guides/non-standard-hyphenation-with-luatex.md | 27 ++++++++++++++++------
 docs/index.md                                      |  1 +
 docs/news/whats-new-in-babel-3.87.md               | 21 ++++++++---------
 3 files changed, 30 insertions(+), 19 deletions(-)

diff --git a/docs/guides/non-standard-hyphenation-with-luatex.md b/docs/guides/non-standard-hyphenation-with-luatex.md
index 59618da..22ac705 100644
--- a/docs/guides/non-standard-hyphenation-with-luatex.md
+++ b/docs/guides/non-standard-hyphenation-with-luatex.md
@@ -1,15 +1,28 @@
 # Non-standard hyphenation with `luatex`
 
-
-Here is a simple example of a declaration:
+Hyphenation in LaTeX is accomplished by means of the so-called
+discretionaries. You can find a brief description
+[here](http://latexref.xyz/Line-breaking.html).
+
+This article describes an extension which can serve to several
+purposes, particularly dealing with non-standard hyphenation rules,
+including changes in letters and weighted hypenation points.
+(Note `luatex` currently provides built-in ways the deal with some
+frequent cases, too. Please, refer to its manual for further
+information.)
+
+Here is a simple example of a declaration, which tell LaTeX to change
+the group ‘ck’ to ‘kk’ if the hyphenation point falls inside this group
+(it’s not meant as a full rule for German, just a starting
+point).
 ```tex
-\babelposthyphenation{ngerman}{ck}{
+\babelposthyphenation{german}{ck}{
   { no = c, pre = k- },
   {}
 }
 ```
 It consists of:
-* the language the transformation is applied to (here `ngerman`);
+* the language the transformation is applied to (here `german`);
 * a pattern with the string to be handled (here `ck`);
 * a replacement with a list containing exactly the same number of
   elements as the pattern (except if there are inserted elements, as
@@ -23,9 +36,9 @@ nil's if shorter.)
 
 ## Rules
 
-‘Automatic’ hyphenation points, as inserted by the hyphenation
+‘Regular’ hyphenation points, as inserted automatically by the hyphenation
 algorithm, are entered in the pattern as vertical bars (`|`). Explicit
-hyphens are entered as `=`. Spaces are allowed for clarity, but they
+hyphens are entered as `=`. Spaces are allowed for clarity, and they
 are discarded.
 
 The items in the replacement list are of four kinds:
@@ -42,7 +55,7 @@ captured) they will the taken from.
 3. The key `string` replaces the character with the string. If empty,
 the char node is removed; to insert chars, just use a multi-character
 string. The nodes created are literal copies of the original, but with
-new characters.
+the new characters.
 4. With `remove` the node is, well, removed (ie, it's like and empty
 `string=`).
 5. **Spaces** are declared with something like `space =.2
diff --git a/docs/index.md b/docs/index.md
index 966548e..e92fdf0 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.87](news/whats-new-in-babel-3.87.html) | (Development.) Mainly fixes and minor improvements. |
 | [3.86](news/whats-new-in-babel-3.86.html) | `tabular` improved. |
 | [3.85](news/whats-new-in-babel-3.85.html) | Font-dependent transforms. |
 | [3.84](news/whats-new-in-babel-3.84.html) | Auto-selection of encodings in `pdftex`. |
diff --git a/docs/news/whats-new-in-babel-3.87.md b/docs/news/whats-new-in-babel-3.87.md
index 587802e..06bb974 100644
--- a/docs/news/whats-new-in-babel-3.87.md
+++ b/docs/news/whats-new-in-babel-3.87.md
@@ -4,30 +4,27 @@
 
 ## `hyphenrules`
 
-Now changes made in `\babelprovide` with `hyphenrules=` are immediately
+Now changes made with `hyphenrules=` in `\babelprovide` are immediately
 applied if the modified locale is the current one. Formerly, they where
-just set (not applied), but the new behavior seems the expected one.
-Although it’s a backaward incompetible changes yje the current locale is the same 
+just set (not applied), but the new behavior seems to be the expected
+one. It’s a backwards incompatible change, but I don’t think this will
+pose too many problems.
 
 ## Fixes
 
+* Text misplaced with tikz. Fixed thanks to Salim Bou (#211).
 
-Language leakage with xetex, on-the-fly loading in a few
-          locales. 
-
-Text misplaced with tikz. #211
-
-When a unhyphenated language (with `prehyphenchar` set to 0) was loaded
+* When a unhyphenated language (with `prehyphenchar` set to 0) was loaded
 on the fly, there was a language leakage, so that `\foreinglanguage{..}{..}`
 didn’t restore the surrounding language.
 
-With the `multicol` package and RTL text, the page body was sometimes
+* With the `multicol` package and RTL text, the page body was sometimes
 shifted off the page (#228).
 
-Typo in 'syllable' counter name in Korean (it read mistakenly
+* Typo in the `syllable` counter name in Korean (it read mistakenly
 `syllabe`).
 
-There is a minor change in the way transforms deal with added
+* There is a minor change in the way transforms deal with added
 discretionaries (technically, they are now of subtype `regular` instead
 of `discretionary`). The new value makes more sense and the result
 should be the same im most cases, except in some edge cases, where the