summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-04 00:01:17 +0000
committerKarl Berry <karl@freefriends.org>2013-12-04 00:01:17 +0000
commitdc3645665fd98e15f4a251d1e78c283e37658119 (patch)
tree683d375cb36213d0cd367fc59e6cb1c22ba84498 /Master/texmf-dist/doc/generic
parent5b0be858da5f93a678e7665f67921f8e63559f5a (diff)
babel-greek (3dec13)
git-svn-id: svn://tug.org/texlive/trunk@32309 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/README31
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/README.html44
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/babel-greek.pdfbin0 -> 252709 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/greek.pdfbin213463 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-greek.pdfbin189424 -> 183472 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-greek.tex32
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.pdfbin59438 -> 59837 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.tex65
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.pdfbin0 -> 39295 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.tex273
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/usage.pdfbin174589 -> 176289 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-greek/usage.tex9
12 files changed, 396 insertions, 58 deletions
diff --git a/Master/texmf-dist/doc/generic/babel-greek/README b/Master/texmf-dist/doc/generic/babel-greek/README
index c7338a350e0..36ba8455ce6 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/README
+++ b/Master/texmf-dist/doc/generic/babel-greek/README
@@ -40,6 +40,11 @@ News
.. Do not auto-load euenc.def with XeTeX/LuaTeX.
1.7a 2013-09-13 Fix bug `babel/4360`_: spurious ``\fi``.
1.7b 2013-10-01 bugfix: correct upcasing of babel strings with Xe/LuaTeX.
+1.8 2013-12-02 Rename ``greek.dtx`` to ``babel-greek`` so that texdoc_
+ shows the right documentation.
+.. Compatibility with Xe/LuaTeX in Unicode and 8-bit mode.
+1.8a 2013-12-03 Set ``\encodingdefault`` in ``\greekscript`` to fix
+ Greek in footnotes etc. with document language Greek.
===== ========== ===========================================================
@@ -54,9 +59,6 @@ The "babel-greek" package requires the babel_ base package and parts of the
greek-fontenc_ package. The greek-inputenc_ package is recommended when
using 8-bit TeX engines.
-The language definition file makes use of the `e-TeX`_ extensions (present
-in all current TeX distributions).
-
Use with XeTeX/LuaTeX requires also ``xgreek-fixes.def`` from polyglossia_
for correct up/downcasing.
@@ -83,7 +85,6 @@ Otherwise, make sure LaTeX can find the required files:
* To produce the documentation run the files ``usage.tex`` and all files
ending in ``.dtx`` through LaTeX.
-
Usage
-----
@@ -91,21 +92,24 @@ Pass the "greek" option to babel::
\usepackage[greek]{babel}
-For polytonic greek, set the language attribute "polutoniko"::
+For polytonic Greek, set the language attribute "polutoniko"::
\languageattribute{greek}{polutoniko}
-When compiling with XeTeX or LuaTeX, it is recommended to load Greek LICR
-macro definitions via ``textalpha.sty`` or ``alphabeta.sty`` that are part
-of the greek-fontenc_ bundle since version 0.10 (2013-09-13)::
+With XeTeX/LuaTeX, load fontspec_ before babel_, so that babel-greek can
+set up the Unicode font encoding for use with Greek, e.g. ::
- \usepackage{textalpha}
- \usepackage[greek]{babel}
+ \usepackage{fontspec}
+ \setmainfont{Linux Libertine O}
+ \setsansfont{Linux Biolinum O}
+ \usepackage[greek,english]{babel}
-For details see `<usage.pdf>`_, `<greek.pdf>`_ and the babel_ documentation.
-Literal input of Greek characters is possible with the greek-inputenc_
-package or with XeTeX or LuaTeX.
+For details see `<babel-greek.pdf>`_ and the babel_ documentation.
+Literal input of Greek characters is possible with the greek-inputenc_
+package or with XeTeX or LuaTeX. For the Latin transliteration provided by
+the LGR font encoding see `<usage.pdf>`_ and the example files provided with
+greek-fontenc_.
Greek text fonts
----------------
@@ -157,3 +161,4 @@ Unicode (with XeTeX or LuaTeX).
.. _Linux Libertine: http://www.ctan.org/pkg/libertine
.. _polyglossia: http://www.ctan.org/pkg/polyglossia
.. _substitutefont: http://www.ctan.org/pkg/substitutefont
+.. _texdoc: http://www.ctan.org/pkg/texdoc
diff --git a/Master/texmf-dist/doc/generic/babel-greek/README.html b/Master/texmf-dist/doc/generic/babel-greek/README.html
index 42085387bd3..adf7d7009c3 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/README.html
+++ b/Master/texmf-dist/doc/generic/babel-greek/README.html
@@ -97,6 +97,21 @@ Greek language and script via the <a class="reference external" href="http://www
<td><p>2013-10-01</p></td>
<td><p>bugfix: correct upcasing of babel strings with Xe/LuaTeX.</p></td>
</tr>
+<tr><td><p>1.8</p></td>
+<td><p>2013-12-02</p></td>
+<td><p>Rename <tt class="literal">greek.dtx</tt> to <tt class="literal"><span class="pre">babel-greek</span></tt> so that <a class="reference external" href="http://www.ctan.org/pkg/texdoc">texdoc</a>
+shows the right documentation.</p></td>
+</tr>
+<tr><td><!-- -->
+</td>
+<td>&nbsp;</td>
+<td><p>Compatibility with Xe/LuaTeX in Unicode and 8-bit mode.</p></td>
+</tr>
+<tr><td><p>1.8a</p></td>
+<td><p>2013-12-03</p></td>
+<td><p>Set <tt class="literal">\encodingdefault</tt> in <tt class="literal">\greekscript</tt> to fix
+Greek in footnotes etc. with document language Greek.</p></td>
+</tr>
</tbody>
</table>
</div>
@@ -105,8 +120,6 @@ Greek language and script via the <a class="reference external" href="http://www
<p>The “babel-greek” package requires the <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> base package and parts of the
<a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a> package. The <a class="reference external" href="http://www.ctan.org/pkg/greek-inputenc">greek-inputenc</a> package is recommended when
using 8-bit TeX engines.</p>
-<p>The language definition file makes use of the <a class="reference external" href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=etex">e-TeX</a> extensions (present
-in all current TeX distributions).</p>
<p>Use with XeTeX/LuaTeX requires also <tt class="literal"><span class="pre">xgreek-fixes.def</span></tt> from <a class="reference external" href="http://www.ctan.org/pkg/polyglossia">polyglossia</a>
for correct up/downcasing.</p>
<p>Typesetting Greek texts requires <a class="reference internal" href="#greek-text-fonts">Greek text fonts</a>.</p>
@@ -131,24 +144,27 @@ ending in <tt class="literal">.dtx</tt> through LaTeX.</p></li>
<p>Pass the “greek” option to babel:</p>
<pre class="literal-block">\usepackage[greek]{babel}
</pre>
-<p>For polytonic greek, set the language attribute “polutoniko”:</p>
+<p>For polytonic Greek, set the language attribute “polutoniko”:</p>
<pre class="literal-block">\languageattribute{greek}{polutoniko}
</pre>
-<p>When compiling with XeTeX or LuaTeX, it is recommended to load Greek LICR
-macro definitions via <tt class="literal">textalpha.sty</tt> or <tt class="literal">alphabeta.sty</tt> that are part
-of the <a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a> bundle since version 0.10 (2013-09-13):</p>
-<pre class="literal-block">\usepackage{textalpha}
-\usepackage[greek]{babel}
+<p>With XeTeX/LuaTeX, load <a class="reference external" href="http://www.ctan.org/pkg/fontspec">fontspec</a> before <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a>, so that babel-greek can
+set up the Unicode font encoding for use with Greek, e.g.</p>
+<pre class="literal-block">\usepackage{fontspec}
+\setmainfont{Linux Libertine O}
+\setsansfont{Linux Biolinum O}
+\usepackage[greek,english]{babel}
</pre>
-<p>For details see <a class="reference external" href="usage.pdf">usage.pdf</a>, <a class="reference external" href="greek.pdf">greek.pdf</a> and the <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> documentation.
-Literal input of Greek characters is possible with the <a class="reference external" href="http://www.ctan.org/pkg/greek-inputenc">greek-inputenc</a>
-package or with XeTeX or LuaTeX.</p>
+<p>For details see <a class="reference external" href="babel-greek.pdf">babel-greek.pdf</a> and the <a class="reference external" href="http://www.ctan.org/pkg/babel">babel</a> documentation.</p>
+<p>Literal input of Greek characters is possible with the <a class="reference external" href="http://www.ctan.org/pkg/greek-inputenc">greek-inputenc</a>
+package or with XeTeX or LuaTeX. For the Latin transliteration provided by
+the LGR font encoding see <a class="reference external" href="usage.pdf">usage.pdf</a> and the example files provided with
+<a class="reference external" href="http://www.ctan.org/pkg/greek-fontenc">greek-fontenc</a>.</p>
</div>
<div class="section" id="greek-text-fonts">
<h1>Greek text fonts</h1>
<p>A list of Greek text fonts for use with LaTeX is available at the CTAN
<a class="reference external" href="http://www.ctan.org/topic/font-greek">http://www.ctan.org/topic/font-greek</a></p>
-<p>With the XeTeX or LuaTeX engines, the user should ensure that the choosen
+<p>With the XeTeX or LuaTeX engines, the user should ensure that the chosen
font contains the required glyphs (the default Latin Modern fonts miss
them). Examples for suitable fonts are the <a class="reference external" href="http://www.ctan.org/pkg/cm-unicode">CM-unicode</a> or the <a class="reference external" href="http://www.ctan.org/pkg/libertine">Linux
Libertine</a> OpenType fonts as well as any system-wide installed OTF fonts
@@ -165,9 +181,9 @@ font (see <a class="reference external" href="usage.pdf">usage.pdf</a>).</p>
<p>A major drawback of this transliteration is, that you cannot access Latin
letters if LGR is the active font encoding (e.g. in documents or parts of
documents given the <cite>Babel</cite> language <tt class="literal">greek</tt> or <tt class="literal">polutionikogreek</tt>).
-This means that for every Latin-written word or acronym an explicite
+This means that for every Latin-written word or acronym an explicit
language-switch is required. This problem can only be solved via a
-font-encoding comprising both Latin and Greek like the hypothetic T7 or
+font-encoding comprising both Latin and Greek like the hypothetical T7 or
Unicode (with XeTeX or LuaTeX).</p>
<!-- References
- - - - - - - - - - -->
diff --git a/Master/texmf-dist/doc/generic/babel-greek/babel-greek.pdf b/Master/texmf-dist/doc/generic/babel-greek/babel-greek.pdf
new file mode 100644
index 00000000000..dcbbe84e439
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/babel-greek/babel-greek.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/greek.pdf b/Master/texmf-dist/doc/generic/babel-greek/greek.pdf
deleted file mode 100644
index a52873f3585..00000000000
--- a/Master/texmf-dist/doc/generic/babel-greek/greek.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-greek.pdf b/Master/texmf-dist/doc/generic/babel-greek/test-greek.pdf
index cab6de96b9b..e4c9306d8df 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/test-greek.pdf
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-greek.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-greek.tex b/Master/texmf-dist/doc/generic/babel-greek/test-greek.tex
index 7d0d3c2b22c..75db933b4f0 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/test-greek.tex
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-greek.tex
@@ -1,7 +1,16 @@
\documentclass[a4paper]{article}
-\usepackage{cmap} % fix search and cut-and-paste in Acrobat Reader
\usepackage[LGR,T1]{fontenc}
-\usepackage[utf8]{inputenc}
+
+% Xe/LuaTeX in 8-bit compatibility mode:
+% TODO: hyphenation in Greek text parts fails!
+\ifdefined \XeTeXrevision
+ \XeTeXinputencoding "bytes"
+\fi
+\ifdefined\luatexversion
+ \usepackage[utf8]{luainputenc}
+\else
+ \usepackage[utf8]{inputenc}
+\fi
% \usepackage{textalpha}
\usepackage{textcomp}
\usepackage{hyperref,bookmark}
@@ -14,13 +23,12 @@
\usepackage[greek,english]{babel}
% \languageattribute{greek}{polutoniko}
+\message{Latin encoding is \latinencoding}
\DeclareTextCommandDefault{\ensuregreek}{\textgreek}
\begin{document}
-% \message{Latin encoding is \latinencoding}
-
\section*{Test the Greek support for Babel}
The babel option ``greek'' activates the support for the Greek language
@@ -52,13 +60,17 @@ font encoding}. This means you need an explicit font encoding change for
every Latin letter and some other symbols if the current font encoding is
LGR.
-Switching between Latin and Greek script/font encoding is possible without
-switching the Babel language using the declarations \verb|\latintext|,
-\verb|\greektext| and the macros \verb|\textlatin|, \verb|\textgreek|. These
-commands do not start a new paragraph:
+The Babel core defines the declaration \verb|\latintext| and the command
+\verb|\textlatin| to switch to the T1 or OT1 font encoding or typeset the
+argument using this encoding.
+
+Switching to a font encoding supporting the Greek script is possible without
+switching the Babel language using the declarations \verb|\greekscript| or
+\verb|\greektext| (always LGR) and the macros \verb|\ensuregreek| or
+\verb|\textgreek|. These commands do not start a new paragraph:
-\greektext Φίλων τοῦ \textlatin{TeX} (ΕΦΤ) --
-\latintext Friends (\textgreek{F\'ilwn}) of TeX.
+\greekscript Φίλων τοῦ \textlatin{TeX} (ΕΦΤ) --
+\latintext Friends (\ensuregreek{F\'ilwn}) of TeX.
``greek.ldf'' has some workarounds, so that macros relying on Latin
characters in the ``right'' positions keep working. We test, that these
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.pdf b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.pdf
index 835ec064594..318f4776189 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.pdf
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.tex b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.tex
index 52249b089e7..e0e233f03d5 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.tex
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-greek.tex
@@ -4,33 +4,33 @@
\usepackage{parskip}
\usepackage{fontspec}
-% \usepackage{libertineotf}
\setmainfont{Linux Libertine O}
\setsansfont{Linux Biolinum O}
% \setmainfont{DejaVu Serif}
% \setmainfont{Droid Serif} % only monotonic Greek (subset of Greek and Coptic)
-% Declare the font encoding and Greek LICR definitions:
-\usepackage{textalpha}[2013/09/11]
-
\usepackage[greek,english]{babel}
% \languageattribute{greek}{polutoniko}
-\DeclareTextCommandDefault{\ensuregreek}{\textgreek}
+\message{greek-euenc ist}
+\makeatletter
+\@ifl@aded{def}{greek-fontenc}{\message{geladen}}{\message{nicht geladen}}
+\makeatother
+
\begin{document}
\section*{Greek support for Babel with XeTeX/LuaTeX}
-The babel option ``greek'' activates the support for the Greek language
-defined in the file ``greek.ldf'' (source ``greek.dtx'').
+The babel option «greek» activates the support for the Greek language
+defined in the file «greek.ldf» (source «greek.dtx»).
Typesetting Greek texts requires a font containing Greek letters. With the
-XeTeX or LuaTeX engines, the user should ensure that the choosen font
+XeTeX or LuaTeX engines, the user must ensure that the selected font
contains the required glyphs (the default Latin Modern fonts miss them).
-Examples for suitable fonts are the ``Deja Vu'', ``Linux Libertine'', or
-``Free Serif'' OpenType fonts.
+Examples for suitable fonts are the «Deja Vu», «Linux Libertine», or
+«Free Serif» OpenType fonts.
\section{Language Switch}
@@ -43,15 +43,39 @@ The declaration \verb|\selectlanguage| switches between languages.
ἐρῶν άπῆλθες εὐθύς;
\end{quote}
-The macro \verb|\foreignlanguage| sets its second argument in the specified
-language. This is intended for short text parts like
+The command \verb|\foreignlanguage| sets its second argument in the language
+specified as first argument. This is intended for short text parts like
\foreignlanguage{greek}{Βιβλιοθήκη}.
\section{Font Encoding}
-In Greek text parts, the font encoding is automatically set to LGR if an
-8-bit TeX engine is used. With XeTeX or LuaTeX, the macros
-\verb|\greektext| and \verb|\textgreek| don't change the font encoding.
+Switching to a font encoding supporting the Greek script is possible without
+switching the Babel language using the declarations \verb|\greekscript| (no
+switch if the current encoding supports Greek script) or \verb|\greektext|
+(always switch to LGR). The corresponding macros \verb|\ensuregreek| and
+\verb|\textgreek| typeset their argument in a Greek-supporting font encoding.
+
+With XeTeX or LuaTeX, declaring the LGR font encoding is optional.
+The macros \verb|\greektext| and \verb|\textgreek| are
+only defined, if the LGR font encoding is declared via the \texttt{fontenc}
+package \emph{before} loading babel (see test-unicode-lgr.tex).
+
+Every language switch to \texttt{greek} calls the \verb|\extrasgreek|
+command which in turn calls \verb|\greekscript| to ensure a Greek-supporting
+font encoding (LGR, EU1, or EU2). (For customization, you can add to or
+redefine the \verb|\extrasgreek| command.)
+
+The LGR font encoding does not support Latin characters. Therefore, the
+Babel core defines the declaration \verb|\latintext| and the command
+\verb|\textlatin| to switch to the T1 or OT1 font encoding or typeset the
+argument using this encoding. \texttt{greek-fontenc} adds a test for EU1 and
+EU2. At this point, the «latinencoding» is \latinencoding.
+
+Every language switch from \texttt{greek} calls the \verb|\noextrasgreek|
+command which in turn calls \verb|\latintext|. (For customization, you can
+add to or redefine the \verb|\noextrasgreek| command.)
+
+% don't change the font encoding.
Latin characters can be used in Greek text parts,
input via the Latin transcription defined in LGR is not possible.%
\footnote{%
@@ -60,8 +84,8 @@ input via the Latin transcription defined in LGR is not possible.%
}
\begin{quote}
- \greektext Φίλων τοῦ \textlatin{TeX} (ΕΦΤ) --
- \latintext Friends (\textgreek{F\'ilwn}) of TeX.%
+ \greekscript Φίλων τοῦ \textlatin{TeX} (ΕΦΤ) --
+ \latintext Friends (\ensuregreek{F\'ilwn}) of TeX.%
\footnote{Compare the printout to the similar example in test-greek.pdf.}
\end{quote}
@@ -193,10 +217,9 @@ Babel defines macros for several autogenerated strings so that they may
appear in the choosen language. \emph{babel-greek} uses LICR macros in
order to let the string macros work independent of the font encoding.
-Until automatically done by \emph{euenc} for EU1 and EU2 font encodings, the
-recommended way to load Greek LICR definitions is via the \emph{textalpha}
-or \emph{alphabeta} packages provided with \emph{greek-fontenc} since
-version~0.10.
+If \texttt{fontspec} is loaded before babel, babel-greek loads Greek LICR
+for EU1 or EU2 from the file \texttt{greek-euenc.def}
+provided with \emph{greek-fontenc} since version~0.10.
\subsection{Hiatus}
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.pdf b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.pdf
new file mode 100644
index 00000000000..6dc3bd1b53a
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.tex b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.tex
new file mode 100644
index 00000000000..5e5711f2313
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/babel-greek/test-unicode-lgr.tex
@@ -0,0 +1,273 @@
+\documentclass[a4paper]{article}
+% \usepackage{textcomp}
+\usepackage{hyperref,bookmark}
+\usepackage{parskip}
+
+% Declare the font encoding and Greek LICR definitions:
+\usepackage[LGR]{fontenc}
+\usepackage{textalpha}[2013/09/11]
+
+% Set up Latin Modern OpenType unicode font
+\usepackage{fontspec}
+
+\usepackage[greek,english]{babel}
+% \languageattribute{greek}{polutoniko}
+
+% use LGR (8-bit CB-fonts) instead of Unicode fonts for Greek:
+% \renewcommand*{\greekscript}{\fontencoding{LGR}\selectfont}
+\addto{\extrasgreek}{\greektext}
+
+
+\begin{document}
+
+
+\section*{XeTeX/LuaTeX with LGR fonts}
+
+The babel option «greek» activates the support for the Greek language
+defined in the file «greek.ldf» (source «greek.dtx»).
+
+Typesetting Greek texts requires a font containing Greek letters. With the
+XeTeX or LuaTeX engines, the user must ensure that the selected font
+contains the required glyphs (the default Latin Modern fonts miss them).
+
+Latin Modern can combined with the matching CB-Greek 8-bit font. For the
+setup, see the preamble of this document \texttt{test-unicode-lgr.tex}
+
+Caveat: Currently, hyphenation does not work with this setup. Use it only
+for short Greek quotes or as a last ressort.
+
+\section{Language Switch}
+
+The declaration \verb|\selectlanguage| switches between languages.
+With XeTeX/LuaTeX and LGR, Unicode input is not possible. Instead, use the
+Latin transliteration or LICR macros:
+
+\begin{quote}
+ \selectlanguage{greek}
+ T'i f'hic? <Id`wn >enj'ede pa~id'' >eleuj'eran\\
+ t`ac plhs'ion N'umfac stefano~usan, S'wstrate,\\
+ >er~wn 'ap~hljec e>uj'uc?
+\end{quote}
+
+The macro \verb|\foreignlanguage| sets its second argument in the specified
+language. This is intended for short text parts like
+\foreignlanguage{greek}{Βιβλιοθήκη}.
+
+\section{Font Encoding}
+
+Switching to a font encoding supporting the Greek script is possible without
+switching the Babel language using the declarations \verb|\greekscript| or
+\verb|\greektext| (always LGR) and the macros \verb|\ensuregreek| or
+\verb|\textgreek|. These commands do not start a new paragraph.
+
+The Babel core defines the declaration \verb|\latintext| and the command
+\verb|\textlatin| to switch to the T1 or OT1 font encoding or typeset the
+argument using this encoding. greek-fontenc adds a test for EU1 and EU2, if
+the TeX engine is XeTeX or LuaTeX. Here, the «latinencoding» is
+\latinencoding.
+
+With XeTeX or LuaTeX, the macros \verb|\greektext| and \verb|\textgreek|
+are only defined, if the LGR font encoding is loaded via the
+\texttt{fontenc} package (see test-unicode-lgr.tex).
+
+% don't change the font encoding.
+With LGR, Latin characters in Greek text parts are typeset as Greek characters
+according to the Latin transcription defined in LGR.%
+
+\begin{quote}
+ \greektext F\'ilwn to\~u \textlatin{TeX} (EFT) --
+ \latintext{Friends (\textgreek{F\'ilwn}) of TeX.}%
+\end{quote}
+
+\section{MakeUppercase, MakeLowercase}
+
+Capital Greek letters have diacritics (except the dialytika and sub-iota) to
+the left (instead of above) and drop them in uppercase.
+
+Tonos and dasia mark a \emph{hiatus} (break-up of a diphthong) if placed on
+the first vowel of a diphtong (\textgreek{\'ai, \'au, \'ei, \'>ai, \'>au,
+\'>ei}). A dialytika must be placed on the second vowel if they are dropped.
+(\foreignlanguage{greek}{\MakeUppercase{\'ai, \'au, \'ei, \'>ai, \'>au,
+\'>ei}}).
+
+\section{LICR Macros}
+
+Babel defines macros for several autogenerated strings so that they may
+appear in the choosen language. \emph{babel-greek} uses LICR macros in
+order to let the string macros work independent of the font encoding.
+
+Until automatically done by \emph{euenc} for EU1 and EU2 font encodings, the
+recommended way to load Greek LICR definitions is via the \emph{textalpha}
+or \emph{alphabeta} packages provided with \emph{greek-fontenc} since
+version~0.10.
+
+\subsection{Hiatus}
+
+The «hiatus» feature works with macro input:
+
+\selectlanguage{greek}
+% from teubner: άυλος/ΑΫΛΟΣ
+\acctonos\textalpha\textupsilon λος $\mapsto$
+\MakeUppercase{\acctonos\textalpha\textupsilon λος},
+\>'\textalpha\textupsilon λος $\mapsto$
+\MakeUppercase{\>'\textalpha\textupsilon λος},
+% from http://diacritics.typo.cz/index.php?id=69 μάινα -> ΜΑΪΝΑ
+m\acctonos\textalpha\textiota να $\mapsto$
+\MakeUppercase{m\acctonos\textalpha\textiota να},
+% from http://de.wikipedia.org/wiki/Neugriechische_Orthographie#Das_Trema
+% κέικ, ἀυπνία/αϋπνία
+\textkappa\acctonos\textepsilon\textiota\textkappa $\mapsto$
+\MakeUppercase{\textkappa\acctonos\textepsilon\textiota\textkappa},
+\>\textalpha\textupsilon πνία $\mapsto$
+\MakeUppercase{\>\textalpha\textupsilon πνία}.
+\selectlanguage{english}
+
+\subsection{Captions}
+
+\selectlanguage{greek}
+\prefacename,
+\refname,
+\abstractname,
+\bibname,
+\chaptername,
+\appendixname,
+\contentsname,
+\listfigurename ,
+\listtablename,
+\indexname,
+\figurename,
+\tablename,
+\partname,
+\enclname,
+\ccname,
+\headtoname,
+\pagename,
+\seename,
+\alsoname,
+\proofname,
+\glossaryname
+\selectlanguage{english}
+
+Test correct upcasing (dropping of accents):
+
+\selectlanguage{greek}
+\MakeUppercase{
+\prefacename,
+\refname,
+\abstractname,
+\bibname,
+\chaptername,
+\appendixname,
+\contentsname,
+\listfigurename,
+\listtablename,
+\indexname,
+\figurename,
+\tablename,
+\partname,
+\enclname,
+\ccname,
+\headtoname,
+\pagename,
+\seename,
+\alsoname,
+\proofname,
+\glossaryname
+}
+\selectlanguage{english}
+
+
+\subsection{Months}
+
+\selectlanguage{greek}
+\newcounter{foo}
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\stepcounter{foo} \month=\value{foo} \today \\
+\selectlanguage{english}
+
+\section{Greek Numerals}
+
+See greek.pdf for the formation rules of Greek numerals.
+Some examples:
+
+\selectlanguage{greek}
+
+\greeknumeral{1},
+\greeknumeral{2},
+\greeknumeral{3},
+\greeknumeral{4},
+\greeknumeral{5},
+\greeknumeral{6},
+\greeknumeral{7},
+\greeknumeral{8},
+\greeknumeral{9},
+\greeknumeral{10},
+\greeknumeral{11},
+\greeknumeral{12},
+\greeknumeral{20},
+\greeknumeral{345},
+\greeknumeral{500},
+\greeknumeral{1997},
+\greeknumeral{2013},
+
+\Greeknumeral{1},
+\Greeknumeral{2},
+\Greeknumeral{3},
+\Greeknumeral{4},
+\Greeknumeral{5},
+\Greeknumeral{6},
+\Greeknumeral{7},
+\Greeknumeral{8},
+\Greeknumeral{9},
+\Greeknumeral{10},
+\Greeknumeral{11},
+\Greeknumeral{12},
+\Greeknumeral{20},
+\Greeknumeral{345},
+\Greeknumeral{500},
+\Greeknumeral{1997},
+\Greeknumeral{2013},
+
+
+Enumerated lists use Greek characters/numerals in the second and fourth level:
+
+\selectlanguage{greek}
+\begin{enumerate}
+ \item item 1
+ \begin{enumerate}
+ \item item 1.1
+ \begin{enumerate}
+ \item item 1.1.1
+ \begin{enumerate}
+ \item item 1.1.1.1
+ \item item 1.1.1.2
+ \end{enumerate}
+ \item item 1.1.2
+ \end{enumerate}
+ \end{enumerate}
+\end{enumerate}
+\selectlanguage{english}
+
+
+This may be problematic with fonts that only partially support Greek and
+miss the numeral signs (dexiakeraia and aristerikeraia). If you prefer the
+"normal" enumeration, write in the preamble after loading babel:
+
+\begin{verbatim}
+ \makeatletter
+ \addto\extrasgreek{\let\@alph\latin@alph
+ \let\@Alph\latin@Alph}
+ \makeatother
+\end{verbatim}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/generic/babel-greek/usage.pdf b/Master/texmf-dist/doc/generic/babel-greek/usage.pdf
index 0c4e0d954c9..4ab9dae3344 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/usage.pdf
+++ b/Master/texmf-dist/doc/generic/babel-greek/usage.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-greek/usage.tex b/Master/texmf-dist/doc/generic/babel-greek/usage.tex
index 57edc7f78a5..c5bd0dc87ea 100644
--- a/Master/texmf-dist/doc/generic/babel-greek/usage.tex
+++ b/Master/texmf-dist/doc/generic/babel-greek/usage.tex
@@ -45,8 +45,17 @@
e-mail: \texttt{apostolo@platon.ee.duth.gr}}
\date{October 15, 1997}
\maketitle
+
+\abstract{\noindent
+This document describes the use of the Latin transliteration for Greek that
+is defined by the LGR font encoding. Today, all modern LaTeX distributions
+support literal input of Greek, which is the preferred method for new
+documents. [G. Milde 2013/12/02]}
+
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{Overview}
+
The \texttt{greek} option of the \texttt{babel} package is an attempt to
make it possible for someone to write Greek text with \LaTeX. The current
version of the \texttt{greek} option supports the