% \iffalse
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\ProvidesPackage{xt_capts}
%<package> [1998/02/25 v1.1d eXTended CAPTionS (OFR)]
%
%<*driver>
\documentclass{ltxdoc}
\usepackage{xt_capts}
\GetFileInfo{xt_capts.sty}
%% Define some captions for later use inside the documentation:
\DeclareCaption{\teapot}{english}{\textbf{teapot}}
\DeclareCaption{\teapot}{german}{\textbf{Teekanne}}
\DeclareCaption{\teacup}{english}[1][\empty]{\textbf{cup#1 of tea}}
\DeclareCaption{\hotscones}{english}[1][h]{\textbf{#1ot scones}}
\begin{document}
\title{The |xt\_capts| package\thanks{This file has version number
\fileversion, last revised \filedate.}}
\author{Olaf Fricke\\ofricke@cs.tu-berlin.de}
\date{\filedate}
\maketitle
\DocInput{xt_capts.dtx}
\end{document}
%</driver>
% \fi
%
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \CheckSum{249}
%
% \changes{v1.00}{1997/12/23}{Initial version}
% \changes{v1.01}{1998/01/05}{Documentation extended}
% \changes{v1.10}{1998/01/07}{Language switching mechanism modified}
% \changes{v1.11}{1998/02/04}{Warning message modified}
% \changes{v1.1c}{1998/02/23}{Implementation of |\UseCaption| changed}
% \changes{v1.1d}{1998/02/25}{Documentation revised}
%
%
% \begin{abstract}
% This package allows to define language dependent text macros. They are
% called \emph{extended captions}, because \emph{caption} is the term that is
% used in \LaTeX2e for denoting language dependent words.
%
% Whenever a new language is selected, the appropriate macros are used,
% provided they have been defined. In addition, a default variant can be
% defined for \emph{all} languages. And it is possible to use a fixed
% language for a caption, which is not affected by changing the current
% language.
% \end{abstract}
%
%
% \section{Introduction}
% When doing some cooperative work within a team, it is often recommended to
% define some handy text commands, which everybody should use. In addition, it
% is sometimes necessary to use these commands in different languages. The
% command names should not change, but the represented text may vary from one
% language to the other. Similar ideas are used within a multilingual
% \LaTeX2e, an examples is |\figurename|, which gives ``\figurename'' in
% English and ``Abbildung'' in German. These commands are called
% \emph{captions}, that is why this package is called |xt_capts|, an
% abbreviation for \emph{extended captions}.
%
% This package implements some commands, which can be used to define new
% language-specific captions. Most ideas (and even much of the
% documentation) were adapted from the \LaTeX2e font encoding scheme, namely
% out of the |fontenc| package and its documentation file |ltoutenc.dtx|.
% Therefore it may not be very surprisingly, that the implementation is based on
% the two commands |\DeclareTextCommand| and |\ProvideTextCommand|.
%
% \subsection{Declaring captions}
% The syntax for declaring language-specific commands is as follows:
% \begin{quote}
% |\DeclareCaption{|^^A
% \meta{caption}|}{|^^A
% \meta{language}|}|\\\hspace*{\fill}|[|^^A
% \meta{number}|][|^^A
% \meta{default}|]{|^^A
% \meta{commands}|}|
%
% |\ProvideCaption{|^^A
% \meta{caption}|}{|^^A
% \meta{language}|}|\\\hspace*{\fill}|[|^^A
% \meta{number}|][|^^A
% \meta{default}|]{|^^A
% \meta{commands}|}|
% \end{quote}
%
% The first command acts like |\newcommand|, except that it defines a command
% which is specific to the given language, meaning it defines a new caption.
% The command accepts the same optional arguments as |\newcommand|, which
% allows somebody to define a caption with arguments. The resulting
% command is always robust, even if its definition is fragile.
%
% The second command does nearly the same, except that nothing is done if
% the command is already defined for the given language. Additionally, the
% latter command is allowed inside the document, too, whereas the former
% one may be used only inside the preamble.
%
% For example, to define the caption |\teapot| for English and German, the
% following code can be used:
% \begin{verbatim}
% \DeclareCaption{\teapot}{english}{\textbf{teapot}}
% \DeclareCaption{\teapot}{german}{\textbf{Teekanne}}
% \end{verbatim}
%
% \subsection{Using captions}
% The defined captions can be used in two ways. Normally they are used by just
% calling the command after the appropriate language has been
% selected. However, sometimes it may be necessary to use a command in a
% language that is not selected (or even not installed). Therefore the
% |\UseCaption| command can be called:
%
% \begin{quote}
% |\UseCaption{|^^A
% \meta{language}|}{|^^A
% \meta{caption}|}|
% \end{quote}
% For example, |\UseCaption{german}{\teapot}| has the same effect as:
% \begin{verbatim}
% {\selectlanguage{german}\teapot}
% \end{verbatim}
% The first variant has the advantage, that it is much faster than changing
% the whole language with the |\selectlanguage| mechanism and that it can be
% used even if no language package is used at all.
%
% After defining the above captions, |\teapot| gives either \teapot\ or
% \UseCaption{german}\teapot, depending on the currently selected
% language.
%
% Some more flexibility can be reached, if arguments are used in the
% declarations. Two examples are given in the following. The first one allows
% to use the caption in singular or in plural form, whereas the second example
% provides the possibility to change the leading letter.
% \begin{verbatim}
% \DeclareCaption{\teacup}{english}[1][\empty]{\textbf{cup#1 of tea}}
% \DeclareCaption{\hotscones}{english}[1][h]{\textbf{#1ot scones}}
% \end{verbatim}
% The use of |\teacup| leads to a \teacup, whereas |\teacup[s]| gives some
% \teacup[s]. \hotscones[H]\ are ordered with |\hotscones|[H], whereas
% \hotscones\ are created with |\hotscones|.
%
% Note that you can also use parameterized captions in conjunction with the
% |\UseCaption| command. This means, that if |\teacup| is defined for German
% like
% \ProvideCaption{\teacup}{german}[1][\empty]{\textbf{Teetasse#1}}
% \begin{verbatim}
% \ProvideCaption{\teacup}{german}[1][\empty]{\textbf{Teetasse#1}}
% \end{verbatim}
% you can say |\UseCaption{german}\teacup[n]| to typeset
% \UseCaption{german}\teacup[n]. Please note that it is not necessary to put
% the caption command into braces.
%
% \subsection{Default captions}
% You can also declare a default definition for a caption command, which will
% be used if the current language has no appropriate definition. Such use will
% also set the definition for this command in the current language to equal
% this default definition; this makes subsequent uses of the command much
% faster.
% \begin{quote}
% |\DeclareCaptionDefault{|^^A
% \meta{caption}|}{|^^A
% \meta{definition}|}|
% \end{quote}
% There is a matching |\Provide| command which will not override an existing
% default definition:
% \begin{quote}
% |\ProvideCaptionDefault{|^^A
% \meta{caption}|}{|^^A
% \meta{definition}|}|
% \end{quote}
%
% \subsection{Language switching}
% The package uses the |\selectlanguage| mechanism to recognize a switching of
% the current language and to set its internal language definition, just like
% the |babel| package (and various other packages) does to redefine existing
% captions like |\chaptername|.
%
% Some facts have to be known by the implementation concerning the language
% selection mechanism:
% \begin{enumerate}
% \item When using language packages like |babel| or |german|, you can switch
% to another (installed) language |XXX| with the |\selectlanguage{XXX}|
% command.
% During its execution, three language dependent macros are evaluated,
% namely: |\dateXXX|, |\captionsXXX|, and |\extrasXXX|. The second macro is
% used by our |xt_capts| package to realize new language dependent captions.
% \item If no language is installed at all, the |\selectlanguage| command may
% be defined nevertheless, since it is possibly included into the format
% file. But luckily the |\languagename| macro is undefined, such that a test
% can be performed.
% \item There are some difficulties in installing and initializing the new
% captions, since the package should work with \emph{all} language packages,
% which uses the the macros |\selectlanguage| and |\captionsXXX|. An example
% is the |babel| system. In the current release v3.6h, the |\selectlanguage|
% command is deferred until the begin of the document. In other package like
% the |german| package (release v2.5d), the |\selectlanguage| command is
% called immediately. But the sequence in which the different packages are
% used should be of no interest. Therefore we must take care of the ordering
% of deferred commands.
% \end{enumerate}
%
% \StopEventually{}
% \section{The Macros}
% First of all, some useful commands are defined. They are used to affect
% the execution ordering of commands which have been deferred until the begin
% or the end of the document. After this prelude, the declaration and the
% implementation of captions is handled as well as the using a fixed language
% for a caption. It follows the code used for initialization and installation
% of a new caption language. The last section describes how the default
% language is set.
%
% \subsection{Some useful commands}
%
% \begin{macrocode}
%<*package>
% \end{macrocode}
%
% \begin{macro}{\g@prependto@macro}
% In correspondence to the command |\g@addto@macro|, a new command with the
% name |\g@prepend@macro| is defined. As you may guess, this command is used to
% prepend something to an already defined macro. The |\g@addto@macro| is
% defined in |ltclass.dtx| as follows:
% \begin{quote}\begin{verbatim}
% \long\def\g@addto@macro#1#2{%
% \begingroup
% \toks@\expandafter{#1#2}%
% \xdef#1{\the\toks@}%
% \endgroup}
% \end{verbatim}\end{quote}
%
% Since it has to be possible to prepend more than a single command, it is not
% sufficient to simply exchange the two parameters when setting the token.
% Instead, the second parameter has to be bound to a temporary macro. Otherwise
% we would fail to jump over the second parameter to expand the macro itself.
% The |\expandafter| command would step into the code that is to be prepended.
% In the mentioned command |\g@addto@macro| this detour is not necessary,
% because there it is not necessary to jump over the second parameter.
%
% The extension of a macro is done similarly to the one used in
% |\g@addto@macro|: the new contents of
% the macro is put into |\toks@| (after expanding both parameters) and than
% the command mentioned in the first parameter is defined with the help of the
% token register. To expand both parameters, the |\expandafter| command is
% used. Note that the old contents of the macro is expanded first.
% \begin{macrocode}
\long\def\g@prependto@macro#1#2{%
\begingroup \def\reserved@a{#2}%
\toks@\expandafter\expandafter\expandafter{%
\expandafter\reserved@a#1}%
\xdef#1{\the\toks@}%
\endgroup}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\BeforeAtBeginDocument}
% \begin{macro}{\AfterAtBeginDocument}
%
% The recently defined command is used in the following definitions. Similar
% to the command |\AtBeginDocument|, the new command |\BeforeAtBeginDocument|
% can be used to execute something at the beginning of a document. But in
% contrast to the former command, the code will be \emph{prepended} to
% |\@begindocumenthook|. This will allow package writers to define some code
% which is executed \emph{before} the deferred code of all other packages is
% executed.
%
% It may be useful to execute some code \emph{after} all packages have done
% their initializations at the beginning of the document. Looking deeply into
% the |\document| macro shows that the do-list |\@preamblecmds| can be misused
% for this purpose. The list consists of |\do|-commands,
% each followed by the command to be disabled. It is evaluated after the
% |\@begindocumenthook| has
% been executed. Its original purpose is to disable commands from execution
% after the document has been started. But it is possible to (mis)use this
% list as hook as well.
%
% Note that both commands may be used only in the preamble.
%
% \begin{macrocode}
\def\BeforeAtBeginDocument{\g@prependto@macro\@begindocumenthook}
\def\AfterAtBeginDocument#1{\g@prependto@macro\@preamblecmds{#1}}
\@onlypreamble\BeforeAtBeginDocument
\@onlypreamble\AfterAtBeginDocument
% \end{macrocode}
% \end{macro}
% \end{macro}
%
% \begin{macro}{\BeforeAtEndDocument}
% Perhaps somebody wants to extend |\@enddocumenthook| at its head,
% too. This can be done by prepending some code to that hook.
% Unfortunately, there is no simple way to implement the analogous
% |\AfterAtEndDocument| command.
%
% \begin{macrocode}
\def\BeforeAtEndDocument#1{\g@prependto@macro\@enddocumenthook{#1}}
% \end{macrocode}
% \end{macro}
% \subsection{Declaring language dependent captions and their defaults}
% This section describes the implementation of the essential commands belonging
% to this package. They all serve the purpose to define and use language
% dependent captions. The name space |\xtc@| is used for internal macros.
%
% \begin{macro}{\DeclareCaption}
% \begin{macro}{\ProvideCaption}
%
% The implementation is based on |\DeclareTextCommand|, a \LaTeX2e kernel
% command, which is used for declaring encoding-specific commands. Some tricky
% declarations make sure that the same command can be used for
% language-specific commands, too.
%
% The |\xtc@init| command is called to fulfill the initialization stuff.
% Note that |\DeclareCaption| can only be used in the
% preamble, but that the |\Provide| version is allowed anywhere.
% \begin{macrocode}
\newcommand{\DeclareCaption}[2]{%
\xtc@init{#2}%
\DeclareTextCommand#1{#2}}
% \end{macrocode}
%
% \begin{macrocode}
\newcommand{\ProvideCaption}[2]{%
\xtc@init{#2}%
\ProvideTextCommand#1{#2}}
% \end{macrocode}
%
% \begin{macrocode}
\@onlypreamble\DeclareCaption
%\@onlypreamble\ProvideCaption
% \end{macrocode}
% \end{macro}
% \end{macro}
%
%
% \begin{macro}{\DeclareCaptionDefault}
% \begin{macro}{\ProvideCaptionDefault}
% These macros define commands with our default language |lang?|.
% Note that |\DeclareCaptionDefault| can only be used in the
% preamble, but that the |\Provide| version is allowed anywhere.
% \begin{macrocode}
\newcommand{\DeclareCaptionDefault}[1]{%
\DeclareTextCommand#1{lang?}}
% \end{macrocode}
%
% \begin{macrocode}
\newcommand{\ProvideCaptionDefault}[1]{%
\ProvideTextCommand#1{lang?}}
% \end{macrocode}
%
% \begin{macrocode}
\@onlypreamble\DeclareCaptionDefault
%\@onlypreamble\ProvideCaptionDefault
% \end{macrocode}
% These macros require |\lang?-cmd| to be initialized as
% |\xtc@changed@lang|.
% \begin{macrocode}
\expandafter\let\csname lang?-cmd\endcsname\xtc@changed@lang
% \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsection{Implementation of the language mechanism}
% When executing |\DeclareCaption{\foo}{XXX}...|, the standard kernel command
% |\DeclareTextCommand| is called with exactly the same arguments. During that
% call, |\foo| is defined to be |\XXX-cmd \foo \XXX\foo|, where |\XXX\foo| is
% \emph{\bfseries one} control sequence, not two. In addition, |\newcommand| is
% called to define |\XXX\foo| accordingly to what follows in the dots.
%
% The documentation of |ltoutenc.dtx| states that all the tricky work is done
% when executing |\XXX-cmd \foo \XXX\foo|. That's fairly true. Since we are
% juggling with language switching and with protected commands, we must respect
% the current values of |\protect| and the actual language. Unfortunately, the
% macro |\languagename| is not always defined. Therefore we define
% |\xtc@lang| to contain the current language name for the captions and take an
% approach similar to the font encoding scheme. The approach is as follows:
% \begin{itemize}
% \item If |\protect| is not |\@typeset@protect|, then we execute
% |\noexpand\foo|. This make |\foo| robust, so that it will survive all
% things which may happen to it, even if it is written to a file or something
% else.
% \item If |\protect| is |\@typeset@protect| and |\xtc@lang| is |XXX|, then
% |\XXX\foo| is executed. Like in the font encoding scheme, this is the
% normal behavior, and it is optimized for speed.
% \item If |\protect| is |\@typeset@protect|, |\xtc@lang| is (say) |YYY|,
% and |\YYY\foo| is defined, then we execute |\YYY\foo|.
% \item If |\protect| is |\@typeset@protect|, |\xtc@lang| is (say) |YYY|,
% and |\YYY\foo| is undefined, then we define |\YYY\foo| to be equal to the
% default value of |\foo|, and execute |\YYY\foo|.
% \item In all cases, if |\protect| is |\@typeset@protect| and we are in math
% mode, then an additional warning is issued.
% \end{itemize}
%
% So after all that, we will either execute the appropriate
% definition of |\foo| for the current language, or we will execute
% |\noexpand\foo|.
%
% The default value of |\foo| is |\lang?\foo| if it is defined, and an
% error message otherwise.
%
%
%
% \begin{macro}{\xtc@use@lang}
% \begin{macro}{\xtc@lang}
%
% If the language is changed from |XXX| to |YYY|, |\XXX-cmd| is
% defined to be an alias to |\xtc@changed@lang|, whereas |\YYY-cmd| is defined
% to be an alias to
% |\xtc@current@lang|. This means that the test for what the current
% language is can be performed quickly. More precisely, there is no need to
% make any test at all, because the right command is called on the fly. The
% language change is done by calling |\xtc@use@lang|.
%
% \begin{macrocode}
\def\xtc@use@lang#1{%
\expandafter\let\csname\xtc@lang -cmd\endcsname\xtc@changed@lang
\edef\xtc@lang{#1}%
\expandafter\let\csname\xtc@lang -cmd\endcsname\xtc@current@lang}
% \end{macrocode}
%
% In addition, the macro |\xtc@lang| (denoting the current language) is
% initialized to be |lang?|. This has to be done, because otherwise the macro
% would be undefined if the first language is selected.
% \begin{macrocode}
\def\xtc@lang{lang?}
% \end{macrocode}
% \end{macro}
% \end{macro}
%
%
% \begin{macro}{\xtc@current@lang}
% \begin{macro}{\xtc@changed@lang}
% \begin{macro}{\xtc@unavailable}
%
% The next macro treats the case that a caption uses the current language. It
% simply tests if we are in protected modus. If not, the math warning is raised
% optionally, just before the next command will be executed. Remember that this
% command is the |\XXX\foo| one. If we are in protected modus, we do a
% |\noexpand\foo| and remove the next command by means of the |\@gobble|
% command.
%
% \begin{macrocode}
\def\xtc@current@lang#1{%
\ifx\protect\@typeset@protect
\@inmathwarn#1%
\else
\noexpand#1\expandafter\@gobble
\fi}
% \end{macrocode}
%
% Things differ a bit, if the language has changed. First of all, we remove the
% |\XXX\foo| and save it in the second parameter. Note that we do not use it
% any more. The test if we are in protected modus is the same, the actions
% differ. Since we have already removed the next command, we simply do our
% |\noexpand\foo| in case of protection. Otherwise we possibly raise our math
% warning, before processing the command.
%
% We have to take care of undefined
% commands. If the desired is undefined for the current language, it is let to
% be an alias to the default command. If the default command is undefined, it
% is defined to give an error message. The last step of our processing is to
% evaluate the desired command.
%
% \begin{macrocode}
\def\xtc@changed@lang#1#2{%
\ifx\protect\@typeset@protect
\@inmathwarn#1%
\expandafter\ifx\csname\xtc@lang\string#1\endcsname\relax
\expandafter\ifx\csname lang?\string#1\endcsname\relax
\expandafter\def\csname lang?\string#1\endcsname{%
\xtc@unavailable#1%
}%
\fi
\global\expandafter\let
\csname\xtc@lang \string#1\expandafter\endcsname
\csname lang?\string#1\endcsname
\fi
\csname\xtc@lang\string#1%
\expandafter\endcsname
\else
\noexpand#1%
\fi}
% \end{macrocode}
%
% Now we define the error message |\xtc@unavailable|. Note that the
% mentioned warning |\@inmathwarn| is used out of the font encoding code as
% it is.
% \begin{macrocode}
\gdef\xtc@unavailable#1{%
\@latex@error{%
Command \protect#1 unavailable in language \xtc@lang%
}\@eha}
% \end{macrocode}
% \end{macro}
% \end{macro}
% \end{macro}
%
% \subsection{A command for using a fixed language}
%
% \begin{macro}{\UseCaption}
% The |\UseCaption| command can be used even for captions which have
% parameters. It is important to make the command robust, since it can be use
% inside a |\section| command to prevent a heading from being typeset in the
% wrong language.
%
% Our first implementation approach set the desired language before evaluating
% the caption. It finished with restoring the language to its old value. The
% coding was straight forward:
%
% \begin{quote}\begin{verbatim}
% \declare@robustcommand{\UseCaption}[2]{%
% \let\xtc@saved@lang\xtc@lang
% \xtc@use@lang{#1}%
% #2%
% \xtc@use@lang\xtc@saved@lang}
% \end{verbatim}\end{quote}
%
% Unfortunately, this was not the very best solution, because an appended
% |\xspace| was misleaded. Therefore the implementation was changed. Now
% nothing will follow the expanded caption.
%
% The implementation takes an approach very
% similar to the |\xtc@changed@lang| command. Since the |\UseCaption| command is
% defined to be robust, we need not to check the value of |\protect|. Instead, we
% only check if the desired language command is defined or not. If not, we
% have a look at the default command. If the latter is not defined as well, it
% is defined to give our error. Now we have the default command available and
% let the desired command be an alias to the default command. Finally, we
% evaluate the desired command.
%
% \begin{macrocode}
\declare@robustcommand\UseCaption[2]{%
\@inmathwarn#2%
\expandafter\ifx\csname #1\string#2\endcsname\relax
\expandafter\ifx\csname lang?\string#2\endcsname\relax
\expandafter\def\csname lang?\string#2\endcsname{%
\xtc@unavailable#2%
}%
\fi
\global\expandafter\let
\csname #1\string#2\expandafter\endcsname
\csname lang?\string#2\endcsname
\fi
\csname #1\string#2\endcsname
}
% \end{macrocode}
% \end{macro}
%
% \subsection{Initialization and installation stuff}
%
% \begin{macro}{\xtc@init}
% \begin{macro}{\xtc@install}
%
% Each time a caption is declared or provided, the command |\xtc@init|
% is called with the desired language as parameter, say |XXX|. The purpose of
% this call is to initialize a new language if called the first time with
% |XXX| and to do nothing otherwise.
%
% Therefore the command |\xtc@XXX| is tested. If this command is
% undefined, the initialization happens, otherwise the call returns.
% When performing the test, it must be taken into account, that |\csname|
% lets an undefined command to |\relax|. If undefined, it is defined to set the
% new language. In addition, the |\XXX-cmd| is let to |\xtc@changed@lang| and the
% new |\xtc@XXX| is installed.
%
% Since the initialization command may be called by |\ProvideCaption| after
% the document
% has started, it is tested, if |\@begindocumenthook| is defined. If not, we are
% inside the document and can install |\xtc@XXX| immediately. If
% defined, we are still in the preamble and have to defer the installation
% until the beginning of the document.
%
% The deferring has to be done because the command |\xtc@XXX| is to be
% appended to
% the command |\captionsXXX|. And the latter command may be undefined by now,
% because the use of packages like |babel| or |german| may happen later
% than the use of our package |xt_caps|.
%
% \begin{macrocode}
\newcommand{\xtc@init}[1]{%
\expandafter\ifx\csname xtc@#1\endcsname\relax
\expandafter\def\csname xtc@#1\endcsname{%
\xtc@use@lang{#1}}%
\expandafter\let\csname #1-cmd\endcsname\xtc@changed@lang
\ifx\@begindocumenthook\@undefined
\xtc@install{#1}%
\else
\AtBeginDocument{\xtc@install{#1}}%
\fi
\fi}
% \end{macrocode}
%
% The following macro will be called at the beginning of the document. Its
% purpose is to install the extended caption mechanism for a given language
% |XXX|. First of all, it is tested if there exists any support for the
% language. This is done by looking at the existence of the command
% |\captionsXXX|. If no support is given, a warning is raised. Otherwise we
% append our |\xtc@XXX| command to |\captionsXXX|. Some care must be taken,
% because the |\csname| command lets an unknown command to be |\relax|. We use
% a group to restore the command to its previous value.
%
% \begin{macrocode}
\newcommand{\xtc@install}[1]{%
\begingroup\expandafter\endgroup
\expandafter\ifx\csname captions#1\endcsname\@undefined
\PackageWarningNoLine{xt_capts}{%
You haven't defined the language #1\space yet.\MessageBreak
Nevertheless, \string\UseCaption{#1}{\string\foo} will work}
\else
\expandafter\g@addto@macro\csname captions#1\expandafter\endcsname
\csname xtc@#1\endcsname
\fi}
% \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsection{Default language}
% To set the default language for the captions, we must check if different
% languages are supported. If support is given, the current language is used
% for the captions as well. If not, |english| is used. The code for doing this
% selection is deferred until all other packages have executed their deferred
% code. This is necessary, because language package may execute
% |\selectlanguage| at the beginning of the document, too. It is important for
% the caption implementation, that the default language of the captions is
% defined after the actual language has been selected. Unfortunately, the
% |\selectlanguage| command for a given language may be executed \emph{before}
% |\xtc@XXX| has been installed or even before our package is loaded. One
% candidate for this behavior is the |german| package, which does not defer
% its |\selectlanguage| call. Therefore, we put our piece of code somewhere
% \emph{after} the |\@begindocumenthook|.
%
% \begin{macrocode}
\AfterAtBeginDocument{%
\ifx\languagename\@undefined
\xtc@use@lang{english}%
\else
\xtc@use@lang\languagename
\fi}
% \end{macrocode}
%
% To prevent the default language |english| from producing an undesired warning
% message, another piece of code it put into the
% |\@begindocumenthook|. This piece lets |\captionsenglish| to be an empty
% macro, if it is undefined and no language package is used at all. Because we
% want to be sure that this code is executed \emph{before} any caption
% language is installed, we put our piece of code at the head of the hook.
%
% \begin{macrocode}
\BeforeAtBeginDocument{%
\ifx\languagename\@undefined
\ifx\captionsenglish\@undefined
\let\captionsenglish\@empty
\fi
\fi}
% \end{macrocode}
%
% \begin{macrocode}
%</package>
% \end{macrocode}
%
%
% \Finale
\endinput