diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/l3kernel/l3oldmodules.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/l3kernel/l3oldmodules.dtx | 162 |
1 files changed, 162 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/l3kernel/l3oldmodules.dtx b/Master/texmf-dist/source/latex/l3kernel/l3oldmodules.dtx new file mode 100644 index 00000000000..4d884f8381d --- /dev/null +++ b/Master/texmf-dist/source/latex/l3kernel/l3oldmodules.dtx @@ -0,0 +1,162 @@ +% \iffalse meta-comment +% +%% File: l3oldmodules.dtx Copyright (C) 2014 The LaTeX3 Project +%% +%% It may be distributed and/or modified under the conditions of the +%% LaTeX Project Public License (LPPL), either version 1.3c of this +%% license or (at your option) any later version. The latest version +%% of this license is in the file +%% +%% http://www.latex-project.org/lppl.txt +%% +%% This file is part of the "l3kernel bundle" (The Work in LPPL) +%% and all files in that bundle must be distributed together. +%% +%% The released version of this bundle is available from CTAN. +%% +%% ----------------------------------------------------------------------- +%% +%% The development version of the bundle can be found at +%% +%% http://www.latex-project.org/svnroot/experimental/trunk/ +%% +%% for those people who are interested. +%% +%%%%%%%%%%% +%% NOTE: %% +%%%%%%%%%%% +%% +%% Snapshots taken from the repository represent work in progress and may +%% not work or may contain conflicting material! We therefore ask +%% people _not_ to put them into distributions, archives, etc. without +%% prior consultation with the LaTeX3 Project. +%% +%% ----------------------------------------------------------------------- +% +%<*driver|oldmodules> +\def\ExplFileDate{2014/09/06} +%</driver|oldmodules> +%<*driver> +\documentclass[full]{l3doc} +\begin{document} + \DocInput{\jobname.dtx} +\end{document} +%</driver> +% \fi +% +% \title{Obsolete individual modules} +% +% \author{^^A +% The \LaTeX3 Project\thanks +% {^^A +% E-mail: +% \href{mailto:latex-team@latex-project.org} +% {latex-team@latex-project.org}^^A +% }^^A +% } +% +% +% \date{Released \ExplFileDate} + +% \maketitle +% +% \section{Introduction} +% +% \begin{documentation} +% The source code for \texttt{expl3} is organized by modules, e.g., +% integer processing is found in \texttt{l3int.dtx}, etc. Initially +% each such module was used to generate a corresponding +% \texttt{.sty} that was then loaded as part of the \texttt{expl3} +% package. +% +% It was however also possible to load only individual modules (they +% would then load other modules as necessary. This scheme was done +% to ease testing and updates during the time the kernel code saw a +% lot of update. +% +% However, keeping dependencies between modules current became a +% complex task and in fact most modules would require most other +% modules so that in the end everything or nearly everything was +% loaded anyway. +% +% We therefore decided to stop providing individual module packages +% but instead generate all code into a single file that is then +% loaded as part of the \texttt{expl3} package. This decision was +% announced a while back and with the recent \texttt{expl3} +% distributions it because a reality. +% +% To help user that do have code or documents referencing the old +% module packages, we provide (for the time being) skeleton packages +% that generate an error message and then load the \texttt{expl3} so +% that the user can continue. +% Eventually these packages will get fully removed. +% \end{documentation} +% +% \section{Implementation} +% +% \begin{implementation} +% +% First store the current package name in a macro for later use. +% \begin{macrocode} +%<*oldmodules> +\def\old@liii@module@name +%<l3basics>{l3basics} +%<l3bootstrap>{l3bootstrap} +%<l3box>{l3box} +%<l3candidates>{l3candidates} +%<l3clist>{l3clist} +%<l3coffins>{l3coffins} +%<l3color>{l3color} +%<l3expan>{l3expan} +%<l3file>{l3file} +%<l3fp>{l3fp} +%<l3int>{l3int} +%<l3keys>{l3keys} +%<l3msg>{l3msg} +%<l3names>{l3names} +%<l3prg>{l3prg} +%<l3prop>{l3prop} +%<l3quark>{l3quark} +%<l3seq>{l3seq} +%<l3skip>{l3skip} +%<l3tl>{l3tl} +%<l3token>{l3token} +% \end{macrocode} +% +% Then identify the current package: +% \begin{macrocode} +\ProvidesPackage\old@liii@module@name + [% + \ExplFileDate\space v-no-info + Obsolete L3 package + ] +% \end{macrocode} +% Describe the current situation on the terminal, then generate an +% error to ensure that the message is actually seen. +% \begin{macrocode} +\typeout{*****************************************************************} +\typeout{** } +\typeout{** Package \old@liii@module@name\space is obsolete and has been removed!} +\typeout{** } +\typeout{** Its functionality is now only provided as part of in the expl3 package} +\typeout{** } +\typeout{** After showing you an error message you can hit <return> we will continue} +\typeout{** for now by loading expl3 for you. However, at some point in the future} +\typeout{** the old packages will be removed.} +\typeout{** } +\typeout{** Therefore, please replace '\string\usepackage{\old@liii@module@name}'} +\typeout{** with '\string\usepackage{expl3}' in your documents as soon as possible.} +\typeout{** } +\typeout{*******************************************************************} +\PackageError\old@liii@module@name{This package is obsolete --- + use 'expl3' instead}\@ehc +% \end{macrocode} +% Finally load \texttt{expl3} so that the user can continue for now. +% \begin{macrocode} +\RequirePackage{expl3} +%</oldmodules> +% \end{macrocode} +% +% \end{implementation} +% +% \endinput |