From d9add100de8f268f2b408533a41cc5624ef1ee7a Mon Sep 17 00:00:00 2001
From: Karl Berry
Date: Wed, 17 Jul 2013 22:12:47 +0000
Subject: greek-fontenc (17jul13)
git-svn-id: svn://tug.org/texlive/trunk@31220 c570f23f-e606-0410-a88d-b1316a301751
---
Master/texmf-dist/doc/latex/greek-fontenc/README | 234 +++++++-
.../texmf-dist/doc/latex/greek-fontenc/README.html | 241 +++++++--
.../doc/latex/greek-fontenc/diacritics.pdf | Bin 0 -> 255992 bytes
.../doc/latex/greek-fontenc/diacritics.tex | 160 ++++++
.../doc/latex/greek-fontenc/greek-euenc.def.html | 568 ++++++++++++++++++++
.../doc/latex/greek-fontenc/greek-fontenc.def.html | 324 +++++++++++
.../doc/latex/greek-fontenc/greekhyperref.pdf | Bin 0 -> 217608 bytes
.../doc/latex/greek-fontenc/greekhyperref.tex | 124 +++++
.../doc/latex/greek-fontenc/lgr2licr.lua | 169 ++++++
.../doc/latex/greek-fontenc/lgr2licr.lua.html | 139 +++++
.../doc/latex/greek-fontenc/lgrenc-test.pdf | Bin 257385 -> 284966 bytes
.../doc/latex/greek-fontenc/lgrenc-test.tex | 70 ++-
.../doc/latex/greek-fontenc/lgrenc.def.html | 590 ++++-----------------
.../doc/latex/greek-fontenc/lgrenc.def.txt | 25 +-
.../doc/latex/greek-fontenc/test-euenc.pdf | Bin 0 -> 46487 bytes
.../doc/latex/greek-fontenc/test-euenc.tex | 580 ++++++++++++++++++++
.../doc/latex/greek-fontenc/test-xunicode.pdf | Bin 0 -> 59769 bytes
.../doc/latex/greek-fontenc/test-xunicode.tex | 585 ++++++++++++++++++++
.../latex/greek-fontenc/xunicode-greek.sty.html | 585 ++++++++++++++++++++
19 files changed, 3824 insertions(+), 570 deletions(-)
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/diacritics.pdf
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/diacritics.tex
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/greek-euenc.def.html
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/greek-fontenc.def.html
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/greekhyperref.pdf
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/greekhyperref.tex
create mode 100755 Master/texmf-dist/doc/latex/greek-fontenc/lgr2licr.lua
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/lgr2licr.lua.html
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/test-euenc.pdf
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/test-euenc.tex
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/test-xunicode.pdf
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/test-xunicode.tex
create mode 100644 Master/texmf-dist/doc/latex/greek-fontenc/xunicode-greek.sty.html
(limited to 'Master/texmf-dist/doc')
diff --git a/Master/texmf-dist/doc/latex/greek-fontenc/README b/Master/texmf-dist/doc/latex/greek-fontenc/README
index 71d869868ad..f1934a3a0ac 100644
--- a/Master/texmf-dist/doc/latex/greek-fontenc/README
+++ b/Master/texmf-dist/doc/latex/greek-fontenc/README
@@ -25,31 +25,46 @@ Greek font encoding definition files
Files
=====
+``_
+ `Common Greek font encoding definitions `_.
+
``_
- font encoding definitions for LGR
+ font encoding definitions for LGR_.
+
+ The literate source ``_ was converted with PyLit_ to TeX
+ code and with Docutils_ to the documentation `LGR Greek font encoding
+ definitions `_.
This file is the successor of the basic LGR encoding definition file which
comes with babel_'s Greek support and ``lgrxenc.def`` from the lgrx_
- bundle. It defines LICR macros for Greek characters that select
- pre-composed glyphs if possible and places the diacritics according to
- Greek typesetting rules else. Combined accents can be specified as
- backslash + transliteration (``\~>\textalpha``) or iteratively
- (``\~\>\textalpha``).
-
-``_
- literate source (reStructuredText_ format)
+ bundle.
+
+``_
+ test example, source ``_,
+
+``_
+ `Greek script in PDF metadata`, source ``_
-``_
- literate source (HTML format)
+ The package hyperref_ defines the PU font encoding which also supports
+ (monotonic) Greek.
-``_
- test example
+Experimental files that are still in development and will eventually be
+moved to/merged with other packages:
-``_
- test output
+``_
+ `xunicode extension for Greek `_
+
+``_
+ Example for use of the experimental Greek LICR definitions with XeTeX.
+
+``_
+ `Greek LICR definitions for XeTeX and LuaTeX `_
+
+``_
+ Example for use of the experimental Greek LICR definitions with XeTeX.
-The literate source was converted with PyLit_ to TeX and with Docutils_ to
-HTML format.
+``_
+ `LGR Transcription to Greek LICR transformation `_
Installation
@@ -58,12 +73,14 @@ Installation
If possible, get this package from your distribution using its installation
manager.
-Otherwise, make sure LaTeX can find the file `lgrenc.def`:
+Otherwise, make sure LaTeX can find the files ``lgrenc.def``,
+``greek-fontenc.def`` and eventually ``xunicode-greek.sty`` and
+``greek-euenc.def``:
-* Download and unpack `greek-fontenc.zip` or just download ``_.
+* Download and unpack ``greek-fontenc.zip``.
-* Copy/Move/Link ``lgrenc.def`` to a suitable place in the TDS_ and run
- ``texhash``, or place it in the current working directory (e.g. for
+* Copy/Move/Link the files to a suitable place in the TDS_ and run
+ ``texhash``, or place them in the current working directory (e.g. for
testing).
Usage
@@ -76,6 +93,24 @@ Pass the encoding name as option to fontenc_. For example, specify T1
See [fntguide]_ for details and ``_ for an example.
+For XeTeX/LuaTeX, you can specify the EU1/EU2 encoding and
+load the experimental ``xunicode-greek``::
+
+ \usepackage[EU1]{fontenc} % XeTeX
+ % \usepackage[EU2]{fontenc} % LuaTeX
+ \usepackage{xunicode-greek}
+
+or ``greek-euenc.def``::
+
+ \usepackage[EU1]{fontenc} % XeTeX
+ % \usepackage[EU2]{fontenc} % LuaTeX
+ \makeatletter
+ \input{greek-euenc.def}
+ \makeatother
+
+However, XeTeX/LuaTeX usage details are very likely to change in the
+future!!!
+
Greek text font encodings
=========================
@@ -123,11 +158,153 @@ transliteration scheme (also explained in [babel-patch]_).
It is currently not supported by `greek-fontenc`.
The font encoding file ``lgienc.def`` from ibycus-babel_ provides a basic
-setup (without LICR macros or composite definitions).
+setup (without any LICR macros or composite definitions).
+
+
+Greek LICR macro names
+======================
+
+This package provides LaTeX internal character representations (LICR macros)
+for Greek letters and diacritics. Macro names were selected based on the
+following considerations:
+
+The fntguide_ (section 6.4 Naming conventions) recommends:
+
+ Where possible, text symbols should be named as ``\text`` followed
+ by the Adobe glyph name: for example ``\textonequarter`` or
+ ``\textsterling``. Similarly, math symbols should be named as
+ ``\math`` followed by the glyph name, for example
+ ``\mathonequarter`` or ``\mathsterling``.
+
+The `Adobe Glyph List For New Fonts`_ has names for many glyphs in the
+`Greek and Coptic` Unicode block, but not for `Greek extended`. The `Adobe
+Glyph List`_ (for existing fonts) lists additional glyph names used in older
+fonts. As these are not intened for further active use, the latter are not
+considered in the name choice.
+
+Proposals
+---------
+
+* If there exists a math-mode macro for a symbol, form the corresponding text
+ macro by prepending ``text``?
+
+ Example:
+ The glyph name for the GREEK SMALL LETTER FINAL SIGMA is ``sigma1``,
+ the corresponding math-macro is ``\varsigma``. The text symbol could be
+ made available as ``\textvarsigma``.
+
+ Problems:
+ ``\varepsilon`` and ``\varphi`` math macros map to characters named
+ "GREEK SMALL **LETTER** ...", while ``\\vartheta``, ``\\varkappa``,
+ ``\\varrho``, and ``\\varpi`` math macros map to "GREEK ... **SYMBOL**"
+ Unicode characters.
+
+ In Greek text, these variants are interchangeable. The LGR font encoding
+ does not contain slots for "symbol" glyph variants. In some Greek fonts,
+ GREEK SMALL LETTERS use glyph variants resembling the corresponding
+ GREEK SYMBOL Unicode character's reference glyph.
+
+* Derive macro names from Unicode names?
+
+ The `Unicode names list`_ provides standardized descriptive names for all
+ Unicode characters that use only capital letters of the Latin alphabet.
+ While not suited for direct use in a LICR macros, they can be either
+
+ a) used as inspiration for new LICR macro names or
+
+ b) converted to LICR macro names via a defined set of transformation rules.
+
+ Example:
+ ``\textfinalsigma`` or just ``\finalsigma`` as a more descriptive name
+ for GREEK SMALL LETTER FINAL SIGMA derived via the rules:
+
+ * drop "LETTER" if the name remains unique,
+ * drop "GREEK" if the name remains unique,
+ * use capitalized name for capital letters, lowercase for "SMALL" letters
+ and drop "SMALL",
+ * concatenate
+
+* Omit the "text" prefix for macros that do not have a math counterpart?
+
+ Pro:
+ + Simpler,
+
+ + ease of use (less typing, better readability of source text),
+
+ + many established text macro names without "text",
+
+ + there are examples of encoding-specific macros
+ without the ``text``-prefix, especially for letters,
+
+ :T1: ``\AE \DH \DJ \L \NG \OE \O \SS \TH \ae \dh \dj \guillemotleft``
+ ``\guillemotright \guilsinglleft \guilsinglright \i \j \l \ng``
+ ``\oe \o \quotedblbase \quotesinglbase \ss \th`` (also in OT1)
+ :T2*: ``\CYR*`` and ``\cyr*``
+ :HE8: ``\heb*`` or no prefix
+ :PU: short descriptive names in the arabic part (``puarenc.def``)
+
+ + ``text`` prefix does **not** mark a macro as encoding-specific or
+ "inserting a glyph". There are e.g. font-changing macros (``\textbf``,
+ ``\textit``) and encoding-changing macros (``\textgreek``,
+ ``\textcyr``).
+
+ Contra:
+ - Less consistent.
+
+ - ``text`` prefix marks a macro as confined to text mode.
+
+ Conclusion:
+ To avoid name clashes, this package uses the ``text`` prefix
+ for symbols. Aliases (short forms, compatibility defs, etc.) can be
+ defined in packages.
+
+
+How to name *accent macros*?
+----------------------------
+
+* standard accent macros (``\DeclareTextAccent`` definitions in
+ ``latex/base/...``) are one-symbol macros (``\' \" ... \u \v ...``) .
+
+* ``tipa.sty``, ``xunicode``, and ucs_ use the "text" prefix also for accents.
+
+ However, the `Adobe Glyph List For New Fonts`_ maps, e.g., "tonos" and
+ "dieresistonos" to 0384 GREEK TONOS and 0385 GREEK DIALYTIKA TONOS, hence
+ `\texttonos` and `\textdiaresistonos` should be spacing characters.
+
+* textcomp (ts1enc.def) defines ``\capital...`` accents (i.e. without
+ ``text`` prefix).
+
+* Use a common prefix ``\textaccent...``, ``\accent...``,
+ or just ``\acc...`` (cf ``\@tabacckludge``)?
+
+Currently, `greek-fontenc` uses for diacritics:
+
+- Greek names like in Unicode, and ucsencs.def
+
+- The prefix "acc" to distinguish the macros as `TextAaccent` and reduce the
+ risc of name clashes.
+
+- For the end-user "symbol macros" (``\~ \' \` \" \< \>``) are provided.
References
-==========
+----------
+
+An alternative, more complete set of short mnemonic character names is
+the `XML Entity Definitions for Characters`_ W3C Recommendation from
+01 April 2010.
+
+For glyph names of the LGR encoding see e.g. ``CB.enc`` by Apostolos
+Syropoulos and ``xl-lgr.enc`` from the libertine_ (legacy) package.
+``lgr.cmap`` provides a mapping to Unicode characters.
+
+A full set of ``\text*`` symbol macros is defined in ``ucsencs.def``
+from the ucs_ package.
+
+Aliases from ``puenc.def`` ensure that the hyperref_ package can convert
+Greek text in "LICR encoding" to a PDF-string (utf-8 encoded input is used
+as-is).
+
.. [fntguide] LaTeX3 Project Team, `LaTeX2ε font selection`, 2005.
http://mirror.ctan.org/macros/latex/doc/fntguide.pdf
@@ -153,6 +330,14 @@ References
.. _Docutils: http://docutils.sourceforge.net/rst.html
.. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds
+.. _Adobe Glyph List For New Fonts:
+ http://www.adobe.com/devnet-archive/opentype/archives/aglfn.txt
+.. _Adobe Glyph List:
+ http://partners.adobe.com/public/developer/en/opentype/glyphlist.txt
+.. _Unicode names list: http://www.unicode.org/Public/UNIDATA/NamesList.txt
+.. _XML Entity Definitions for Characters:
+ http://www.w3.org/TR/xml-entity-names/
+
.. _CB Fonts: http://www.ctan.org/pkg/cbgreek-complete
.. _GFS font collection: http://www.ctan.org/pkg/gfs
.. _Kerkis: http://www.ctan.org/pkg/kerkis
@@ -163,4 +348,7 @@ References
.. _ibycus-babel: http://www.ctan.org/pkg/ibycus-babel
.. _ibygrk: http://www.ctan.org/pkg/ibygrk
.. _lgrx: http://www.ctan.org/pkg/lgrx
+.. _libertine: http://www.ctan.org/pkg/libertine-legacy
.. _substitutefont: http://www.ctan.org/pkg/substitutefont
+.. _ucs: http://www.ctan.org/pkg/unicode
+
diff --git a/Master/texmf-dist/doc/latex/greek-fontenc/README.html b/Master/texmf-dist/doc/latex/greek-fontenc/README.html
index 9a5344eb640..3a811d6cc83 100644
--- a/Master/texmf-dist/doc/latex/greek-fontenc/README.html
+++ b/Master/texmf-dist/doc/latex/greek-fontenc/README.html
@@ -47,41 +47,58 @@ punctuation may change in future versions.
Installation
If possible, get this package from your distribution using its installation
manager.
-
Otherwise, make sure LaTeX can find the file lgrenc.def:
+
Otherwise, make sure LaTeX can find the files lgrenc.def,
+greek-fontenc.def and eventually xunicode-greek.sty and
+greek-euenc.def:
-Download and unpack greek-fontenc.zip or just download lgrenc.def.
-Copy/Move/Link lgrenc.def to a suitable place in the TDS and run
-texhash, or place it in the current working directory (e.g. for
+
Download and unpack greek-fontenc.zip.
+Copy/Move/Link the files to a suitable place in the TDS and run
+texhash, or place them in the current working directory (e.g. for
testing).
@@ -91,7 +108,22 @@ testing).
(Latin) as default font encoding and LGR for Greek with
\usepackage[LGR,T1]{fontenc}
-See [fntguide] for details and lgrenc-test.tex for an example.
+See [fntguide] for details and lgrenc-test.tex for an example.
+For XeTeX/LuaTeX, you can specify the EU1/EU2 encoding and
+load the experimental xunicode-greek:
+\usepackage[EU1]{fontenc} % XeTeX
+% \usepackage[EU2]{fontenc} % LuaTeX
+\usepackage{xunicode-greek}
+
+or greek-euenc.def:
+\usepackage[EU1]{fontenc} % XeTeX
+% \usepackage[EU2]{fontenc} % LuaTeX
+\makeatletter
+\input{greek-euenc.def}
+\makeatother
+
+However, XeTeX/LuaTeX usage details are very likely to change in the
+future!!!
Greek text font encodings
@@ -100,7 +132,7 @@ Greek letters and symbols are also defined in the Unicode-based font
encodings EU1 (XeTeX), EU2 (LuaTeX) and PU (
hyperref).
T7
-
The [encguide] reserves the name T7 for a Greek standard font encoding.
+
The [encguide] reserves the name T7 for a Greek standard font encoding.
However, up to now, there is no agreement on an implementation because the
restrictions for general text encodings are too severe for typesetting
polytonic Greek.
@@ -115,7 +147,7 @@ is facilitated by the
[greek-usage],
[teubner-doc],
[cbfonts]).
+font (see
[greek-usage],
[teubner-doc],
[cbfonts]).
A major drawback of the 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 Babel language greek or polutionikogreek).
@@ -127,48 +159,192 @@ Unicode (with XeTeX or LuaTeX).
LGI
The ‘Ibycus’ fonts from the package ibygrk implement an alternative
-transliteration scheme (also explained in [babel-patch]).
+transliteration scheme (also explained in [babel-patch]).
It is currently not supported by greek-fontenc.
The font encoding file lgienc.def from ibycus-babel provides a basic
-setup (without LICR macros or composite definitions).
+setup (without any LICR macros or composite definitions).
+
+
+
+
Greek LICR macro names
+
This package provides LaTeX internal character representations (LICR macros)
+for Greek letters and diacritics. Macro names were selected based on the
+following considerations:
+
The fntguide (section 6.4 Naming conventions) recommends:
+
+Where possible, text symbols should be named as \text followed
+by the Adobe glyph name: for example \textonequarter or
+\textsterling. Similarly, math symbols should be named as
+\math followed by the glyph name, for example
+\mathonequarter or \mathsterling.
+
+
The Adobe Glyph List For New Fonts has names for many glyphs in the
+Greek and Coptic Unicode block, but not for Greek extended. The Adobe
+Glyph List (for existing fonts) lists additional glyph names used in older
+fonts. As these are not intened for further active use, the latter are not
+considered in the name choice.
+
+
Proposals
+
+If there exists a math-mode macro for a symbol, form the corresponding text
+macro by prepending text?
+
+- Example:
+The glyph name for the GREEK SMALL LETTER FINAL SIGMA is sigma1,
+the corresponding math-macro is \varsigma. The text symbol could be
+made available as \textvarsigma.
+
+- Problems:
+\varepsilon and \varphi math macros map to characters named
+“GREEK SMALL LETTER …”, while \\vartheta, \\varkappa,
+\\varrho, and \\varpi math macros map to “GREEK … SYMBOL”
+Unicode characters.
+In Greek text, these variants are interchangeable. The LGR font encoding
+does not contain slots for “symbol” glyph variants. In some Greek fonts,
+GREEK SMALL LETTERS use glyph variants resembling the corresponding
+GREEK SYMBOL Unicode character’s reference glyph.
+
+
+
+Derive macro names from Unicode names?
+The Unicode names list provides standardized descriptive names for all
+Unicode characters that use only capital letters of the Latin alphabet.
+While not suited for direct use in a LICR macros, they can be either
+
+used as inspiration for new LICR macro names or
+converted to LICR macro names via a defined set of transformation rules.
+
+
+- Example:
+\textfinalsigma or just \finalsigma as a more descriptive name
+for GREEK SMALL LETTER FINAL SIGMA derived via the rules:
+
+drop “LETTER” if the name remains unique,
+drop “GREEK” if the name remains unique,
+use capitalized name for capital letters, lowercase for “SMALL” letters
+and drop “SMALL”,
+concatenate
+
+
+
+
+Omit the “text” prefix for macros that do not have a math counterpart?
+
+- Pro:
+
+Simpler,
+ease of use (less typing, better readability of source text),
+many established text macro names without “text”,
+there are examples of encoding-specific macros
+without the text-prefix, especially for letters,
+
+- T1
+\AE \DH \DJ \L \NG \OE \O \SS \TH \ae \dh \dj \guillemotleft
+\guillemotright \guilsinglleft \guilsinglright \i \j \l \ng
+\oe \o \quotedblbase \quotesinglbase \ss \th (also in OT1)
+
+- T2*
+\CYR* and \cyr*
+
+- HE8
+\heb* or no prefix
+
+- PU
+short descriptive names in the arabic part (puarenc.def)
+
+
+
+text prefix does not mark a macro as encoding-specific or
+“inserting a glyph”. There are e.g. font-changing macros (\textbf,
+\textit) and encoding-changing macros (\textgreek,
+\textcyr).
+
+
+- Contra:
+-
+
+- Conclusion:
+To avoid name clashes, this package uses the text prefix
+for symbols. Aliases (short forms, compatibility defs, etc.) can be
+defined in packages.
+
+
+
+
+
+
How to name accent macros?
+
+standard accent macros (\DeclareTextAccent definitions in
+latex/base/...) are one-symbol macros (\' \" ... \u \v ...) .
+tipa.sty, xunicode, and ucs use the “text” prefix also for accents.
+However, the Adobe Glyph List For New Fonts maps, e.g., “tonos” and
+“dieresistonos” to 0384 GREEK TONOS and 0385 GREEK DIALYTIKA TONOS, hence
+texttonos and textdiaresistonos should be spacing characters.
+
+textcomp (ts1enc.def) defines \capital... accents (i.e. without
+text prefix).
+Use a common prefix \textaccent..., \accent...,
+or just \acc... (cf \@tabacckludge)?
+
+
Currently, greek-fontenc uses for diacritics:
+
+Greek names like in Unicode, and ucsencs.def
+The prefix “acc” to distinguish the macros as TextAaccent and reduce the
+risc of name clashes.
+For the end-user “symbol macros” (\~ \' \` \" \< \>) are provided.
+
-
References
-
- [fntguide]
+References
+An alternative, more complete set of short mnemonic character names is
+the XML Entity Definitions for Characters W3C Recommendation from
+01 April 2010.
+For glyph names of the LGR encoding see e.g. CB.enc by Apostolos
+Syropoulos and xl-lgr.enc from the libertine (legacy) package.
+lgr.cmap provides a mapping to Unicode characters.
+A full set of \text* symbol macros is defined in ucsencs.def
+from the ucs package.
+Aliases from puenc.def ensure that the hyperref package can convert
+Greek text in “LICR encoding” to a PDF-string (utf-8 encoded input is used
+as-is).
+- [fntguide]
-
LaTeX3 Project Team, LaTeX2ε font selection, 2005.
http://mirror.ctan.org/macros/latex/doc/fntguide.pdf
-- [encguide]
+- [encguide]
-
Frank Mittelbach, Robin Fairbairns, Werner Lemberg,
LaTeX3 Project Team, LaTeX font encodings, 2006.
http://mirror.ctan.org/macros/latex/doc/encguide.pdf
-- [greek-usage]
+- [greek-usage]
-
Apostolos Syropoulos, Writing Greek with the greek option
of the babel package, 1997.
http://www.tug.org/texlive/Contents/live/texmf-dist/doc/generic/babel/greek-usage.pdf
-- [cbfonts]
+- [cbfonts]
-
Claudio Beccari, The CB Greek fonts, Εὔτυπον, τεῦχος № 21, 2008.
http://www.eutypon.gr/eutypon/pdf/e2008-21/e21-a01.pdf
-- [teubner-doc]
+- [teubner-doc]
-
Claudio Beccari, teubner.sty
An extension to the greek option of the babel package, 2011.
http://mirror.ctan.org/macros/latex/contrib/teubner/teubner-doc.pdf
-- [babel-patch]
+- [babel-patch]
-
Werner Lemberg, Unicode support for the Greek LGR
encoding Εὔτυπον, τεῦχος № 20, 2008.
@@ -177,5 +353,6 @@ encoding Εὔτυπον, τεῦχος № 20, 2008.
+