summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/generic/babel-estonian
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-08-05 20:13:30 +0000
committerKarl Berry <karl@freefriends.org>2015-08-05 20:13:30 +0000
commit75407eb95e7f8d1a86497cb63ac3c30e8f48904f (patch)
tree9f7ed153c507f6795d47a1db4c7848ab86952018 /Master/texmf-dist/source/generic/babel-estonian
parent6dbc95dc8a019cc2b56aafe2901d7136f35ea408 (diff)
babel-estonian (5aug15)
git-svn-id: svn://tug.org/texlive/trunk@38048 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/generic/babel-estonian')
-rw-r--r--Master/texmf-dist/source/generic/babel-estonian/estonian.dtx81
1 files changed, 45 insertions, 36 deletions
diff --git a/Master/texmf-dist/source/generic/babel-estonian/estonian.dtx b/Master/texmf-dist/source/generic/babel-estonian/estonian.dtx
index aa7cc664f95..e0fa44272ba 100644
--- a/Master/texmf-dist/source/generic/babel-estonian/estonian.dtx
+++ b/Master/texmf-dist/source/generic/babel-estonian/estonian.dtx
@@ -1,6 +1,6 @@
% \iffalse meta-comment
%
-% Copyright 1989-2009 Johannes L. Braams and any individual authors
+% Copyright 1989-2015 Johannes L. Braams and any individual authors
% listed elsewhere in this file. All rights reserved.
%
% This file is part of the Babel system.
@@ -36,7 +36,7 @@
%<code>\ProvidesLanguage{estonian}
%\fi
%\ProvidesFile{estonian.dtx}
- [2014/02/20 v1.1 Estonian support from the babel system]
+ [2015/08/05 v1.1a Estonian support for the babel system]
%\iffalse
%% File `estonian.dtx'
%% Babel package for LaTeX version 2e
@@ -55,14 +55,14 @@
%
% Johannes Braams, TeXniek
%
-%% Please report errors to: Jaan Vajakas jv at ut.ee
+%% Please report errors to: Jaan Vajakas jaanvajakas at hot.ee
%% (or Enn Saar saar at aai.ee
%% or J. L. Braams babel at braams.xs4all.nl)
%
% This file is part of the babel system, it provides the source
% code for the Estonian language definition file. The original
% version of this file was written by Enn Saar (saar@aai.ee).
-% Modified by Jaan Vajakas (jv@ut.ee).
+% Modified by Jaan Vajakas (jaanvajakas@hot.ee).
%<*filedriver>
\documentclass{ltxdoc}
\newcommand*\TeXhax{\TeX hax}
@@ -77,6 +77,8 @@
%</filedriver>
%\fi
%
+% \RecordChanges
+%
% \changes{estonian-1.0b}{1995/06/16}{corrected typos}
% \changes{estonian-1.0e}{1996/10/10}{Replaced \cs{undefined} with
% \cs{@undefined} and \cs{empty} with \cs{@empty} for consistency
@@ -86,12 +88,13 @@
% commands \texttt{"-} and \cs{-}}
% \changes{estonian-1.1}{2014/02/20}{added usage guidelines to the
% documentation}
+% \changes{estonian-1.1a}{2015/08/05}{small improvements in documentation}
%
% \GetFileInfo{estonian.dtx}
%
% \title{Estonian language support for \babel}
% \author{Enn Saar\footnote{\texttt{saar@aai.ee}, original author (inactive)},
-% Jaan Vajakas\footnote{\texttt{jv@ut.ee}, maintainer since version 1.0k}}
+% Jaan Vajakas\footnote{\texttt{jaanvajakas@hot.ee}, maintainer since version 1.0k}}
% \date{\filedate, \fileversion}
%
% \maketitle
@@ -118,7 +121,7 @@
% |"u| & |\"u|, (and uppercase); \\
% |~s| & |\v s|, (and uppercase); \\
% |~z| & |\v z|, (and uppercase); \\
-% \verb="|= & disable ligature at this position; \\
+% \verb="|= & disable ligature at this position and allow hyphenation at this position; \\
% |"-| & like |\-|, but allowing hyphenation
% in the rest of the word;\\
% |"`| & for Estonian low left double quotes (same as German);\\
@@ -156,17 +159,17 @@
%\usepackage{fontspec}
%\end{verbatim}
% \end{itemize}
-% When saving your file with your text editor, make sure it is saved in the UTF-8 encoding.
+% When saving your file, make sure your text editor saves it in the UTF-8 encoding.
%
% In the following subsections, the rationale of these options is explained.
-% Some authors have also advised not to use ligatures in Estonian;
-% the last subsection discusses that matter.
+% Some authors have also advised that ligatures should be turned off in Estonian;
+% the last subsection tries to explain why and how.
%
% \subsection{Use the T1 font encoding and avoid CM}
% If using the Estonian package in \LaTeX, it is recommended to choose
-% the T1 output encoding (also known as Cork encoding). It will give you better hyphenation,
-% as the standard Estonian hyphenation file \file{eehyph.tex} is in the Cork encoding.
-% You can choose the T1 output encoding (also known as Cork encoding) by the command
+% the T1 output encoding (also known as the Cork encoding). It will give you better hyphenation,
+% as the standard Estonian hyphenation file \file{eehyph.tex} is in this encoding.
+% You can choose the T1 output encoding with
% |\usepackage[T1]{fontenc}|.
%
% If you like Computer Modern (CM), the default font, then we recommend using
@@ -174,12 +177,12 @@
% has the tilde in the letter ``\~o'' slightly lower, looking more natural.
% (In the OT1 encoding, the Estonian package takes special care to lower the tilde,
% but that feature is not supported for the T1 output encoding since
-% version 1.0k, as it created many issues of its own.)
+% version 1.0k of the Estonian package, as it created many issues of its own.)
%
% In XeLaTeX and LuaLaTeX, the default font (CM) does not support accented letters
% and therefore the \textsf{fontspec} package (or \textsf{xltxtra}) has to be used.
%
-% \subsection{Use UTF-8 and disable tilde shorthands}
+% \subsection{Use UTF-8 and disable the tilde shorthands}
%
% In the early 1990s, handling accented letters was a problem
% for many programs. So shorthands for accented letters in Estonian (|~o|, |"a| etc.) were created.
@@ -187,7 +190,7 @@
% letters from almost all the world's languages in a single text file.
% Therefore it is recommended to use UTF-8 as input encoding and type Estonian accented
% characters directly, instead of using the shorthands. We also recommend UTF-8 over
-% cp1257, the default encoding for Estonian on Windows, since it contains more
+% cp1257, the default encoding for Estonian on Windows, since UTF-8 contains more
% characters and is more likely understood
% by the text editors of your foreign partners.
%
@@ -197,10 +200,10 @@
% However, with |\usepackage[estonian]{babel}| in preamble,
% |U.~S.| is rendered as ``U.\v S.'' by default.
% If you don't need the shorthands starting with tilde,
-% you can restore the original behavior of |~| by using the option
+% you can disable them and restore the original behavior of |~| by using the option
% |notilde|, like this:
%\begin{verbatim}\usepackage[estonian .notilde]{babel}\end{verbatim}
-% The option |notilde| was introduced in version 1.1 of the Estonian package.
+% The option |notilde| was introduced in version 1.1 of the Estonian package (released 2014/02/21).
% If you need compatibility with older versions, write instead
%\begin{verbatim}
%\usepackage[estonian]{babel}
@@ -214,33 +217,37 @@
% If you don't disable the tilde shorthands, you must write |U.\nobreak{} S.|
%
% \subsection{Ligatures}
-% Ligatures have been considered unsuitable for Estonian by some authors.\footnote{
-% In their ``L\"uhike \LaTeX i\~opetus'', Henn Saar and Hans Ibrus recommend against
-% using ligatures in Estonian, giving the word ``fiiber'' as a bad example.
-% Indeed, ``ii'' denotes a single long vowel in Estonian, but the ligature seems to suggest
+% Using ligatures in Estonian is discouraged by some authors; it may
+% slightly harm readability and has been uncommon in the past.\footnote{
+% In their ``L\"uhike \LaTeX i\~opetus'' (1994), Hans Ibrus and Enn Saar say that \TeX's ligatures
+% are ``not recommended'' in Estonian and give the word ``fiiber'' as a (perhaps particularly) bad example.
+% Indeed, ``ii'' denotes a single long vowel, but the ligature seems to suggest
% that instead the first two letters ``f'' and ``i'' are grouped together.
-% Ligatures are practically absent from Estonian books published during the Soviet
-% period (e. g. mathematical books have no ligature in ``def\/initsioon'').
-% However, during Estonia's first independence period, ligatures, while not ubiquitous,
-% did appear in some books: e.~g. Borkvell's ``Tasapinnalise ja ruumilise anal\"u\"utilise geomeetria p\~ohijooni'' from 1937
-% (``Determinandi definitsioon'' with fi ligature) or ``Eesti Ents\"uklopeedia'' from 1932--1937
-% (having even ``Af\/fiinsus'' with ligature fi --- in this case probably for the convenience of the typesetter rather than the reader).}
-% By default, \TeX{} creates ligatures fi, ff, fl, ffi and ffl in the CM fonts (other fonts may have other
-% ligatures). This package offers the command \verb="|= for disabling ligatures one-by-one,
-% but if you want to get rid of all ligatures in \LaTeX, include the following lines in your preamble:\footnote{
-% Note that the above only disables ligatures starting with f.
-% You would not want to apply {\tt DisableLigatures} to all letter combinations,
+% Ligatures are practically absent from Estonian books published throughout the Soviet
+% period (e.~g. mathematical books have no ligature in ``def\/initsioon'').
+% During Estonia's first independence period, ligatures
+% did occasionally appear in books: e.~g. Borkvell's ``Tasapinnalise ja ruumilise anal\"u\"utilise geomeetria p\~ohijooni'' from 1937
+% (fi ligature in ``definitsioon'') or ``Eesti Ents\"uklopeedia'' from 1932--1937
+% (having e.~g. ``Af\/fiinsus'' with ligature fi, but ``Af\/f\/iks'' without ligatures and ``aff\/iinseks'' with ligature ff ---
+% so ligatures were used quite randomly and arguably for the convenience of the typesetter rather than the reader).}
+% By default, \TeX{} creates the ligatures fi, ff, fl, ffi and ffl in the CM fonts (other fonts may have other
+% ligatures). You can disable ligatures one by one (e.~g. \verb=f\/ii"-ber= or {\tt \v sef"\textbar lu"-se}\footnote{The commands {\tt \textbackslash/} and {\tt "\textbar} both disable ligature; the latter also enables hyphenation \emph{\v sef-luse}. Unfortunately both disable hyphenation in the rest of the word; that's why we need the {\tt "-} here.}),
+% but if you want to get rid of all ligatures, then
+% \begin{itemize}
+% \item in \LaTeX, include the following two lines in your preamble:\footnote{
+% Note that these two lines disable only ligatures starting with f.
+% You would not want to apply {\tt \textbackslash DisableLigatures} to all letter combinations,
% since it also disables kerning (and letter combinations like
-% ``VA'' and ``Ve'' look much nicer with kerning).}
+% ``Ve'' and ``AV'' look much nicer with kerning).}
%\begin{verbatim}
%\usepackage{microtype}
%\DisableLigatures[f]{encoding = *, family = * }
%\end{verbatim}
-% In XeLaTeX and LuaLaTeX, use the following line instead (replace the font name):
+% \item in XeLaTeX and LuaLaTeX, use this line instead (replace the font name):
%\begin{verbatim}
%\setmainfont[Ligatures={NoRequired,NoCommon,NoContextual}]{Font Name}
%\end{verbatim}
-%
+% \end{itemize}
% \StopEventually{}
%
% \section{Implementation}
@@ -401,7 +408,7 @@
% better without redefining it (e. g. words containing |\et@gentilde|
% are not hyphenated unless |\allowhyphens| is used; when copied from
% Acrobat Reader, pasting an \~o generated using |\et@gentilde{o}|
-% gives |~o| rather than \~o; when the times package is used with T1
+% gives |~o| rather than \~o; when the \textsf{times} package is used with T1
% encoding, |\et@gentilde| places the tilde through the letter o).
% In plain \TeX\ there is no encoding infrastructure, so we just
% redefine |\~|.
@@ -550,6 +557,8 @@
%</code>
% \end{macrocode}
%
+% \PrintChanges
+%
% \Finale
%%
%% \CharacterTable