% \iffalse meta-comment
%
% Copyright 1993-1995 the LaTeX3 project and any individual authors
% listed elsewhere in this file.  All rights reserved.
% 
% For further copyright information see the file legal.txt, and any
% other copyright notices in this file.
% 
% This file is part of the LaTeX2e system.
% ----------------------------------------
%   This system is distributed in the hope that it will be useful,
%   but WITHOUT ANY WARRANTY; without even the implied warranty of
%   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
% 
%   For error reports concerning UNCHANGED versions of this file no more
%   than one year old, see bugs.txt.
% 
%   Please do not request updates from us directly.  Primary
%   distribution is through the CTAN archives.
% 
% 
% IMPORTANT COPYRIGHT NOTICE:
% 
% You are NOT ALLOWED to distribute this file alone.
% 
% You are allowed to distribute this file under the condition that it is
% distributed together with all the files listed in manifest.txt.
% 
% If you receive only some of these files from someone, complain!
% 
% Permission is granted to copy this file to another file with a clearly
% different name and to customize the declarations in that copy to serve
% the needs of your installation, provided that you comply with
% the conditions in the file legal.txt.
% 
% However, NO PERMISSION is granted to produce or to distribute a
% modified version of this file under its original name.
%  
% You are NOT ALLOWED to change this file.
% 
% 
% \fi
% \iffalse
%<*driver>
\ProvidesFile{lthyphen.dtx}
%</driver>
%<default>\ProvidesFile{hyphen.ltx}
% \fi
%         \ProvidesFile{lthyphen.dtx}
          [1994/12/01 v1.0g LaTeX Kernel (hyphenation interface)]
%
%
% \CheckSum{13}
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
%
%\iffalse        This is a META comment
%
% File `lthyphen.dtx'.
% Copyright (C) 1994-94 LaTeX3 project, Frank Mittelbach and
% Rainer Sch\"opf, all rights reserved.
%
%\fi
% \GetFileInfo{lthyphen.dtx}
% \title{The \texttt{lthyphen.dtx} file\thanks
%     {This file has version number \fileversion, dated \filedate.}\\
%       for use with \LaTeXe}
% \author{Frank Mittelbach, Chris Rowley \and Rainer Sch\"opf}
%
% \def\dst{{\normalfont\scshape docstrip}}
% \setcounter{StandardModuleDepth}{1}
%
%
% \maketitle
%
% This file contains the code for loading hyphenation patterns into
% \LaTeX. Most of this will end up in a file called
% \texttt{hyphen.ltx}. If you wish to customize your \LaTeX{} system
% in respect of hyphenation patterns, write a file
% \texttt{hyphen.cfg}. If this file exists, it will be loaded instead
% of \texttt{hyphen.ltx}.  See the comments below for additional
% information.
% 
% \StopEventually{}
%
% To produce the printed version of this file the following code
% is used. It can be extracted with the \dst{} program, or one can run
% this file directly through \LaTeXe{}.
%    \begin{macrocode}
%<*driver>
\documentclass{ltxdoc}
\begin{document}
\DocInput{lthyphen.dtx}
\end{document}
%</driver>
%    \end{macrocode}
%
% \changes{v0.1c}{1994/03/07}{move the 2ekernel code to ltfinal.dtx}
% \changes{v1.0g}{1994/12/01}{Rename lthyphen.ltx/cfg to hyphen.ltx/cfg}
%
% The default file |hyphen.ltx| loads hyphenation patterns for US
% english.  If you want to load additional or other hyphenation
% patterns, you should create a file |hyphen.cfg|. This is best done
% by starting from |hyphen.ltx|.
%
% For backward compatibility, the default file, |hyphen.ltx|,
% first tries to load
% the file |hyphen.tex|. If this file exists, an information
% message is issued and the appropriate defaults for \TeX's internal
% parameters are set: |\language| is initialized to $0$, and
% |\lefthyphenmin| and |\righthyphenmin| to $2$ and $3$, respectively,
% to disallow x- or -xx breaks.
%    \begin{macrocode}
%<*default>
\InputIfFileExists{hyphen.tex}%
   {\message{Loading hyphenation patterns for US english.}%
    \language=0
    \lefthyphenmin=2 \righthyphenmin=3 }%
%    \end{macrocode}
% Otherwise, since we cannot do anything without any hyphenation
% patterns, an error message is printed and the Ini\TeX{} run
% is terminated by invoking |\@@end| (which is the \LaTeXe{} name
% for \TeX's |\end| primitive).
%    \begin{macrocode}
   {\errhelp{The configuration for hyphenation is incorrectly
             installed.^^J%
             If you don't understand this error message you need
             to seek^^Jexpert advice.}%
    \errmessage{OOPS! I can't find any hyphenation patterns for
                US english.^^J \space Think of getting some or the
                latex2e setup will never succeed}\@@end}
%</default>
%    \end{macrocode}
% The following example describes the possible contents of a file
% |hyphen.cfg| that will load both US English and German hyphenation
% patterns, making the former the default. 
% It sets |\language| to $0$ for the US patterns and to $1$ for the
% German patterns.
% Then |\language| is set to $0$ to make this the default and the
% default values of |\lefthyphenmin| and |\righthyphenmin| are set.
% \begin{verbatim}
%\language=0
%\input hyphen-us
%\language=1
%\input ghyphen3
%\language=0
%\lefthyphenmin=2
%\righthyphenmin=3
%\endinput
%\end{verbatim}
%
% Another possibility is to use the package |babel|, by Johannes Braams.
% In that case, the file |babel.hyphen| can be used as |hyphen.cfg|;
% by renaming it or (if your operating system supports such an
% operation) by creating a (symbolic) link.
%
%
% \Finale
%
\endinput
