diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/alphalph.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/oberdiek/alphalph.dtx | 165 |
1 files changed, 108 insertions, 57 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/alphalph.dtx b/Master/texmf-dist/source/latex/oberdiek/alphalph.dtx index 587dc417e1b..27718341b62 100644 --- a/Master/texmf-dist/source/latex/oberdiek/alphalph.dtx +++ b/Master/texmf-dist/source/latex/oberdiek/alphalph.dtx @@ -1,11 +1,12 @@ % \iffalse meta-comment -% +% % File: alphalph.dtx -% Version: 2010/04/18 v2.3 -% -% Copyright (C) 1999, 2006-2008, 2010 by +% Version: 2011/05/13 v2.4 +% Info: Convert numbers to letters +% +% Copyright (C) 1999, 2006-2008, 2010, 2011 by % Heiko Oberdiek <heiko.oberdiek at googlemail.com> -% +% % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either % version 1.3c of this license or (at your option) any later @@ -15,23 +16,23 @@ % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of % LaTeX version 2005/12/01 or later. -% +% % This work has the LPPL maintenance status "maintained". -% +% % This Current Maintainer of this work is Heiko Oberdiek. -% +% % The Base Interpreter refers to any `TeX-Format', % because some files are installed in TDS:tex/generic//. -% +% % This work consists of the main source file alphalph.dtx % and the derived files % alphalph.sty, alphalph.pdf, alphalph.ins, alphalph.drv, % alphalph-test1.tex, alphalph-test2.tex, alphalph-test3.tex. -% +% % Distribution: % CTAN:macros/latex/contrib/oberdiek/alphalph.dtx % CTAN:macros/latex/contrib/oberdiek/alphalph.pdf -% +% % Unpacking: % (a) If alphalph.ins is present: % tex alphalph.ins @@ -40,7 +41,7 @@ % (c) If you insist on using LaTeX % latex \let\install=y\input{alphalph.dtx} % (quote the arguments according to the demands of your shell) -% +% % Documentation: % (a) If alphalph.drv is present: % latex alphalph.drv @@ -50,14 +51,14 @@ % if available. Here you can specify further options, e.g. % use A4 as paper format: % \PassOptionsToClass{a4paper}{article} -% +% % Programm calls to get the documentation (example): % pdflatex alphalph.dtx % makeindex -s gind.ist alphalph.idx % pdflatex alphalph.dtx % makeindex -s gind.ist alphalph.idx % pdflatex alphalph.dtx -% +% % Installation: % TDS:tex/generic/oberdiek/alphalph.sty % TDS:doc/latex/oberdiek/alphalph.pdf @@ -81,7 +82,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: alphalph 2010/04/18 v2.3 Converting numbers to letters (HO)} +\Msg{* Package: alphalph 2011/05/13 v2.4 Convert numbers to letters (HO)} \Msg{************************************************************************} \keepsilent @@ -93,9 +94,9 @@ This is a generated file. Project: alphalph -Version: 2010/04/18 v2.3 +Version: 2011/05/13 v2.4 -Copyright (C) 1999, 2006-2008, 2010 by +Copyright (C) 1999, 2006-2008, 2010, 2011 by Heiko Oberdiek <heiko.oberdiek at googlemail.com> This work may be distributed and/or modified under the @@ -132,6 +133,10 @@ and the derived files \file{alphalph-test1.tex}{\from{alphalph.dtx}{test1}}% \file{alphalph-test2.tex}{\from{alphalph.dtx}{test2,etex}}% \file{alphalph-test3.tex}{\from{alphalph.dtx}{test2,noetex}}% + \nopreamble + \nopostamble + \usedir{source/latex/oberdiek/catalogue}% + \file{alphalph.xml}{\from{alphalph.dtx}{catalogue}}% } \catcode32=13\relax% active space @@ -158,10 +163,9 @@ and the derived files %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{alphalph.drv}% - [2010/04/18 v2.3 Converting numbers to letters (HO)]% + [2011/05/13 v2.4 Convert numbers to letters (HO)]% \documentclass{ltxdoc} -\usepackage{holtxdoc}[2011/02/04] -\usepackage{alphalph}[2010/04/18] +\usepackage{alphalph}[2011/05/13] \makeatletter \newalphalph{\fnsymbolwrap}[wrap]{\@fnsymbol}{} \newcommand*{\fnsymbolsingle}[1]{% @@ -187,13 +191,14 @@ and the derived files \mathrel{\mathop{:}}=% }% } +\usepackage{holtxdoc}[2011/11/22] \begin{document} \DocInput{alphalph.dtx}% \end{document} %</driver> % \fi % -% \CheckSum{1213} +% \CheckSum{1218} % % \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 @@ -214,14 +219,14 @@ and the derived files % \GetFileInfo{alphalph.drv} % % \title{The \xpackage{alphalph} package} -% \date{2010/04/18 v2.3} +% \date{2011/05/13 v2.4} % \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}} % % \maketitle % % \begin{abstract} % The package provides methods to represent numbers with a limited -% set of symbols. Both \LaTeX\ and \plainTeX are supported. +% set of symbols. Both \hologo{LaTeX} and \hologo{plainTeX} are supported. % \end{abstract} % % \tableofcontents @@ -229,7 +234,7 @@ and the derived files % \section{Documentation} % % \subsection{Introduction} -% \LaTeX\ counter can be represented in different ways +% \hologo{LaTeX} counters can be represented in different ways % by using presentation commands: % \begin{quote} % \cs{arabic}, \cs{roman}, \cs{Roman},\\ @@ -237,7 +242,7 @@ and the derived files % \end{quote} % The ranges of supported counter values are more or less % restricted. Only \cs{arabic} can be used with any counter -% value \TeX\ supports. +% value \hologo{TeX} supports. % \begin{quote} % \catcode`\|=12 % % \begin{tabular}{@{}l|l|l|l@{}} @@ -300,7 +305,7 @@ and the derived files % % Nine footnote symbols are quite a few. % Too soon the symbols are consumed -% and \LaTeX\ complains with the error ``Counter too large''. +% and \hologo{LaTeX} complains with the error ``Counter too large''. % However, it could be acceptable to start again with the symbols % from the beginning, especially if there are less than nine symbols % on a page. @@ -329,7 +334,7 @@ and the derived files % % \subsubsection{Multiple symbols} % -% \LaTeX's standard set of footnote symbols contains doubled +% \Hologo{LaTeX}'s standard set of footnote symbols contains doubled % symbols at the higher positions. Could this principle % be generalized? % Yes, but first we need a clean footnote symbol list without @@ -398,17 +403,17 @@ and the derived files % % \begin{description} % \item[Counter presentation command] is a macro that -% expects a \LaTeX\ counter name as argument. +% expects a \hologo{LaTeX} counter name as argument. % Numbers cannot be used. Examples: % \cs{arabic}, \cs{alph}, \cs{fnsymbol}. % \item[Number presentation command] is a macro that % expects a number as argument. A number is anything -% that \TeX\ accepts as number including \cs{value}. +% that \hologo{TeX} accepts as number including \cs{value}. % Examples: \cs{alphalph}, \cs{AlphAlph}, \cs{alphalph@alph} % % However, \cs{alph} or \cs{fnsymbol} are not number % presentation commands because they expect a counter -% name as argument. Happily \LaTeX\ counter presentation +% name as argument. Happily \hologo{LaTeX} counter presentation % commands internally uses number presentation commands % with the same name, but prefixed by `@'. Thus % \cs{@alph}, \cs{@fnsymbol} are number presentation commands. @@ -424,11 +429,11 @@ and the derived files % % \subsection{Package usage} % -% The package \Package{alphalph} can be used with both \plainTeX\ -% and \LaTeX: +% The package \Package{alphalph} can be used with both \hologo{plainTeX} +% and \hologo{LaTeX}: % \begin{description} -% \item[\plainTeX:] |\input alphalph.sty| -% \item[\LaTeXe:] |\usepackage{alphalph}|\\ +% \item[\hologo{plainTeX}:] |\input alphalph.sty| +% \item[\hologo{LaTeX2e}:] |\usepackage{alphalph}|\\ % There aren't any options. % \end{description} % @@ -438,7 +443,7 @@ and the derived files % \cs{alphalph} \M{number} % \end{declcs} % Both macros are number presentation commands that -% expects a number as argument. \LaTeX\ counters +% expects a number as argument. \hologo{LaTeX} counters % are used with \cs{value}. % % The macros represents a number by letters. @@ -490,7 +495,7 @@ and the derived files % % The last argument is the number of symbols. % If the argument is empty, then \cs{newalphalph} tries -% to find this number itself. \LaTeX's number presentation +% to find this number itself. \hologo{LaTeX}'s number presentation % commands throw an error message, if the number is too large. % This error message is put in a macro \cs{@ctrerr}. % Thus \cs{newalphalph} calls the symbol provider and tests @@ -511,7 +516,7 @@ and the derived files % \end{declcs} % They are basically the same as \cs{@Alph} and \cs{@alph}. % Some languages of package \xpackage{babel} redefine -% \LaTeX's macros to include some font setup that +% \hologo{LaTeX}'s macros to include some font setup that % breaks expandibility. Therefore \cs{AlphAlph} and \cs{alphalph} % are based on \cs{alphalph@Alph} and \cs{alphalph@alph} to get % the letters. The behaviour of these symbol providers for numbers @@ -528,22 +533,22 @@ and the derived files % \item They are fully expandable. This means that they can safely % \begin{itemize} % \item be written to a file, -% \item used in moving arguments (\LaTeX: they are \emph{robust}), +% \item used in moving arguments (\hologo{LaTeX}: they are \emph{robust}), % \item used in a \cmd{\csname}-\cmd{\endcsname} pair. % \end{itemize} % \item If the argument is zero or negative, the commands expand % to nothing like \cmd{\romannumeral}. -% \item The argument is a \TeX\ number. Anything that would be +% \item The argument is a \hologo{TeX} number. Anything that would be % accepted by \cmd{\number} is a valid argument: % \begin{itemize} % \item explicite constants, % \item macros that expand to a number, -% \item count registers, \LaTeX\ counter can used +% \item count registers, \hologo{LaTeX} counter can used % via \cmd{\value}, e.\,g.:\\ % |\alphalph{\value{page}}| % \item \dots % \end{itemize} -% \item \eTeX's numeric expressions are supported, if \eTeX\ is +% \item \hologo{eTeX}'s numeric expressions are supported, if \hologo{eTeX} is % available. Then \cs{numexpr} is applied to the argument. % Package \cs{calc}'s expressions are not supported. % That would violate the expandibility. @@ -552,12 +557,12 @@ and the derived files % \subsubsection{General usability} % % \begin{description} -% \item[\TeX\ format:] -% The package does not depend on \LaTeX, it can also be used -% by \plainTeX, for example. -% \item[\eTeX:] \eTeX is supported, the macros are shorter and +% \item[\hologo{TeX} format:] +% The package does not depend on \hologo{LaTeX}, it can also be used +% by \hologo{plainTeX}, for example. +% \item[\hologo{eTeX}:] \eTeX is supported, the macros are shorter and % faster. But \eTeX's extensions are not requirements. -% Without \eTeX, just the implementation changes. The properties +% Without \hologo{eTeX}, just the implementation changes. The properties % remain unchanged. % \end{description} % @@ -640,7 +645,7 @@ and the derived files \fi \expandafter\x\csname ver@alphalph.sty\endcsname \ProvidesPackage{alphalph}% - [2010/04/18 v2.3 Converting numbers to letters (HO)]% + [2011/05/13 v2.4 Convert numbers to letters (HO)]% % \end{macrocode} % % \subsection{Catcodes} @@ -709,7 +714,7 @@ and the derived files \fi % \end{macrocode} % -% \subsection{\eTeX\ detection} +% \subsection{\hologo{eTeX} detection} % % \begin{macrocode} \begingroup\expandafter\expandafter\expandafter\endgroup @@ -766,7 +771,7 @@ and the derived files % \begin{macro}{\@ReturnAfterFi} % The following commands moves the `then' and `else' part respectively % behind the |\if|-construct. This prevents a too deep |\if|-nesting -% and so a \TeX\ capacity error because of a limited input stack size. +% and so a \hologo{TeX} capacity error because of a limited input stack size. % I use this trick in several packages, so I don't prefix these internal % commands in order not to have the same macros with different names. % (It saves memory.) @@ -778,8 +783,8 @@ and the derived files % \end{macro} % % \begin{macro}{\@gobblefour} -% \LaTeX\ defines commands for eating arguments. -% Define \cs{@gobblefour} if it is not defined (\plainTeX). +% \Hologo{LaTeX} defines commands for eating arguments. +% Define \cs{@gobblefour} if it is not defined (\hologo{plainTeX}). % \begin{macrocode} \expandafter\ifx\csname @gobblefour\endcsname\relax \long\def\@gobblefour#1#2#3#4{}% @@ -822,7 +827,7 @@ and the derived files % The output of \cs{alphalph} and \cs{AlphAlph} should be % usable as part of command names (see \cs{@namedef}, \cs{csname}, \dots). % Unhappily some languages of package \xpackage{babel} -% redefine \LaTeX's \cs{@alph} and \cs{@Alph} in a manner that +% redefine \hologo{LaTeX}'s \cs{@alph} and \cs{@Alph} in a manner that % they cannot be used in expandable context any more. % Therefore package \xpackage{alphalph} provides its own % commands. @@ -1418,7 +1423,7 @@ and the derived files } \DisableNumexpr %</noetex> -\usepackage{alphalph}[2010/04/18] +\usepackage{alphalph}[2011/05/13] %<noetex>\RestoreNumexpr \usepackage{qstest} \IncludeTests{*} @@ -1821,6 +1826,45 @@ and the derived files %\end{verbatim} % \end{quote} % +% \section{Catalogue} +% +% The following XML file can be used as source for the +% \href{http://mirror.ctan.org/help/Catalogue/catalogue.html}{\TeX\ Catalogue}. +% The elements \texttt{caption} and \texttt{description} are imported +% from the original XML file from the Catalogue. +% The name of the XML file in the Catalogue is \xfile{alphalph.xml}. +% \begin{macrocode} +%<*catalogue> +<?xml version='1.0' encoding='us-ascii'?> +<!DOCTYPE entry SYSTEM 'catalogue.dtd'> +<entry datestamp='$Date$' modifier='$Author$' id='alphalph'> + <name>alphalph</name> + <caption>Convert numbers to letters.</caption> + <authorref id='auth:oberdiek'/> + <copyright owner='Heiko Oberdiek' year='1999,2006-2008,2010,2011'/> + <license type='lppl1.3'/> + <version number='2.4'/> + <description> + Provides commands <tt>\alphalph</tt> and <tt>\AlphAlph.</tt> They + are like <tt>\number</tt> but the expansion consists of lowercase + and uppercase letters respectively (1 to a, 26 to z, 27 to aa, 52 + to zz, 53 to ba, 702 to zz, 703 to aaa, etc.). Can be used as a + replacement for LaTeX's <tt>\@alph</tt> and <tt>\@Alph</tt> + macros. + <p/> + The package is part of the <xref refid='oberdiek'>oberdiek</xref> + bundle. + </description> + <documentation details='Package documentation' + href='ctan:/macros/latex/contrib/oberdiek/alphalph.pdf'/> + <ctan file='true' path='/macros/latex/contrib/oberdiek/alphalph.dtx'/> + <miktex location='oberdiek'/> + <texlive location='oberdiek'/> + <install path='/macros/latex/contrib/oberdiek/oberdiek.tds.zip'/> +</entry> +%</catalogue> +% \end{macrocode} +% % \begin{History} % \begin{Version}{1999/03/19 v0.1} % \item @@ -1843,7 +1887,7 @@ and the derived files % \item % Documentation added in dtx format. % \item -% \eTeX\ support added. +% \hologo{eTeX} support added. % \end{Version} % \begin{Version}{1999/04/13 v1.1} % \item @@ -1859,7 +1903,7 @@ and the derived files % \end{Version} % \begin{Version}{2006/02/20 v1.3} % \item -% Reload check (for \plainTeX) +% Reload check (for \hologo{plainTeX}) % \item % New DTX framework. % \item @@ -1876,7 +1920,7 @@ and the derived files % \begin{Version}{2007/09/09 v2.0} % \item % New implementation that uses package \cs{intcalc}. -% This removes the dependency on \eTeX. +% This removes the dependency on \hologo{eTeX}. % \item % \cs{newalphalph} is extended to support new methods `wrap' and 'multi'. % \item @@ -1891,12 +1935,19 @@ and the derived files % \end{Version} % \begin{Version}{2010/03/01 v2.2} % \item -% Compatibility with \iniTeX. +% Compatibility with \hologo{iniTeX}. % \end{Version} % \begin{Version}{2010/04/18 v2.3} % \item % Documentation fixes (Martin M\"unch). % \end{Version} +% \begin{Version}{2011/05/13 v2.4} +% \item +% Documentation fixes (Jim Diamond) and using package +% \xpackage{hologo} for the documentation. +% \item +% Catalogue file added. +% \end{Version} % \end{History} % % \PrintIndex |