[latex3-commits] [latex3/babel] docs: Revised news 3.49-3-60. (4c419e2)
github at latex-project.org
github at latex-project.org
Sun Oct 22 08:27:34 CEST 2023
Repository : https://github.com/latex3/babel
On branch : docs
Link : https://github.com/latex3/babel/commit/4c419e27f68e3ae572d7e407186b93d0235b7c7c
>---------------------------------------------------------------
commit 4c419e27f68e3ae572d7e407186b93d0235b7c7c
Author: Javier <email at localhost>
Date: Sun Oct 22 08:27:34 2023 +0200
Revised news 3.49-3-60.
>---------------------------------------------------------------
4c419e27f68e3ae572d7e407186b93d0235b7c7c
docs/guides/non-standard-hyphenation-with-luatex.md | 2 +-
docs/news/whats-new-in-babel-3.49.md | 4 +++-
docs/news/whats-new-in-babel-3.51.md | 21 +++++++++++++++++----
docs/news/whats-new-in-babel-3.52.md | 11 ++++++++++-
docs/news/whats-new-in-babel-3.53.md | 3 ++-
docs/news/whats-new-in-babel-3.55.md | 2 +-
docs/news/whats-new-in-babel-3.56.md | 12 +++++++++---
docs/news/whats-new-in-babel-3.57.md | 15 +++++++++++----
docs/news/whats-new-in-babel-3.58.md | 11 ++++++++---
docs/news/whats-new-in-babel-3.59.md | 9 +++++----
docs/news/whats-new-in-babel-3.60.md | 2 +-
docs/news/whats-new-in-babel-3.85.md | 2 +-
docs/news/whats-new-in-babel-3.96.md | 14 +++++++-------
13 files changed, 76 insertions(+), 32 deletions(-)
diff --git a/docs/guides/non-standard-hyphenation-with-luatex.md b/docs/guides/non-standard-hyphenation-with-luatex.md
index 95106f6..7ff512f 100644
--- a/docs/guides/non-standard-hyphenation-with-luatex.md
+++ b/docs/guides/non-standard-hyphenation-with-luatex.md
@@ -1,4 +1,4 @@
-# Non-standard hyphenation with `luatex`
+# Transforms and non-standard hyphenation with `luatex`
Hyphenation in LaTeX is accomplished by means of the so-called
discretionaries. You can find a brief description
diff --git a/docs/news/whats-new-in-babel-3.49.md b/docs/news/whats-new-in-babel-3.49.md
index 6e630bf..fcef731 100644
--- a/docs/news/whats-new-in-babel-3.49.md
+++ b/docs/news/whats-new-in-babel-3.49.md
@@ -21,7 +21,9 @@ Here `provide=*` means ‘load the main language with the `\babelprovide` mechan
(The value will allow in the future other options, as for example `onchar` or `mapdigits`, but for the moment you must restrict yourself to `*`. Also, a similar tool for languages loaded on the fly can be useful, for the reasons explained in [issue #82](https://github.com/latex3/babel/issues/82), but I've left it to a later version.)
-Note `babel` itself is not the responsible to set the languages. It recognizes the options passed by the user as class or package options.
+Note `babel` itself is not the responsible to ‘set’ which languages are
+to be used in the document. It recognizes the options passed by the
+user as class or package options.
## French spacing with `ini` files
diff --git a/docs/news/whats-new-in-babel-3.51.md b/docs/news/whats-new-in-babel-3.51.md
index edc4cd4..d909798 100644
--- a/docs/news/whats-new-in-babel-3.51.md
+++ b/docs/news/whats-new-in-babel-3.51.md
@@ -9,7 +9,9 @@ The way strings for captions are defined has evolved to overcome some limitation
\setlocalecaption{english}{contents}{Table of Contents}
```
-Here the second argument is the caption name as string without the trailing `name`. This example also shows caption names are often a stylistic choice.
+Here the second argument is the caption name as string without the
+trailing `name`. This example also shows caption names are often a
+stylistic choice, not just a language one.
This works not only with existing caption names, because it also serves to define new ones by setting the caption name to the name of your choice (`name` will be postpended, so that `annex` defines `\annexname`). Captions so defined or redefined behave with the ‘new way’ described in the manual (that is, the ‘switcher’ and the captions string are separate macros).
@@ -21,12 +23,23 @@ This works not only with existing caption names, because it also serves to defin
* An error was raised with CJK and a null font (#99) in `luatex`.
* `language.tag.bcp47` and `tag.ini` in `\localeinfo` didn't work (#102).
-## Known issues (and request for help)
+## <del>Known issues (and request for help)</del>
-⚠ As of 2010-10 `layout=graphics` doesn't work with `picture` anymore. I'm investigating how the new code for `pict2e` (v 0.4) works to find a solution (v 0.3 worked), but it can take me some time. Feel free to make a pull request with a fix, if you have found it. (Issue #98). **Workaround**: Instead of `layout=graphics`, add in the preamble `\AddToHook{env/picture/begin}{\bodydir TLT}` and then mark explicitly the text language.
+[**Update.** Fixed both issues.]
+⚠ <del>As of 2010-10 `layout=graphics` doesn't work with `picture`
+anymore. I'm investigating how the new code for `pict2e` (v 0.4) works
+to find a solution (v 0.3 worked), but it can take me some time. Feel
+free to make a pull request with a fix, if you have found it. (Issue
+#98). **Workaround**: Instead of `layout=graphics`, add in the preamble
+`\AddToHook{env/picture/begin}{\bodydir TLT}` and then mark explicitly
+the text language.</del>
-⚠ Some ‘exotic’ combinations like bold + small caps may not work if there is not a global font declaration with `\babelfont{..}{...}` (without the first optional argument). The usual 4 basic combinations should be fine. (Issue #92)
+
+<del>⚠ Some ‘exotic’ combinations like bold + small caps may not work if
+there is not a global font declaration with `\babelfont{...}{...}`
+(without the first optional argument). The usual 4 basic combinations
+should be fine. (Issue #92)</del>
## Changes in `ini` files
diff --git a/docs/news/whats-new-in-babel-3.52.md b/docs/news/whats-new-in-babel-3.52.md
index 398cdfe..802150e 100644
--- a/docs/news/whats-new-in-babel-3.52.md
+++ b/docs/news/whats-new-in-babel-3.52.md
@@ -21,7 +21,16 @@ Penalties can be inserted with both `\babelprehyphenation` and `\babelposthyphen
### Inserted items
-A new key `insert` adds the node before the ‘current’ one, instead of replacing it. It must be the first key in the replacement item specification and works not only with the new `penalty` but also with discretionaries (the latter only with `\babelposthyphenation`). The example above matches 3 items, but there are 4 replacements, so that ‹space-“a”-space› becomes ‹penalty-space-“a”-space›. ⚠ There is currently a limitation, yet – only an item can be inserted at each matched item (in this example, you cannot insert, say, another penalty before the first space).
+A new key `insert` adds the node before the ‘current’ one, instead of
+replacing it. It must be the first key in the replacement item
+specification and works not only with the new `penalty` but also with
+discretionaries (the latter only with `\babelposthyphenation`). The
+example above matches 3 items, but there are 4 replacements, so that
+‹space-“a”-space› becomes ‹penalty-space-“a”-space›. <del>⚠ There is
+currently a limitation, yet – only an item can be inserted at each
+matched item (in this example, you cannot insert, say, another penalty
+before the first space).</del> [**Update.** The limitation was lifted
+in 3.56.]
## Fixes
diff --git a/docs/news/whats-new-in-babel-3.53.md b/docs/news/whats-new-in-babel-3.53.md
index 219be76..a914c67 100644
--- a/docs/news/whats-new-in-babel-3.53.md
+++ b/docs/news/whats-new-in-babel-3.53.md
@@ -9,7 +9,8 @@
\setlocalecaption{japanese}{chapter.template}{[[prechapter]] [chapter] [[postchapter]]}
```
-This new feature is related to issue [#111](https://github.com/latex3/babel/issues/111)
+This new feature is related to issue
+[#111](https://github.com/latex3/babel/issues/111).
## `\babelprovide` with `ldf` files
diff --git a/docs/news/whats-new-in-babel-3.55.md b/docs/news/whats-new-in-babel-3.55.md
index 9338edd..129a29d 100644
--- a/docs/news/whats-new-in-babel-3.55.md
+++ b/docs/news/whats-new-in-babel-3.55.md
@@ -13,7 +13,7 @@ corner and attempts to render RTL text correctly.
## Uyghur
-Tentative captions provided by Osman Tursun (https://github.com/neouyghur).
+Tentative captions provided by [Osman Tursun](https://github.com/neouyghur).
## Fixes
diff --git a/docs/news/whats-new-in-babel-3.56.md b/docs/news/whats-new-in-babel-3.56.md
index efbf294..3bbd0de 100644
--- a/docs/news/whats-new-in-babel-3.56.md
+++ b/docs/news/whats-new-in-babel-3.56.md
@@ -13,6 +13,10 @@ same, because in `babel` they are focused on the typographical level.
Transforms have been available for more than a year, but in this
version they can be defined in `ini`files, too.
+See also
+[Transforms and non-standard hyphenation with
+`luatex`](https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html).
+
## Inserting spaces (with `luatex`)
Some languages require readjusting the space before or after some
@@ -58,11 +62,13 @@ word separation in the font.
```
As you can see, now multiple insertions are allowed, which is often
-necessary when a space is added.
+necessary when a space is added. (No direct relation to TeX
+`\spacefactor`.)
In addition, the code has been refactored, to improve both stability
-with overlapping patterns and speed. There are still some issues to be
-sorted out, like the behavior in verbatim mode.
+with overlapping patterns and speed. <del>There are still some issues to be
+sorted out, like the behavior in verbatim mode.</del> [**Update.**
+Fixed in 3.58.]
## Transforms in `ini` files
diff --git a/docs/news/whats-new-in-babel-3.57.md b/docs/news/whats-new-in-babel-3.57.md
index 5a13671..9958f86 100644
--- a/docs/news/whats-new-in-babel-3.57.md
+++ b/docs/news/whats-new-in-babel-3.57.md
@@ -31,11 +31,12 @@ Devanagari.
Some tentative code has been added to the Uyghur locale for the words
to be hyphenated correctly, preserving the joining forms. See
-https://www.w3.org/TR/css-text-3/#word-break-shaping . It assumes the
+[CSS Text Module Level 3 – Shaping Across Intra-word
+Breaks](https://www.w3.org/TR/css-text-3/#word-break-shaping). It assumes the
basic forms (initial, medial, final).
Here is an example (text copypasted from
-https://github.com/azmat21/Syllabification-for-Uyghur ).
+[Syllabification-for-Uyghur](https://github.com/azmat21/Syllabification-for-Uyghur).
```
\documentclass{article}
@@ -83,11 +84,17 @@ https://github.com/azmat21/Syllabification-for-Uyghur ).
![Uyghur](../media/uyghur-hyphenation.png)
+[**Update**. At the time of this writing (2021) there was some work in
+progress for a set of Uyghur hyphenation rules. Sadly, as of 2023 this
+project seems abandoned.]
+
## Other changes
-* Transforms: {xxxx} syntax also in `string =`, which is replace by the
- character with the given hex code (at least 4 hex digits).
+* Transforms: `{xxxx}` syntax also in `string =`, which is replaced by the
+ character with the given hex code (at least 4 ‘hex digits’).
* `magyar` as alternative name to `hungarian` in `\babelprovide`.
+ [**Update.** But the preferred name is still `hungarian`, per the
+ Unicode CLDR.]
diff --git a/docs/news/whats-new-in-babel-3.58.md b/docs/news/whats-new-in-babel-3.58.md
index 4585877..23d3fce 100644
--- a/docs/news/whats-new-in-babel-3.58.md
+++ b/docs/news/whats-new-in-babel-3.58.md
@@ -9,7 +9,7 @@
**Czech, Polish, Slovak** ▸ `oneletter.nobreak` ▸ Converts a space after a non-syllabic preposition or conjunction into a non-breaking space.
**Hindi, Sanskrit** ▸ `punctuation.space` ▸ Inserts a space before the following
-four characters: `!?:;`. Added `transliteration.hk` for
+four characters: `!?:;`. Added `transliteration.hk` to
Sanskrit, too.
**Serbian** ▸ `transliteration.gajica` ▸ (Note `serbian` with `ini` files refers to the Cyrillic script, which is here the target.) The standard system devised by Ljudevit Gaj.
@@ -21,7 +21,7 @@ hyphenation patterns are `nohyphenation`, so that they aren't applied
in verbatim mode.
This behavior can be switched with:
-```
+```tex
\babeladjust{ prehyphenation.disable = nohyphenation }
\babeladjust{ prehyphenation.disable = off }
```
@@ -54,6 +54,11 @@ could be added in the future, and there is work in progress for
See also [here](whats-new-in-babel-3.57.md) for Uyghur hyphenation.
+[**Update**. An alternative syntax, added later, is:]
+```tex
+\babelprovide[justification = unhyphenated]{<language>}
+```
+
## Arabic justification (experimental)
There is some experimental code for Arabic justification, for
@@ -76,7 +81,7 @@ The preamble used in the previous example is:
\ArabicSetupJust
```
-The last macro is temporary. It will be removed.
+[**Update**. The last macro was temporary. It has been removed.]
## Fixes
diff --git a/docs/news/whats-new-in-babel-3.59.md b/docs/news/whats-new-in-babel-3.59.md
index bd8b55d..93c07ab 100644
--- a/docs/news/whats-new-in-babel-3.59.md
+++ b/docs/news/whats-new-in-babel-3.59.md
@@ -52,8 +52,9 @@ tatwil):
```tex
\babelprehyphenation{arabic}{ () ب () ر }{ kashida = 0 } % 0 = no kashida
```
-Of course, these setting must be also font dependent, but for the
-moment this is what it is.
+Of course, these setting must be also font dependent, [**Update:**] which can be accomplished
+with the syntax described
+[here](https://latex3.github.io/babel/news/whats-new-in-babel-3.85.html#font-dependent-transforms).
As an example of a tranform, the following rule is applied to words
with at least 3 letters. With certain combinations, a (probably long)
@@ -80,7 +81,7 @@ position in the line, and so on).
There is some tolerance in the insertion of kashida, set with (syntax
liable to change!):
-```
+```tex
\directlua{ Babel.arabic.justify_factor = 0.95 }
```
This is the default. 1 means no tolerance. With lower values, there are
@@ -100,7 +101,7 @@ replacement (eg, `{ string = a, step = -1 }`)
behaviour (no break at all). Tailored behavior for specific locales
will be added in a next release, but remenber you can always use
something like:
-```
+```tex
\babelcharproperty{`“}{linebreak}{op}
\babelcharproperty{`”}{linebreak}{cl}
```
diff --git a/docs/news/whats-new-in-babel-3.60.md b/docs/news/whats-new-in-babel-3.60.md
index fd8bd0d..f41ed1f 100644
--- a/docs/news/whats-new-in-babel-3.60.md
+++ b/docs/news/whats-new-in-babel-3.60.md
@@ -7,7 +7,7 @@
This is a fix for a critical bug (#134).
For the languages to be recognized in class options, `babel` used a trick
-which was, admittedly a bit faulty. It used to work, but with the
+which was, admittedly, a bit faulty. It used to work, but with the
latest changes in the LaTeX kernel class options were messed up, and
many documents were spoilt.
diff --git a/docs/news/whats-new-in-babel-3.85.md b/docs/news/whats-new-in-babel-3.85.md
index 4f16e9b..e8fa63f 100644
--- a/docs/news/whats-new-in-babel-3.85.md
+++ b/docs/news/whats-new-in-babel-3.85.md
@@ -61,7 +61,7 @@ always reset with a font selector. Currently they cannot be enabled or
disabled with the macros described in the previous section.
In `\babelprovide`, transform labels can be tagged before its name,
-with a list separated with colonsm like:
+with a list separated with colons, like:
```tex
transforms = rm:sf:transform.name
```
diff --git a/docs/news/whats-new-in-babel-3.96.md b/docs/news/whats-new-in-babel-3.96.md
index 5e0b23b..d01e3b1 100644
--- a/docs/news/whats-new-in-babel-3.96.md
+++ b/docs/news/whats-new-in-babel-3.96.md
@@ -1,9 +1,9 @@
# What's new in babel 3.96
-** Draft **
+**Draft**
Version number is reaching 3.100, so a new numbering schema will be
-introduced in 2024, with the year and a correlative number.
+introduced in 2024, with the year (abbreviated) and a correlative number.
## Improved `onchar`
@@ -13,23 +13,23 @@ text in an English document, so you write:
```tex
\babelprovide[onchar = ids fonts]{serbian}
```
-This handles every Cyrillic letter, including those in something like:
+But this handles every Cyrillic letter, including those in something like:
```
\foreignlanguage{bulgarian}{български}
```
-To avoid it, `onchar` is now applied only if the original and the target scripts
-are different.
+To avoid it, `onchar` is now applied only if the original and the
+target scripts are different.
## Improved Odia
-Thanks to ଅଶୋକ ଦାସ୍ and ଅଭିଷେକ ଜେନା. Captions has been defined, a few
+Thanks to ଅଶୋକ ଦାସ୍ and [ଅଭିଷେକ ଜେନା](https://github.com/avisekjena). Captions has been defined, a few
months have been fixed and there are a couple of alphabetic counters,
namely, `alphabetic` and `akshar`.
## ASCII encoding
-As suggested by Udi Fogiel, with the macro `\asciiencoding` you can
+As suggested by [Udi Fogiel](https://github.com/Udi-Fogiel), with the macro `\asciiencoding` you can
retrieve and modify its value, which is determined by `babel` (it’s the
same used by `\ensureascii`).
More information about the latex3-commits
mailing list.