[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/07: [docs]: Update to reflect reversion of 12434c13.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/07: [docs]: Update to reflect reversion of 12434c13. |
Date: |
Sat, 10 Jul 2021 04:04:03 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 5b5307bf34277279c292599770c7241ebc6e1af6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jul 9 04:29:01 2021 +1000
[docs]: Update to reflect reversion of 12434c13.
* ChangeLog: Remove no longer applicable chunks of 2021-04-15 entry
regarding Savannah #59814.
* NEWS: Revise item regarding presumed input language.
* doc/groff.texi (Manipulating Hyphenation): As previous item, and
remove LC_ALL and LANG entries from environment variable index.
* man/groff_diff.7.man (Language/Extended requests) <hpf>: As NEWS item.
* man/groff_tmac.5.man (Localization packages): As NEWS item. Also
undocument unusability of localization files with compatibility mode;
the resolution of Savannah #60874 invalidated this caveat.
---
ChangeLog | 19 ++-----------------
NEWS | 29 ++++++++++++-----------------
doc/groff.texi | 8 ++------
man/groff_diff.7.man | 8 +-------
man/groff_tmac.5.man | 30 ++++--------------------------
5 files changed, 21 insertions(+), 73 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index e14acc2..36a789c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -2168,19 +2168,6 @@
2021-04-15 G. Branden Robinson <g.branden.robinson@gmail.com>
- Determine the groff locale (default input language) using the
- system locale. Use the environment if possible. Try LC_ALL
- first, then LANG. "C" means English (en). Otherwise, only the
- first two characters of the locale name are used.
-
- Unrecognized locales (those without a supporting xx.tmac file)
- are ignored, and groff falls back to English.
-
- Those who want groff's default locale to differ from LC_ALL/LANG
- should edit the troffrc file to source the appropriate groff
- locale macro file (cs.tmac, de.tmac, den.tmac, fr.tmac, ja.tmac,
- sv.tmac, zh.tmac).
-
The first-order determinant of hyphenation points is language,
not territory. Use ISO 639 2-letter language codes for
hyphenation and exception patterns instead of ISO 3166 2-letter
@@ -2204,10 +2191,8 @@
* man/groff_diff.7.man (New requests): Note that default
hyphenation mode depends on the language used on the system.
Add concept index entry for localization. Add file index
- entries for the locale macro files (cs.tmac, etc.). Add
- environment variable index entries for LANG and LC_ALL.
- Describe how groff's idea of the locale is determined. Update
- to reflect rename of English hyphenation patterns and .hla
+ entries for the locale macro files (cs.tmac, etc.). Update to
+ reflect rename of English hyphenation patterns and .hla
identifier from "us" to "en".
* src/roff/groff/tests/localization_works.sh: Add 10 test cases.
diff --git a/NEWS b/NEWS
index 3d33a1d..ba667f9 100644
--- a/NEWS
+++ b/NEWS
@@ -13,23 +13,18 @@ VERSION 1.23.0
troff
-----
-o The groff locale (the default input language) is now determined using
- the system locale. The LC_ALL and LANG environment variables are
- checked, in that order. If set, the value's first two characters
- determine the groff locale. If these variables are not set, if the
- first one found is set to "C", or if no groff localization file exists
- for the language, groff falls back to English, loading en.tmac.
-
- Those who want groff's default locale to differ from LC_ALL/LANG
- should edit the troffrc file to source the appropriate groff locale
- macro file (cs.tmac, de.tmac, den.tmac, fr.tmac, it.tmac, ja.tmac,
- sv.tmac, zh.tmac).
-
- The default hyphenation mode (as used by the .hy request) for users of
- English is thus changed from "1", which was inappropriate for the
- TeX-based hyphenation patterns groff has used since at least 1991, to
- "4". However, invoking .hy without an argument remains synonymous
- with ".hy 1".
+o English localization has been split into a dedicated macro file,
+ en.tmac, for better parallelism with other localization files and to
+ improve support for multilingual documents. The default hyphenation
+ mode (as used by the .hy request) for users of English is thus changed
+ from "1", which was inappropriate for the TeX-based hyphenation
+ patterns groff has used since at least 1991, to "4". However,
+ invoking .hy without an argument remains synonymous with ".hy 1".
+
+ Those who want a different default input language should edit the
+ troffrc file to source the desired groff locale macro file (cs.tmac,
+ de.tmac, den.tmac, fr.tmac, it.tmac, ja.tmac, sv.tmac, zh.tmac)
+ instead of en.tmac.
o A new read-only register ".cp" is implemented. Within a .do request,
"\n[.cp]" holds the saved value of compatibility mode. See
diff --git a/doc/groff.texi b/doc/groff.texi
index cd340dd..add13e0 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -7706,15 +7706,11 @@ be used. By default, every code maps to itself except
those for letters
@pindex ja.tmac
@pindex sv.tmac
@pindex zh.tmac
-@tindex LC_ALL
-@tindex LANG
The set of hyphenation patterns is associated with the language set by
the @code{hla} request (see below). The @code{hpf} request is usually
invoked by a localization file loaded by the @file{troffrc} or
-@file{troffrc-end} file. By default, @file{troffrc} checks the
-environment variables @env{LC_ALL} and @env{LANG} (in that order) and
-attempts to load a localization file matching the first two characters
-of the variable's value.@footnote{As of @code{groff} 1.23.0,
+@file{troffrc-end} file. By default, @file{troffrc} loads the
+localization file for English.@footnote{As of @code{groff} 1.23.0,
localization files for Czech (@code{cs}), German (@code{de}), English
(@code{en}), French (@code{fr}), Italian (@code{it}), Japanese
(@code{ja}), Swedish (@code{sv}), and Chinese (@code{zh}) exist.} For
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 433f11b..7ec3715 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -2326,13 +2326,7 @@ file.
.
By default,
.I troffrc
-checks the environment variables
-.I LC_ALL
-and
-.I LANG
-(in that order)
-and attempts to load a localization file matching the first two
-characters of the variable's value.
+loads the localization file for English.
.
(As of
.I groff
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index 88130ce..eaf050a 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -255,24 +255,6 @@ macro package; see
.SS "Localization packages"
.\" ====================================================================
.
-.I groff
-handles localization automatically.
-.
-By default,
-.I troffrc
-checks the environment variables
-.I LC_ALL
-and
-.I LANG
-(in that order)
-and attempts to load a localization file matching the first two
-characters of the variable's value.
-.
-If the environment variables are not set or set to \[lq]C\[rq],
-or a localization file for the locale does not exist,
-the English localization file is used.
-.
-.
.P
For Western languages,
the localization file sets the hyphenation mode and loads hyphenation
@@ -284,6 +266,10 @@ alter the input encoding
(see the next section);
and change the amount of inter-sentence space.
.
+By default,
+.I troffrc
+loads the localization file for English.
+.
.
.P
As of
@@ -291,11 +277,6 @@ As of
1.23.0,
the following localization files exist.
.
-If you load them from the command line,
-the
-.B \-C
-option to enable compatibility mode cannot be used.
-.
.
.TP
.I cs
@@ -334,9 +315,6 @@ and
.I den.tmac
does the same for the new orthography
(\[lq]Recht\%schreib\%reform\[rq]).
-.\" There should be a better way to select the orthography via locale
-.\" settings. Have Germans come up with an @ modifier for this, e.g.,
-.\" 'LANG=de_DE@rechtschreibreform'?
.
.
.TP
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/07: [docs]: Update to reflect reversion of 12434c13.,
G. Branden Robinson <=