summaryrefslogtreecommitdiff
path: root/language/hyph-utf8/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /language/hyph-utf8/doc
Initial commit
Diffstat (limited to 'language/hyph-utf8/doc')
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/CHANGES468
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/HISTORY75
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdfbin0 -> 50177 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.tex407
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.pdfbin0 -> 86099 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.tex322
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/img/miktex-languages.pngbin0 -> 19212 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/img/texlive-collection.pngbin0 -> 47513 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/languages/es/README83
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/languages/es/division.pdfbin0 -> 141388 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/languages/hu/huhyphn.pdfbin0 -> 113681 bytes
-rw-r--r--language/hyph-utf8/doc/generic/hyph-utf8/languages/sa/hyphenmin.txt11
-rw-r--r--language/hyph-utf8/doc/luatex/hyph-utf8/README31
-rw-r--r--language/hyph-utf8/doc/luatex/hyph-utf8/luatex-hyphen.pdfbin0 -> 78960 bytes
14 files changed, 1397 insertions, 0 deletions
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/CHANGES b/language/hyph-utf8/doc/generic/hyph-utf8/CHANGES
new file mode 100644
index 0000000000..09078bddc2
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/CHANGES
@@ -0,0 +1,468 @@
+2019-05-18
+- Fixed Chinese Pinyin [zh-latn-pinyin]
+- Removed plain text files .chr.txt and .lic.txt
+
+2019-04-04
+- Updated German patterns [de-1901], [de-1996], and [de-ch-1901]
+
+2019-02-04
+- Updated Liturgical Latin patterns [la-x-liturgic], by Arnaud de Castelbajac:
+ Mainly the revision of patterns: abs-*, amb-*, ob-*, super-*, trans-*, pseudo-*, indu-*
+ and some other less systematic.
+
+2019-01-01
+- Updated pinyin patterns [zh-latn]
+
+2018-11-04
+- Changed licence of British English [en-gb] patterns to MIT (commit c76c797)
+
+2018-09-12
+- Introduced structured information at the top of every TeX pattern file, in YAML format (commit 82e5651)
+
+2018-08-03
+- Thai patterns update, by Theppitak Karoonboonyanan (commit 1e52772)
+
+2018-07-25
+- Added patterns for Pāli, by Wie-Ming Cittānurakkho Bhikkhu
+
+2018-04-02
+- Synched German patterns [de-1901, de-ch-1901, de-1996] with upstream (dehyph-exptl) 2018-03-31.
+ By the German hyphenation patterns team.
+
+2018-03-25
+- Switched Bulgarian patterns to a different set, by Anton Zinoviev. Removed out-of-date documentation.
+
+2017-09-13
+- Liturgical Latin [la-x-liturgic] Fix form of possum and quoties, by Claudio Beccari and Élie Roux
+
+== CTAN release 2017.05.18 ==
+
+2017-05-18
+- Added a missing pattern for Latin, version 3.201 (by Claudio Beccari)
+
+2017-05-08
+- Updated all German [de-1901, de-ch-1901, de-1996] patterns to the latest version
+ provided by dehyph-exptl (2017-03-31). By the German hyphenation pattern working group
+
+2017-01-20
+- Synched Liturgical Latin [la-x-liturgic] patterns with their source
+ at the Gregorio project (by Élie Roux)
+
+2017-10-17
+- Updated Church Slavonic [cu] patterns to version 1.1 (by Mike Kroutikov)
+
+2017-10-01
+- Added Belarusian [be] patterns (by Maksim Salau)
+
+2016-05-19
+- update Liturgical Latin patterns (by Claudio Beccari), version 1.040
+
+== CTAN release 2016.05.16 ==
+
+2016-05-16
+- Added support for curled beta (ϐ U+03D0 GREEK BETA SYMBOL) in Ancient Greek patterns, UTF-8 version
+
+2016-05-14
+- add Liturgical Latin patterns (by Claudio Beccari)
+
+2016-05-14
+- Change righthyphenmin in hyphen-french.tlpsrc to 2
+
+2016-05-12 (c060b6d)
+- Added four patterns in French to prevent breaks before apostrophes
+
+2016-04-17 (#744, #745)
+- Added Church Slavonic patterns (by Mike Kroutikov and Aleksandr Andreev)
+
+2016-03-21 (#735, #736)
+- Added MIT licence for Irish [ga], Cyrillic Mongolian [mn-cyrl], Turkmen [tk]
+- Added “Unicode licence” for Croatian [hr]
+- Added text of “Unicode licence” to hyph-en-gb.tex(unicode-licence)
+
+2016-03-20 (#733)
+- Put French patterns under the MIT licence.
+
+2016-03-19 (#729, #731)
+- Added MIT licence for Welsh [cy], Danish [da], Slovenian [sl]; “Unicode licence” for Basque [eu]
+- Added hyph-en-gb.tex(unicode-licence)
+
+== CTAN release 2016.02.17 (#725) ==
+
+2016-02-17 (#722, #723, #724)
+- Added patterns with apostrophe for Occitan
+
+== CTAN release 2016.02.11 (#721) ==
+
+2016-02-06 (#718)
+- add Occitan patterns (by Claudio Beccari)
+
+2016-01-23 (#716)
+- update Indic patterns, now under MIT licence
+
+2015-12-22 (#710)
+- MIT licence added to the Estonian patterns
+
+2015-12-11 (#709)
+- Updated Spanish licence to MIT/X11
+
+2015-12-10 (#708)
+- Portuguese patterns under BSD-3 clause licence
+
+== CTAN release 2015.11.20 (#707) ==
+
+2015-11-12 (#704, #705)
+- update Spanish patterns (by Javier Bezos)
+
+== CTAN release 2015.05.09 (#696) ==
+
+2015-05-07 (#691)
+- update Thai patterns (by Theppitak Karoonboonyanan)
+
+== CTAN release 2014.10.13 (#687) ==
+
+2014-10-13 (#687)
+- update Classical Latin patterns (by Claudio Beccari)
+
+2014-08-22 (#686)
+- update Thai patterns (by Theppitak Karoonboonyanan)
+
+== CTAN release 2014.07.04 (#682) ==
+
+2014-06-03 (#672)
+- add Classical Latin patterns (by Claudio Beccari)
+- clean up comments for Latin patterns
+
+== CTAN release 2014.05.22 (#668) ==
+
+2014-05-22 (#668)
+- update German patterns (by Werner Lemberg), version 2014-05-21
+
+== CTAN release 2014.04.24 (#665) ==
+
+2014-04-23 (#663)
+- update Italian patterns (by Claudio Beccari), version 4.9
+
+2013-10-28 (#654)
+- update Thai patterns (by Theppitak Karoonboonyanan)
+
+== CTAN release 2013.10.08 (#651) ==
+
+2013-10-08 (#651)
+- update Afrikaans patterns (by Tilla Fick & Chris Swanepoel), version 1.0
+
+2013-06-04 (#648)
+- reintroduce Georgian patterns under LPPL licence;
+ regenerated with hyphenmin=1/2 and released as version 0.3
+
+== CTAN release 2013.05.26 (#647) ==
+
+2013-05-26 (#647)
+- minor documentation updates, CTAN release
+
+2013-05-26 (#646)
+- remove Georgian patterns (waiting for licence)
+
+2013-05-26 (#645)
+- update German patterns (by Werner Lemberg), version 2013-05-26
+
+2013-05-21 (#644)
+- add LPPL licence statement to Thai patterns
+
+2013-05-16 (#636-#643)
+- update luatex-hyphen.dtx and derivate files:
+- remove hyphen.cfg (Babel now provides a working one)
+- update etex.src
+- update luatex-hyphen.lua
+- update documentation
+
+2013-05-08 (#635)
+- texmf -> texmf-dist
+
+== CTAN release 2013.05.08 (#634) ==
+
+2013-05-08 (#634)
+- update the list of languages in documentation
+
+2013-05-08 (#633)
+- use new converters for T8M and LTH
+- update the list of languages in documentation
+
+2013-05-02 (#630)
+- add proper converters for T8M and LTH encodings
+
+2013-04-01 (#625, #626)
+- cleanup luatex-hyphen module
+- fix adding a dialect of a synonym in LuaTeX
+
+2013-03-01 (#622, #624)
+- update Georgian wordlist and patterns
+
+2013-02-27 (#621)
+- set all \lccode-s in pTeX patterns
+
+2013-02-25 (#619)
+- add the wordlist used for generating Georgian hyphenation patterns
+
+2013-02-25 (#617, #618)
+- add Georgian hyphenation patterns (by Levan Shoshiashvili)
+- add Thai hyphenation patterns (by Theppitak Karoonboonyanan)
+
+2013-02-25 (#616)
+- add support for Georgian and Thai font encodings: T8M and LTH
+- fix a line in QX font encoding
+
+== CTAN release 2013.02.21 (#614) ==
+
+2013-02-14 (#613)
+- add Piedmontese patterns (by Claudio Beccari)
+
+2012-12-13 (#611)
+2012-12-12 (#610)
+- righthyphenmin for Sanskrit should be 3 instead of 5
+
+== CTAN release 2012.05.30 (#609) ==
+
+2012-03-30 (#609)
+- sync comments of German patterns with released version
+
+2012-05-28 (#607)
+- update German patterns (by Werner Lemberg)
+
+== CTAN release 2012.05.23 (#606) ==
+
+2012-05-23 (#606)
+- update Norwegian patterns (by Ole Michael Selberg)
+- remove Lao patterns (until they are improved)
+- remove 'furlan' as a synonym for 'friulan'
+
+== CTAN release 2012.04.16 (#604) ==
+
+2012-04-16 (#604)
+- get upstream changes for hyphen.cfg from Babel 2008/07/08 v3.8m
+
+2012-04-16 (#602)
+- patch \adddialect in hyphen.cfg to also register language synonyms at lua end;
+ fixes a problem in LuaTeX with missing synonyms defined by Babel
+
+== CTAN release 2012.04.10 (#599) ==
+
+2012-04-10 (#599)
+- encoding of Friulan changed from ASCII to EC (bugfix)
+- fix some inconsistencies, update version of 'rm' and 'fur' patterns to 1.1
+
+2012-04-09 (#598)
+- add a synonym for 'friulan': 'furlan'
+
+2012-04-09 (#597)
+- add Friulan patterns (by Claudio Beccari)
+- remove duplicate patterns from Romansh
+
+2012-01-17 (#596)
+- add Romansh patterns (by Claudio Beccari)
+
+== CTAN release 2011.09.14 (#593) ==
+
+2011-09-14 (#593)
+- update Sanskrit patterns (missing rules for Malayalam script)
+
+2011-09-13 (#592)
+- update headers for Greek patterns (to be more explicit about LPPL)
+
+2011-08-17 (#589)
+- Updated Hungarian patterns from their repository (no content change).
+- Changed licence for Hungarian patterns from GPL into MPL 1.1/GPL 2.0/LGPL 2.1.
+
+2011-08-16 (#585, #586)
+- Changed licence for Italian patterns from LGPL into LPPL
+
+2011-08-10 (#583)
+- Added LPPL licence to Turkish patterns
+
+== CTAN release 2011.06.22 (#579) ==
+
+2011-06-21 (#578)
+- Added licence statement for Lao
+
+2011-06-20 (#572)
+- change language tag for Pinyin (zh-latn -> zh-latn-pinyin) due to new tag
+ http://www.iana.org/assignments/lang-subtags-templates/pinyin (2008-10-17)
+
+2011-06-20 (#566)
+- fetch the latest version of Hungarian patterns from
+ https://github.com/nagybence/huhyphn/
+
+== CTAN release 2011.06.11 (#555) ==
+
+2011-06-11 (#555)
+- downcase "Hyphenation Patterns"
+
+2011-06-09 (#553)
+- add duplicated patterns with apostrophes for XeTeX
+- fix tlpsrc generator for serbian
+
+2011-06-09 (#549)
+- support multiple hyphenation/patterns files.
+
+2011-06-08 (#547)
+- duplicate patterns with apostrophes in plan text files
+- fix a bug in conversion of greek patterns into plain text files (no apostrophe replacement)
+
+2011-06-08 (#545, #546)
+- restore two version of plain text patterns for Serbian
+ and load 'sh' patterns by default also for Cyrillic script
+
+2011-06-08 (#544)
+- a section in documentation about using hyphenation patterns in TeX
+
+2011-06-08 (#543)
+- temporary remove Greek patterns for 8-bit engines (will be added later)
+
+2011-06-07 (#542)
+- add LPPL licence to Uppersorbian patterns
+
+2011-06-07 (#538)
+- add LPPL licence to Welsh patterns
+
+2011-06-06 (#528, #529)
+- rename 8bit patterns: phyph-<lang>.tex -> hyph-<lang>.<enc>.tex
+
+2011-06-06 (#527)
+- add LPPL licence to Croatian patterns (and update author's email address)
+
+2011-06-02 (#525)
+- new version of German hyphenation patterns
+
+2011-06-01 (#523, #524)
+- load patterns for Latin and Cyrillic scripts for Serbian simultaneously
+
+2011-01-19 (#515)
+- merge exhyph-ru.tex and exhyph-uk.tex with dash-related patterns into main file
+ (we might split them again if we decide to support all different encodings)
+
+2011-01-19 (#514)
+- add ASCII Greek and Coptic patterns for 8-bit engines into repository
+
+== CTAN release 2011.01.13 ==
+
+2011-01-11 (#512)
+- remove the hack for OT1 encoding support for French and Danish patterns
+
+2011-01-11 (#512)
+- remove the hack for OT1 encoding support for French and Danish patterns
+
+2011-01-10 (#510, #511)
+- add Ethiopic full stop
+
+2011-01-10 (#508)
+- add plain version of Ethiopic patterns
+
+2011-01-09 (#505, #506)
+- add preliminary pan-Ethiopic patterns
+
+2011-01-07 (#503)
+- fix pattern loaders and comment out loading of zerohyph
+
+2011-01-06 (#501)
+- add support for pTeX
+
+2010-10-20 (#489)
+- replace Afrikaans patterns (by Tilla Fick and Chris Swanepoel)
+
+== CTAN release ==
+
+2010-09-18 (#450)
+- add Afrikaans patterns (by Friedel Wolff); major revision needed
+
+== CTAN release ==
+
+2010-06-01 (#440)
+- remove 2'2 pattern from Latin (on Claudio Beccari's request)
+
+2010-05-31 (#421, #422)
+- remove special OT1 support for Latin (with Claudio Beccari's approval)
+- add the forgotten Russian and Ukrainian patterns with dashes to plain patterns
+
+2010-05-31 (#412-#414)
+- luatex-hyphen: rm special='null' (now useless), bump version number, fill
+ the gaps in this changes file
+
+2010-05-30 (#409-#411)
+- adjust tlpsrc's of special languages for luatex-hyphen, import corresponding
+ language.dat.lua from TeX Live, and adapt test files
+
+== CTAN release 2010.05.28 ==
+
+2010-05-28 (#406)
+- A non-empty PDF file that describes the package with at least two sentences :)
+
+2010-05-24 (#379)
+- updated Italian patterns (by Claudio Beccari)
+
+2010-05-20 (#394)
+- add a loader for en-us
+
+2010-05-20 (#393)
+- luatex-hyphen: minor adjustments for special languages
+
+2010-05-19 (#358)
+- new Lao hyphenation patterns (by Brian Wilson; under development)
+
+2010-05-19 (#379, #380)
+- updated Spanish patterns (by Javier Bezos)
+
+2010-05-06 (#371)
+- new Armenian hyphenation patterns (by Sahak Petrosyan)
+
+2010-05-06 (#368, #369)
+- add source and documentation for Spanish patterns (by Javier Bezos)
+
+2010-05-03 (#360-#363)
+- more documentation and tests for luatex-hyphen and associated etex.src
+- update etex.src according to latest luatex-hyphen changes
+- split 'code' key in language.dat.lua in 'hyphenation' and 'patterns'
+
+2010-04-30 (#349-#355)
+- initial import of luatex-hyphen, a modified version of babel's hyphen.cfg
+ for use with LuaTeX (semi-dynamic loading of patterns), sharing code with
+the version of etex.src mentioned below
+- misc changes to luatex-hyphen
+- test file for luatex-hyphen
+
+2010-04-27 (#344)
+- initial import of a modified etex.src allowing semi-dynamic loading of
+ patterns with LuaTeX
+
+2010-04-27 (#340)
+- fixing glitches in Galician patterns
+- create this file for publishing changes
+
+2010-04-23 (#339)
+- updated Galician patterns (by Javier A. Múgica)
+
+2010-04-06 (#336)
+- rename mongolian->mongolianlmc and mongolian2a->mongolian
+
+2010-03-19 (#320, #323, #326)
+- Some modifications to Turkmen patterns; sent by Nazar Annagurban
+- some fixes for Indic patterns
+
+2010-03-17 (#318, #319)
+- add Indic patterns (TODO: list of patterns) by Santhosh Thottingal (+ script to fetch and convert them)
+
+2010-03-15 (#311)
+- add Turkmen patterns by Nazar Annagurban
+- minor fixes for Serbian
+
+2010-03-04 (#307)
+- a new version of Sanskrit patterns by Yves Codet
+
+2009-08-01 (#286)
+- pattern update for Spanish by Javier Bezos
+
+2009-07-10 (#279, #280)
+- add hyphenation patterns for Kurmanji (Northern Kurdish) by Jörg Knappen and Medeni Shemdê
+
+2009-06-25 (#278)
+- update German language patterns (synchronize with package dehyph-exptl v0.20)
+
+... older history to be completed ...
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/HISTORY b/language/hyph-utf8/doc/generic/hyph-utf8/HISTORY
new file mode 100644
index 0000000000..9a01c9634f
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/HISTORY
@@ -0,0 +1,75 @@
+This is HYPH-UTF8 package which contains:
+
+- hyphenation patterns hyph-foo.tex, semi-manually converted into UTF-8
+ from different sources by different authors
+- pattern loaders loadhyph-foo.tex that recognise the engine
+ and load pattern accordingly
+- converters from UTF-8 into EC/T1, QX, part of ISO Latin 3, T2A & LMC
+- some scripts to assist with auto-generating the files
+
+Modifications were needed in order to support native UTF-8 engines,
+but functionality (hopefully) didn't change in any way, at least not intentionally.
+The patterns themselves are no longer stand-alone; at least for 8-bit engines
+you need to use loadhyph-foo.tex (which will load the patterns) instead.
+
+Modifications were done by Jonathan Kew, Mojca Miklavec & Arthur Reutenauer
+with help & support from:
+
+- Karl Berry, who gave us free hands and all resources
+- Taco Hoekwater, with useful macros
+- Hans Hagen, who did the unicodifisation of patterns already long before
+ and helped with testing, suggestions and bug reports
+- Norbert Preining, who tested & integrated patterns into TeX Live
+
+However, the "copyright/copyleft" owner of patterns remains the original author.
+
+The original patterns should eventually become obsolete,
+and the author of the original file should preferraby modify
+these files instead (feel free to remove credits added by TUG from those files).
+
+If you want to change the patterns, rather than uploading directly to CTAN,
+we would be grateful if you could send it to us (http://tug.org/tex-hyphen)
+or ask for credentials for SVN repository and commit it yourself;
+we will then upload the whole "package" to CTAN.
+
+Before a new "pattern-revolution" starts,
+please try to follow some guidelines if possible:
+
+- \lccode is *forbidden*, and I really mean it
+- all the patterns should be in UTF-8
+- the only "allowed" TeX commands in patterns are: \patterns, \hyphenation,
+ and if you really cannot do without, also \input and \message
+- in particular, please no \catcode or \lccode changes,
+ they belong to loadhyph-foo.tex,
+ and no \lefthyphenmin and \righthyphenmin,
+ they have no influence here and belong elsewhere
+- \begingroup and/or \endinput is not needed
+- feel free to do whatever you want inside comments
+
+We know that TeX is extremely powerful, but give a stupid parser
+at least a chance to read your patterns.
+
+For more information see
+
+ http://tug.org/tex-hyphen
+
+
+Copyright 2008-2015 by TUG
+
+The licence for hyph-foo.tex: Respect licences of original authors.
+The licence for the rest: Use common sense when modifying and coordinate your work.
+
+Hyphenation patterns are essential to TeX;
+whatever changes you make to these files -
+make sure to coordinate your work with everyone involved.
+(TeX Live, MikTeX, CTAN, patter authors, mailing list, ...)
+
+People come and go, TeX evolves. We are aware of that.
+If we disapear one day and there is a need to change files,
+do whatever needs to be done to make TeX behave in a proper
+(backward compatible) way. And keep things clean & consistent.
+
+Things that might change in near future:
+- support for multiple versions of patterns
+- support for runtime loading of patterns
+- support for preferred hyphenation points and discretionaries (ck -> k-k)
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdf b/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdf
new file mode 100644
index 0000000000..f087a62528
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdf
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.tex b/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.tex
new file mode 100644
index 0000000000..f100730d27
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.tex
@@ -0,0 +1,407 @@
+\usetypescript[antykwa-poltawskiego]
+\setupbodyfont[antykwa-poltawskiego,10pt]
+
+\setuphead
+ [section]
+ [style=\bfc,numberstyle=\bfc]
+\setuphead
+ [subsection]
+ [style=\bfb,numberstyle=\bfb]
+\setuphead
+ [subsubsection]
+ [style=\bfa,numberstyle=\bfa]
+\setuphead
+ [title]
+ [style=\bfd]
+\setuppagenumbering
+ [location={footer,right},style=\os]
+\setuplayout
+ [backspace=1in,width=middle,
+ header=0pt,headerdistance=0pt,height=24.5cm]
+
+\def\sc{\addff{smallcaps}}
+\def\os{\addff{oldstyle}}
+
+\def\eTeX{ε-\TeX}
+% TODO
+\def\XeLaTeX{Xe\LaTeX}
+\def\LuaLaTeX{Lua\LaTeX}
+\def\pTeX{p\TeX}
+
+\definecolor
+ [verylightgray]
+ [s=.95]
+\defineframedtext
+ [framedCODE]
+ [frame=off,
+ strut=yes,
+ offset=2mm,
+ width=.9\textwidth,
+ location=middle,
+ background=color,
+ backgroundcolor=verylightgray]
+\definetyping
+ [TEX]
+ [option=TEX,
+ before={\startframedCODE},
+ after={\stopframedCODE}]
+
+\starttext
+
+\title{The {\tt hyph-utf8} package and hyphenation with \TeX}
+
+\blank[big]
+
+\startnarrower
+{\bf Maintainers} of the {\tt hyph-utf8} package and collectors of patterns:
+\startnarrower
+\startitemize[packed,joinedup]
+\item {\it Mojca Miklavec, Arthur Reutenauer}
+\item With contributions by {\it Khaled Hosny, Manuel Pégourié-Gonnard, Élie Roux}
+\stopitemize
+\stopnarrower
+\stopnarrower
+
+\blank
+
+\startnarrower
+{\bf Main description}:
+\startnarrower
+June 2011
+\stopnarrower
+\stopnarrower
+
+\startnarrower
+{\bf Latest editorial change}:
+\startnarrower
+16 Mars 2018
+\stopnarrower
+\stopnarrower
+
+\blank
+
+\startnarrower
+{\bf Abstract}:
+\startnarrower\sl
+In 2008 all the existing hyphenation patterns from \TeX\ distributions have
+been collected in a single package {\tt hyph-utf8}, converted into UTF-8
+encoding and adapted for use in different \TeX\ engines. The patterns can be
+used directly by Unicode-aware engines such as \LuaTeX\ and \XeTeX, and there
+is a mechanism to convert the patterns to the appropriate 8-bit encoding when
+used with \pTeX, \pdfTeX\ or Knuth's \TeX.
+\stopnarrower
+\stopnarrower
+
+\blank
+
+\startnarrower
+{\bf Table of Contents}:
+\blank
+\startnarrower
+\setuplist[section] [width=10mm,textstyle=\bf\sc,numberstyle=\bf\os,pagestyle=\os]
+\setuplist[subsection] [width=15mm,textstyle=normal,numberstyle=\os,pagestyle=\os]
+\setuplist[subsubsection][distance=20mm,headnumber=no,textstyle=italic,pagestyle=\os]
+
+\placecontent[criterium=all,alternative=c]
+\stopnarrower
+\stopnarrower
+
+\page
+\section{Using hyphenation patterns}
+
+\subsection{Plain \TeX}
+
+In engines that support \eTeX\ you can select the desired hyphenation patterns with:
+\startTEX
+\uselanguage{langname}
+\stopTEX
+where \type{langname} is the string identifying a particular hyphenation file in \type{language.def} (see Section \in[sec:languages]).
+
+\subsection{\LaTeX}
+
+\subsubsection{\LaTeX\ with Babel}
+
+You can switch the language in \LaTeX\ with:
+
+\startTEX
+\usepackage[languagename]{babel}
+\stopTEX
+
+In 8-bit engines you also need to make sure that you load the proper font encoding which supports all the characters used in the language of your choice, for example:
+\startTEX
+\usepackage[T1]{fontenc}
+\stopTEX
+% TODO: reference to encoding list
+
+{\it N.B.:}\/ You can use Babel with any \TeX\ engine, however it has never been properly adapted to work well with Unicode engines. If you are using \XeTeX\ it is advisable to use Polyglossia instead.
+
+
+\subsubsection{\LaTeX\ with Polyglossia}
+
+Polyglossia should be the preferred choice when using \XeLaTeX. It doesn't support \LuaLaTeX\ yet, but it is planned to extend it in future.
+
+\startTEX
+\usepackage{polyglossia}
+\setmainlanguage[optional settings]{langname}
+\setotherlanguages{otherlangname}
+
+\begin[optional settings]{otherlangname} ... \end{otherlangname}
+\stopTEX
+
+See Polyglossia manual for extensive list of options.
+
+\subsubsection{Low-level commands}
+
+Since Babel's \type{hyphen.cfg} is built into the \LaTeX\ format, hyphenation patterns can be used without even loading Babel or Polyglossia. At the low-level this simply corresponds to defining
+\startTEX
+\language=\l@<langname>
+\stopTEX
+The user command is supposed to be
+\startTEX
+\hyphenrules{langname}
+\stopTEX
+or
+\startTEX
+\begin{hyphenrules}{langname} ... \end{hyphenrules}.
+\stopTEX
+and {\it should}\/ work with any flavour of \LaTeX, however we couldn't make it work.
+
+\subsection{\ConTeXt}
+
+\ConTeXt\ doesn't load patterns for all the language that {\tt hyph-utf8} provides. If you miss any language, please contact the mailing list. The general syntax for supported languages is the following:
+
+\startTEX
+% language of the main document
+\mainlanguage[language]
+
+% to switch to another language locally
+{\language[otherlanguage] language of some short fragment}
+\stopTEX
+
+You can use full language name or the two-letter language code.
+
+\subsubsection{\ConTeXt\ MkII}
+When using \ConTeXt\ MkII the EC/T1 font encoding is used by default already, but you might need to change the encoding when using Polish, languages written in Cyrillic scripts, etc. For example:
+
+\startTEX
+\usetypescript[iwona][qx]
+\setupbodyfont[iwona]
+\mainlanguage[polish]
+\stopTEX
+
+\ConTeXt\ loads hyphenation patterns in several encodings. The Czech or Slovak patterns can be used with both EC and IL2 font encoding for example. The right hyphenation patterns will be chosen based on current font encoding.
+
+\subsection{Some advanced examples}
+
+\subsubsection{Example for Polyglossia}
+
+\startTEX
+\usepackage{polyglossia}
+% the language used for main document
+\setmainlanguage{asturian}
+% American English with extended hyphenation patterns
+\setotherlanguage[variant=usmax]{english}
+% German with experimental patterns "ngerman-x-latest"
+\setotherlanguage[spelling=new,latesthyphen=true]{german}
+\setotherlanguages{spanish,catalan,french}
+
+\begin{document}
+
+Long Asturian text ... (Hyphenation for Asturian is not available,
+but polyglossia automatically falls back on Catalan for now,
+which seems to be a reasonable choice.)
+
+\begin{german}
+Deutscher Text ... (with the hyphenation patterns selected above:
+"ngerman-x-latest")
+\end{german}
+
+\begin[script=fraktur,spelling=old]{german}
+Deutſcher Text ... (set in Fraktur, with traditional hyphenation).
+\end{german}
+
+\end{document}
+\stopTEX
+
+\page
+\section[sec:languages]{List of supported languages}
+
+For several languages, there is additional documentation in a separate file: see
+
+\startitemize[packed]
+\item For German, \type{dehyph-exptl.pdf}
+\item For Spanish, \type{division.pdf}
+\stopitemize
+
+\def\lanname#1{\hbox to \textwidth{\bf#1\hss}}
+\def\landata#1#2#3{\hbox to \textwidth{\hbox to 3mm{}\hbox to 6.5em{#1\hss}\hbox to 7em{#2}\hbox{#3}\hss} }
+
+\lanname{English}
+\landata{-}{\bf english}{usenglish, USenglish, american}
+\landata{en-us}{usenglishmax}{}
+\landata{en-gb}{ukenglish}{british, UKenglish}
+
+\startcolumns[n=2]
+\lanname{Afrikaans}
+\landata{af}{afrikaans}{}
+\lanname{Ancientgreek}
+\landata{grc}{ancientgreek}{}
+\landata{grc-x-ibycus}{ibycus}{}
+\lanname{Arabic}
+\landata{ar}{arabic}{}
+\lanname{Armenian}
+\landata{hy}{armenian}{}
+\lanname{Assamese}
+\landata{as}{assamese}{}
+\lanname{Basque}
+\landata{eu}{basque}{}
+\lanname{Belarusian}
+\landata{be}{belarusian}{}
+\lanname{Bengali}
+\landata{bn}{bengali}{}
+\lanname{Bulgarian}
+\landata{bg}{bulgarian}{}
+\lanname{Catalan}
+\landata{ca}{catalan}{}
+\lanname{Chinese}
+\landata{zh-latn-pinyin}{pinyin}{}
+\lanname{Church Slavonic}
+\landata{cu}{churchslavonic}{}
+\lanname{Coptic}
+\landata{cop}{coptic}{}
+\lanname{Croatian}
+\landata{hr}{croatian}{}
+\lanname{Czech}
+\landata{cs}{czech}{}
+\lanname{Danish}
+\landata{da}{danish}{}
+\lanname{Dutch}
+\landata{nl}{dutch}{}
+\lanname{Esperanto}
+\landata{eo}{esperanto}{}
+\lanname{Estonian}
+\landata{et}{estonian}{}
+\lanname{Ethiopic}
+\landata{mul-ethi}{ethiopic}{amharic, geez}
+\lanname{Farsi}
+\landata{fa}{farsi}{persian}
+\lanname{Finnish}
+\landata{fi}{finnish}{}
+\column
+\lanname{French}
+\landata{fr}{french}{patois, francais}
+\lanname{Friulan}
+\landata{fur}{friulan}{}
+\lanname{Galician}
+\landata{gl}{galician}{}
+\lanname{Georgian}
+\landata{ka}{georgian}{}
+\lanname{German}
+\landata{de-1901}{german}{}
+\landata{de-1996}{ngerman}{}
+\landata{de-ch-1901}{swissgerman}{}
+\lanname{Greek}
+\landata{el-monoton}{monogreek}{}
+\landata{el-polyton}{greek}{polygreek}
+\lanname{Gujarati}
+\landata{gu}{gujarati}{}
+\lanname{Hindi}
+\landata{hi}{hindi}{}
+\lanname{Hungarian}
+\landata{hu}{hungarian}{}
+\lanname{Icelandic}
+\landata{is}{icelandic}{}
+\lanname{Indonesian}
+\landata{id}{indonesian}{}
+\lanname{Interlingua}
+\landata{ia}{interlingua}{}
+\lanname{Irish}
+\landata{ga}{irish}{}
+\lanname{Italian}
+\landata{it}{italian}{}
+\lanname{Kannada}
+\landata{kn}{kannada}{}
+\lanname{Kurmanji}
+\landata{kmr}{kurmanji}{}
+\lanname{Latin}
+\landata{la}{latin}{}
+\landata{la-x-classic}{classiclatin}{}
+\landata{la-x-liturgic}{liturgicallatin}{}
+\lanname{Latvian}
+\landata{lv}{latvian}{}
+\lanname{Lithuanian}
+\landata{lt}{lithuanian}{}
+\lanname{Malayalam}
+\landata{ml}{malayalam}{}
+\column
+\lanname{Marathi}
+\landata{mr}{marathi}{}
+\lanname{Mongolian}
+\landata{mn-cyrl}{mongolian}{}
+\landata{mn-cyrl-x-lmc}{mongolianlmc}{}
+\lanname{Norwegian}
+\landata{nb}{bokmal}{norwegian, norsk}
+\landata{nn}{nynorsk}{}
+\lanname{Occitan}
+\landata{oc}{occitan}{}
+\lanname{Oriya}
+\landata{or}{oriya}{}
+\lanname{Panjabi}
+\landata{pa}{panjabi}{}
+\lanname{Polish}
+\landata{pl}{polish}{}
+\lanname{Piedmontese}
+\landata{pms}{piedmontese}{}
+\lanname{Portuguese}
+\landata{pt}{portuguese}{portuges}
+\lanname{Romanian}
+\landata{ro}{romanian}{}
+\lanname{Romansh}
+\landata{rm}{romansh}{}
+\lanname{Russian}
+\landata{ru}{russian}{}
+\lanname{Sanskrit}
+\landata{sa}{sanskrit}{}
+\lanname{Serbian}
+\landata{sr-latn}{serbian}{}
+\landata{sr-cyrl}{serbianc}{}
+\lanname{Slovak}
+\landata{sk}{slovak}{}
+\lanname{Slovenian}
+\landata{sl}{slovenian}{slovene}
+\lanname{Spanish}
+\landata{es}{spanish}{espanol}
+\lanname{Swedish}
+\landata{sv}{swedish}{}
+\lanname{Tamil}
+\landata{ta}{tamil}{}
+\lanname{Telugu}
+\landata{te}{telugu}{}
+\lanname{Thai}
+\landata{th}{thai}{}
+\lanname{Turkish}
+\landata{tr}{turkish}{}
+\lanname{Turkmen}
+\landata{tk}{turkmen}{}
+\lanname{Ukrainian}
+\landata{uk}{ukrainian}{}
+\lanname{Uppersorbian}
+\landata{hsb}{uppersorbian}{}
+\lanname{Welsh}
+\landata{cy}{welsh}{}
+\stopcolumns
+
+\blank[2*big]
+
+Babel defines a few more synonyms (which consequently only work in \LaTeX):
+
+\def\lansyn#1#2{\hbox to \textwidth{\hbox to 3mm{}\hbox to 6.5em{\bf#1\hss}\hbox{#2}\hss}}
+\lansyn{english}{canadian}
+\lansyn{british}{australian, newzealand}
+\lansyn{german}{austrian}
+\lansyn{ngerman}{naustrian, nswissgerman}
+\lansyn{portuguese}{brazilian, brazil}
+
+% TODO: bibliography
+
+\stoptext
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.pdf b/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.pdf
new file mode 100644
index 0000000000..0c35610289
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.pdf
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.tex b/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.tex
new file mode 100644
index 0000000000..b6d9747b60
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/hyphenation-distribution.tex
@@ -0,0 +1,322 @@
+\setuplayout
+ [backspace=2cm,width=middle]
+
+% \usetypescript[antykwa-poltawskiego]
+% \setupbodyfont[antykwa-poltawskiego,10pt]
+\usetypescript[antykwa-poltawskiego][ec]
+\setupbodyfont[antykwa-poltawskiego,10pt]
+
+\setuphead
+ [section,subject]
+ [style=\bfc]
+\setuphead
+ [subsection,subsubject]
+ [style=\bfb]
+\setuppagenumbering
+ [location={footer}]
+\setuplayout
+ [header=0pt,headerdistance=0pt,height=24cm]
+\setupwhitespace
+ [medium]
+
+\def\TeXLive{\TeX\ Live}
+\def\MiKTeX{MiK\TeX}
+\def\W32TeX{W32\TeX}
+\def\pTeX{p\TeX}
+
+\starttext
+
+\section{\TeX\ distributions}
+
+\subsection{\TeXLive}
+
+In \TeXLive\ you can install different language collections \type{collection-lang}{\tt\sl <foo>}.
+
+\placefigure[force]{}{\externalfigure[img/texlive-collection.png][width=340pt]}
+
+For example, the German collection \type{collection-langgerman} contains packages \type{hyphen-german} and \type{dehyph-exptl} which both contain hyphenation patterns (in addition to many other packages related to German language). The Greek collection \type{collection-langgreek} contains \type{hyphen-greek} and \type{hyphen-ancientgreek} among other packages. The package \type{dehyph-exptl} is maintained independently, while all packages \type{hyphen-}{\tt\sl<foo>} belong to \type{hyph-utf8}.
+
+
+
+
+Hyphenation packages may contain one or more patterns. For example \type{hyphen-norwegian} contains two directives for adding two hyphenation patterns:
+\starttyping
+execute AddHyphen \
+ name=bokmal synonyms=norwegian,norsk \
+ lefthyphenmin=2 \
+ righthyphenmin=2 \
+ file=loadhyph-nb.tex \
+ file_patterns=hyph-nb.pat.txt \
+ file_exceptions=hyph-nb.hyp.txt
+execute AddHyphen \
+ name=nynorsk \
+ lefthyphenmin=2 \
+ righthyphenmin=2 \
+ file=loadhyph-nn.tex \
+ file_patterns=hyph-nn.pat.txt \
+ file_exceptions=hyph-nn.hyp.txt
+\stoptyping
+
+The keywords {\bf name} and {\bf synonyms} are used as language name to access the patterns in \TeX, {\bf file} is used as pattern loader for 8-bit engines and \XeTeX, while {\bf file\_patterns} and {\bf file\_exceptions} are plain text files used by \LuaTeX.
+
+The information from \type{AddHyphen} directives end up in three different files: \type{language.dat} used by \LaTeX, \type{language.def} used by plain \eTeX\ and \type{language.dat.lua} used by \LuaTeX.
+
+All the three are placed in\crlf
+\strut\type{ $TEXMFSYSVAR/tex/generic/config},\crlf
+for example in\crlf
+\strut\type{ /usr/local/texlive/2017/texmf-var/tex/generic/config},\crlf
+while a static copy also exists in\crlf
+\strut\type{ $TEXMFDIST/tex/generic/config},\crlf
+but that one contains all languages and only makes sense if you have a complete checkout from SVN repository for example.
+
+\placefigure[force]{\type{language.dat}}{
+\starttyping
+% from hyphen-norwegian:
+bokmal loadhyph-nb.tex
+=norwegian
+=norsk
+nynorsk loadhyph-nn.tex
+\stoptyping
+}
+
+\placefigure[force]{\type{language.def}}{
+\starttyping
+% from hyphen-norwegian:
+\addlanguage{bokmal}{loadhyph-nb.tex}{}{2}{2}
+\addlanguage{norwegian}{loadhyph-nb.tex}{}{2}{2}
+\addlanguage{norsk}{loadhyph-nb.tex}{}{2}{2}
+\addlanguage{nynorsk}{loadhyph-nn.tex}{}{2}{2}
+\stoptyping
+}
+
+\placefigure[force]{\type{language.dat.lua} (the keyword \type{loader} is not used anywhere at the moment)}{
+\starttyping
+-- from hyphen-norwegian:
+ ['bokmal'] = {
+ loader = 'loadhyph-nb.tex',
+ lefthyphenmin = 2,
+ righthyphenmin = 2,
+ synonyms = { 'norwegian', 'norsk' },
+ patterns = 'hyph-nb.pat.txt',
+ hyphenation = 'hyph-nb.hyp.txt',
+ },
+ ['nynorsk'] = {
+ loader = 'loadhyph-nn.tex',
+ lefthyphenmin = 2,
+ righthyphenmin = 2,
+ synonyms = { },
+ patterns = 'hyph-nn.pat.txt',
+ hyphenation = 'hyph-nn.hyp.txt',
+ },
+\stoptyping
+}
+
+The files \type{language.dat} and \type{language.def} are used both by 8-bit and native Unicode engines. On one hand this simplifies things, while on the other it makes very little sense to include sanskrit patterns in \pdfTeX\ -- the package doesn't load any patterns in that case any way. It might be that there will be multiple copies of \type{language.dat} for different engines in future.
+
+\subsection{\MiKTeX}
+
+In \MiKTeX\ application {\bf MiKTeX Options} which you can run from Start menu ({\em Maintenance} $\rightarrow$ {\em Settings} or {\em Maintenance (Admin)} $\rightarrow$ {\em Settings (Admin)\/}) or from command line (\type{mo.exe} or \type{mo_admin.exe}) you can select which languages you want to include into \TeX\ formats.
+
+\placefigure[force]{user interface to select the desired languages}{\externalfigure[img/MiKTeX-languages.png]}%[width=7cm]
+
+Based on that selection \MiKTeX\ creates three files \type{language.dat}, \type{language.def} and \type{language.dat.lua} in directory
+\starttyping
+ C:\ProgramData\MiKTeX\2.9\tex\generic\config
+\stoptyping
+
+The contents of those files are the same as described in \TeXLive\ section, but the needed information about names of languages and required files comes from
+\starttyping
+ C:\Program Files\MiKTeX 2.9\MiKTeX\config\languages.ini
+\stoptyping
+instead of special \type{hyphen-}{\tt\sl<foo>} packages.
+
+(Exact location might depend on where you install \MiKTeX\ and whether you install it for all users or just for yourself. It may also depend on Windows version. The information above holds for \MiKTeX\ 2.9 on Windows 7 with system-wide installation.)
+
+\placefigure[force]{\type{languages.ini}}{
+\starttyping
+[bokmal]
+loader=loadhyph-nb.tex
+lefthyphenmin=2
+righthyphenmin=2
+synonyms=norwegian,norsk
+patterns=hyph-nb.pat.txt
+
+[nynorsk]
+loader=loadhyph-nn.tex
+lefthyphenmin=2
+righthyphenmin=2
+patterns=hyph-nn.pat.txt
+\stoptyping
+}
+
+% \subsection{\W32TeX}
+
+\page
+
+List of languages in \TeXLive\ 2017:
+\startcolumns[two]
+\starttyping
+collection-langarabic
+ hyphen-arabic
+ arabic
+ hyphen-farsi
+ farsi,persian
+collection-langchinese
+ hyphen-chinese
+ pinyin
+collection-langcyrillic
+ hyphen-belarusian
+ belarusian
+ hyphen-bulgarian
+ bulgarian
+ hyphen-churchslavonic
+ churchslavonic
+ hyphen-mongolian
+ mongolian
+ mongolianlmc
+ hyphen-russian
+ russian
+ hyphen-serbian
+ serbian
+ serbianc
+ hyphen-ukrainian
+ ukrainian
+collection-langczechslovak
+ hyphen-czech
+ czech
+ hyphen-slovak
+ slovak
+collection-langenglish
+ hyphen-english
+ ukenglish,british,UKenglish
+ usenglishmax
+collection-langeuropean
+ hyphen-armenian
+ armenian
+ hyphen-croatian
+ croatian
+ hyphen-danish
+ danish
+ hyphen-dutch
+ dutch
+ hyphen-estonian
+ estonian
+ hyphen-finnish
+ finnish
+ hyphen-friulan
+ friulan
+ hyphen-hungarian
+ hungarian
+ hyphen-icelandic
+ icelandic
+ hyphen-irish
+ irish
+ hyphen-kurmanji
+ kurmanji
+ hyphen-latin
+ classiclatin
+ latin
+ liturgicallatin
+ hyphen-latvian
+ latvian
+ hyphen-lithuanian
+ lithuanian
+ hyphen-norwegian
+ bokmal,norwegian,norsk
+ nynorsk
+ hyphen-occitan
+ occitan
+ hyphen-piedmontese
+ piedmontese
+ hyphen-romanian
+ romanian
+ hyphen-romansh
+ romansh
+ hyphen-slovenian
+ slovenian,slovene
+ hyphen-swedish
+ swedish
+ hyphen-turkish
+ turkish
+ hyphen-uppersorbian
+ uppersorbian
+ hyphen-welsh
+ welsh
+collection-langfrench
+ hyphen-basque
+ basque
+ hyphen-french
+ french,patois,francais
+collection-langgerman
+ hyphen-german
+ german
+ ngerman
+ swissgerman
+collection-langgreek
+ hyphen-greek
+ monogreek
+ greek,polygreek
+ hyphen-ancientgreek
+ ancientgreek
+ ibycus
+collection-langitalian
+ hyphen-italian
+ italian
+collection-langother
+ hyphen-afrikaans
+ afrikaans
+ hyphen-coptic
+ coptic
+ hyphen-esperanto
+ esperanto
+ hyphen-ethiopic
+ ethiopic,amharic,geez
+ hyphen-georgian
+ georgian
+ hyphen-indic
+ assamese
+ bengali
+ gujarati
+ hindi
+ kannada
+ malayalam
+ marathi
+ oriya
+ panjabi
+ tamil
+ telugu
+ hyphen-indonesian
+ indonesian
+ hyphen-interlingua
+ interlingua
+ hyphen-sanskrit
+ sanskrit
+ hyphen-thai
+ thai
+ hyphen-turkmen
+ turkmen
+collection-langpolish
+ hyphen-polish
+ polish
+collection-langportuguese
+ hyphen-portuguese
+ portuguese,portuges
+collection-langspanish
+ hyphen-spanish
+ spanish,espanol
+ hyphen-catalan
+ catalan
+ hyphen-galician
+ galician
+\stoptyping
+\stopcolumns
+
+% \section{Special cases}
+%
+% \subsection{German}
+%
+% \subsection{Russian and Ukrainian}
+%
+% \section{How to add your own language?}
+
+\stoptext \ No newline at end of file
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/img/miktex-languages.png b/language/hyph-utf8/doc/generic/hyph-utf8/img/miktex-languages.png
new file mode 100644
index 0000000000..0d0947a78f
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/img/miktex-languages.png
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/img/texlive-collection.png b/language/hyph-utf8/doc/generic/hyph-utf8/img/texlive-collection.png
new file mode 100644
index 0000000000..4c384eb04b
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/img/texlive-collection.png
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/README b/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/README
new file mode 100644
index 0000000000..9529767ad4
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/README
@@ -0,0 +1,83 @@
+DIVISI'ON DE PALABRAS
+~~~~~~~~~~~~~~~~~~~~~
+
+The file eshyph.tex under /base is the base for the Spanish patters.
+It is intended mainly for backward compatibility. New systems are
+best based on CTAN:language/hyph-utf8/, which has the same patterns.
+
+Why 4.x? Well, I know at least other three files with the same name,
+so this one is the fourth (there were at least 6 or 7 patterns files).
+The others should vanish as soon as posible.
+
+(c) Javier Bezos 1993 1997.
+(c) Javier Bezos and CervanTeX 2001-2009
+Some parts, (c) by Francesc Carmona
+Licence: LPPL
+
+- division.pdf is a draft of an article (in Spanish) explaining the
+rules to be applied and how they are being translated into TeX in a
+unified set of patterns (somewhat outdated).
+- eshyph-make.lua generates the patterns, with eshyph.src for prefixes
+and special cases.
+- eshyph-test.tex makes a comparison with strict syllabic rules. It
+requires a file spanish-words.txt (not supplied) with a list of word,
+one per line. You can (should) filter the words.
+
+For bug reports and comments:
+
+ http://www.tex-tipografia.com/spanish_hyphen.html
+
+I would like to thanks Francesc Carmona for his permission
+to steal parts of his work without restrictions.
+
+The contrib directory, as its name implies, is not part of the
+official bundle. It has a different set of patterns, but it does not
+follow the rules by the Spanish Academy (despite its claims).
+
+What's new in 4.5 (2009-08-01)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Missing group -gl- added (a major bug). A few minor improvements
+for "des-" and "in-".
+
+What's new in 4.4 (2009-05-19)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some bad patterns fixed.
+
+What's new in 4.3 (2009-05-14)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some patterns fixed, particularly for "familia", "superar", "sub-" and
+final consonants. Patterns are now generated with the help of a few
+lua/luatex files (whose status is alpha).
+
+What's new in 4.2
+~~~~~~~~~~~~~~~~~
+
+The encoding is UTF-8, so that it can be used with LuaTeX. Yet, it
+works without changes with standard TeX.
+
+What's new in 4.1
+~~~~~~~~~~~~~~~~~
+
+- Thanks to a list of about 750000 words and extensive
+tests, wrong hyphenations have been reduced dramatically
+and the number of patterns has been almost duplicated.
+
+- Since the Spanish Academy rules of 1999 are very vague,
+incomplete and even contradictory, they had to be
+completed with some traditional ones. The Academy has
+published new rules in November 2005 including many of
+the traditional ones employed here and therefore only
+minor adjustments have been necessary.
+
+- Patterns for a few verbal endings are necessary, and
+now the "voseo" forms (used in many countries of Central
+and South America) have been included.
+
+2009-05-19
+_____________________________________________________________
+Javier Bezos | http://www.cervantex.es/
+.............................................................
+TeX y tipografia | http://www.tex-tipografia.com/ \ No newline at end of file
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/division.pdf b/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/division.pdf
new file mode 100644
index 0000000000..6dd9739513
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/languages/es/division.pdf
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/languages/hu/huhyphn.pdf b/language/hyph-utf8/doc/generic/hyph-utf8/languages/hu/huhyphn.pdf
new file mode 100644
index 0000000000..f9971f1e60
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/languages/hu/huhyphn.pdf
Binary files differ
diff --git a/language/hyph-utf8/doc/generic/hyph-utf8/languages/sa/hyphenmin.txt b/language/hyph-utf8/doc/generic/hyph-utf8/languages/sa/hyphenmin.txt
new file mode 100644
index 0000000000..5fbd790b65
--- /dev/null
+++ b/language/hyph-utf8/doc/generic/hyph-utf8/languages/sa/hyphenmin.txt
@@ -0,0 +1,11 @@
+This is the explanation of the values of hyphenmin used in Sanskrit (and possibly Indic languages) as given by Yves Codet in a private mail on March 19, 2010:
+
+For lefthyphenmin I think 1 is correct: in Sanskrit, if we allow breaks such as "tu-dati" ("tu" = 2 characters) we must allow "pa-tati" ("pa" = 1 character).
+
+For righthyphenmin I first suggested 5, as François wrote, which should be forgotten (and forgiven :). Then I thought 3 could be good; my idea was to prohibit a break before a consonant at the end of a word, such as "apata-t" (final "t" = 2 characters). But if hyphenation patterns have precedence over hyphenmins, since patterns contain rules prohibiting such breaks, that precaution is useless, and it has a drawback: it forbids breaks such as "pata-ti" ("ti" = 2 characters) or "pata-ta" ("ta" = 1 character). If patterns do have precedence, it now seems to me that the best choice is 1 for both hyphenmins (I'm sorry, François, about my hesitations :).
+
+But if my reasoning is sound, this would be for Sanskrit and Prakrit, in whatever script they are written. Maybe there would be reasons to choose other values for some other Indian languages, which I don't know.
+
+Kind regards,
+
+Yves
diff --git a/language/hyph-utf8/doc/luatex/hyph-utf8/README b/language/hyph-utf8/doc/luatex/hyph-utf8/README
new file mode 100644
index 0000000000..bb43e34cbb
--- /dev/null
+++ b/language/hyph-utf8/doc/luatex/hyph-utf8/README
@@ -0,0 +1,31 @@
+ The luatex hyphenation package.
+
+This package provides functions to be used for hyphenation pattern loading
+in LuaTeX. The patterns are loaded at runtime and not in the format.
+This leads to much shorter format loading time, with no loss as the
+patterns are not really loaded in the format, just copied and then loaded
+at runtime.
+
+This package is developped on <http://tug.org/svn/texhyphen/trunk/hyph-utf8/>.
+
+Installation
+------------
+
+These files are part of the format, so they should be installed in your
+TeX distribution (it is the case in TeXLive since 2010 release).
+
+Manifest
+--------
+
+Source files:
+ luatex-hyphen.dtx single file source & doc
+
+Derived files:
+ luatex-hyphen.pdf documentation
+ luatex-hyphen.lua lua code used by the package
+
+
+License
+-------
+
+This work is under the CC0 license.
diff --git a/language/hyph-utf8/doc/luatex/hyph-utf8/luatex-hyphen.pdf b/language/hyph-utf8/doc/luatex/hyph-utf8/luatex-hyphen.pdf
new file mode 100644
index 0000000000..0e9721d99c
--- /dev/null
+++ b/language/hyph-utf8/doc/luatex/hyph-utf8/luatex-hyphen.pdf
Binary files differ