summaryrefslogtreecommitdiff
path: root/Master/texmf/tex/generic/config/language.us.lua
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/tex/generic/config/language.us.lua')
-rw-r--r--Master/texmf/tex/generic/config/language.us.lua32
1 files changed, 32 insertions, 0 deletions
diff --git a/Master/texmf/tex/generic/config/language.us.lua b/Master/texmf/tex/generic/config/language.us.lua
index b8540bbcff6..b2e27bd8162 100644
--- a/Master/texmf/tex/generic/config/language.us.lua
+++ b/Master/texmf/tex/generic/config/language.us.lua
@@ -5,7 +5,39 @@ language.us.dat (and the start of language.dat.lua), used by:
- a special luatex version of etex.src (from the e-TeX distributon).
See luatex-hyphen.pdf (currently part of the hyph-utf8 package) for details.
+
+DO NOT EDIT THIS FILE (language.dat.lua)! It is generated by tlmgr by
+concatenating language.us with entries from the various packages.
+
+The premade texmf/tex/generic/config/language.dat.lua (where you might be
+reading this) in the distribution is a copy of this generated file with
+all languages enabled. It is used when the user asks to run live
+(install option R).
+
+To add or remove entries in this file, there are two options:
+- if the language is provided by a TeX Live package, you can
+ (un)install the corresponding package using tlmgr. Examples:
+ tlmgr install hyphen-french
+ tlmgr remove hyphen-english
+- in any case, you can use a local configuration file:
+ TEXMFLOCAL/tex/generic/config/language-local.dat.lua
+ with the same format as the present file, then regenerate this file
+ and rebuild the formats. See the manual of tlmgr (try 'man tlmgr'
+ or 'texdoc tlmgr'), section "generate" for details.
+
+Warning: formats using this file also use one of language.dat or
+language.def. Make sure to update them accordingly. The interaction
+between these files is documented in luatex-hyphen.pdf, but here is a
+summary:
+- a language must be mentionned in language.dat or language.def to be
+available; if, in addition, it is:
+ - not mentionned in language.dat.lua, then it is dumped in the format;
+ - mentionned in language.dat.lua with a special="disabed:<reason>'
+ key, then it is not available at all;
+ - mentioned in language.dat.lua with a normal entry, then it will not
+ be dumped in the format, but loaded at runtime when activated.
]]
+
return {
["english"]={
loader="hyphen.tex",