% \iffalse meta-comment % % Copyright (C) 2009, 2010 by % Heiko Oberdiek % % 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 % version. This version of this license is in % http://www.latex-project.org/lppl/lppl-1-3c.txt % and the latest version of this license is in % 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 ltxcmds.dtx % and the derived files % ltxcmds.sty, ltxcmds.pdf, ltxcmds.ins, ltxcmds.drv, % ltxcmds-test1.tex. % % Distribution: % CTAN:macros/latex/contrib/oberdiek/ltxcmds.dtx % CTAN:macros/latex/contrib/oberdiek/ltxcmds.pdf % % Unpacking: % (a) If ltxcmds.ins is present: % tex ltxcmds.ins % (b) Without ltxcmds.ins: % tex ltxcmds.dtx % (c) If you insist on using LaTeX % latex \let\install=y\input{ltxcmds.dtx} % (quote the arguments according to the demands of your shell) % % Documentation: % (a) If ltxcmds.drv is present: % latex ltxcmds.drv % (b) Without ltxcmds.drv: % latex ltxcmds.dtx; ... % The class ltxdoc loads the configuration file ltxdoc.cfg % 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 ltxcmds.dtx % makeindex -s gind.ist ltxcmds.idx % pdflatex ltxcmds.dtx % makeindex -s gind.ist ltxcmds.idx % pdflatex ltxcmds.dtx % % Installation: % TDS:tex/generic/oberdiek/ltxcmds.sty % TDS:doc/latex/oberdiek/ltxcmds.pdf % TDS:doc/latex/oberdiek/test/ltxcmds-test1.tex % TDS:source/latex/oberdiek/ltxcmds.dtx % %<*ignore> \begingroup \def\x{LaTeX2e}% \expandafter\endgroup \ifcase 0\ifx\install y1\fi\expandafter \ifx\csname processbatchFile\endcsname\relax\else1\fi \ifx\fmtname\x\else 1\fi\relax \else\csname fi\endcsname % %<*install> \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} \Msg{* Package: ltxcmds 2010/01/28 v1.2 LaTeX kernel commands for general use (HO)} \Msg{************************************************************************} \keepsilent \askforoverwritefalse \let\MetaPrefix\relax \preamble This is a generated file. Copyright (C) 2009, 2010 by Heiko Oberdiek 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 version. This version of this license is in http://www.latex-project.org/lppl/lppl-1-3c.txt and the latest version of this license is in 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 ltxcmds.dtx and the derived files ltxcmds.sty, ltxcmds.pdf, ltxcmds.ins, ltxcmds.drv, ltxcmds-test1.tex. \endpreamble \let\MetaPrefix\DoubleperCent \generate{% \file{ltxcmds.ins}{\from{ltxcmds.dtx}{install}}% \file{ltxcmds.drv}{\from{ltxcmds.dtx}{driver}}% \usedir{tex/generic/oberdiek}% \file{ltxcmds.sty}{\from{ltxcmds.dtx}{package}}% \usedir{doc/latex/oberdiek/test}% \file{ltxcmds-test1.tex}{\from{ltxcmds.dtx}{test1}}% } \obeyspaces \Msg{************************************************************************} \Msg{*} \Msg{* To finish the installation you have to move the following} \Msg{* file into a directory searched by TeX:} \Msg{*} \Msg{* ltxcmds.sty} \Msg{*} \Msg{* And install the following script file:} \Msg{*} \Msg{* } \Msg{*} \Msg{* To produce the documentation run the file `ltxcmds.drv'} \Msg{* through LaTeX.} \Msg{*} \Msg{* Happy TeXing!} \Msg{*} \Msg{************************************************************************} \endbatchfile % %<*ignore> \fi % %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{ltxcmds.drv}% [2010/01/28 v1.2 LaTeX kernel commands for general use (HO)]% \documentclass{ltxdoc} \usepackage{holtxdoc}[2008/08/11] \usepackage{zref-savepos} \begin{document} \DocInput{ltxcmds.dtx}% \end{document} % % \fi % % \CheckSum{569} % % \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 \~} % % \GetFileInfo{ltxcmds.drv} % % \title{The \xpackage{ltxcmds} package} % \date{2010/01/28 v1.2} % \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}} % % \maketitle % % \begin{abstract} % The package \xpackage{ltxcmds} exports some utility macros % from the \LaTeX\ kernel into a separate namespace and % also provides them for other formats such as plain-\TeX. % \end{abstract} % % \tableofcontents % % \newcounter{to} % \renewcommand*{\theto}{to\arabic{to}} % \newlength\tolength % \tolength=\dimexpr .5\linewidth+\oddsidemargin+1in+15mm\relax % \newcommand*{\TO}{^^A % \quad % \stepcounter{to}^^A % \zsavepos\theto % \ifdim\zposx\theto sp>0pt % \ifdim\zposx\theto sp<\tolength % \kern\dimexpr\tolength-\zposx\theto sp\relax % \fi % \fi % $\rightarrow$\quad % \ignorespaces % } % % \section{Documentation} % % \subsection{Introduction} % % Many of my packages also support other formats such as plain-\TeX. % Because I am rather familiar with the utility macros from % \LaTeX's kernel (e.g. \cs{@gobble}, \cs{@firstoftwo}), I found % myself rewriting them again and again, because they are lacking % in plain-\TeX. % % Therefore this package provides often used macros and similar % ones with the name prefix \cs{ltx@}. This avoids also faulty % redefinitions. I remember an example where a package redefined % \cs{@firstoftwo} with forgetting \cs{long}. % % \subsection{Argument killers} % % \begin{declcs}{ltx@gobble} \M{1} \TO\\ % \cs{ltx@gobbletwo} \M{1} \M{2} \TO\\ % \cs{ltx@gobblethree} \M{1} \M{2} \M{3} \TO\\ % \cs{ltx@gobblefour} \M{1} \M{2} \M{3} \M{4} \TO % \end{declcs} % % \subsection{Argument grabbers} % % \begin{declcs}{ltx@firstofone} \M{1} \TO \meta{1}\\ % \cs{ltx@firstoftwo} \M{1} \M{2} \TO \meta{1}\\ % \cs{ltx@secondoftwo} \M{1} \M{2} \TO \meta{2} % \end{declcs} % % \subsection{List helpers} % % \begin{declcs}{ltx@car} \M{1} \dots \cs{@nil} \TO \meta{1}\\ % \cs{ltx@cdr} \M{1} \dots \cs{@nil} \TO \dots\\ % \end{declcs} % % \subsection{Tail recursion} % % \begin{declcs}{ltx@ReturnAfterFi} \M{1} \cs{fi} \TO \cs{fi} \meta{1}\\ % \cs{ltx@ReturnAfterElseFi} \M{1} \cs{else} \M{2} \cs{fi} % \TO \cs{fi} \meta{1} % \end{declcs} % % \subsection{Empty macro} % % \begin{declcs}{ltx@empty} \TO % \end{declcs} % % \subsection{Characters} % % \begin{declcs}{ltx@space}\\ % \cs{ltx@percentchar}\\ % \cs{ltx@backslashchar} % \end{declcs} % % \subsection{Command definitions} % % \begin{declcs}{ltx@ifundefined} \M{cmd} \M{yes} \M{no} % \end{declcs} % If \eTeX\ is available, \cs{ifcsname} is used that does % not have the side effect of defining undefined commands % with meaning of \cs{relax}. This command is always expandable. % Change in version 1.1: Also the meaning \cs{relax} is % always considered ``undefined''. % % \begin{declcs}{ltx@IfUndefined} \M{cmd} \M{yes} \M{no} % \end{declcs} % If \eTeX\ is available, \cs{ifcsname} is used that does % not have the side effect of defining undefined commands % with meaning of \cs{relax}. Also it always checks for % the meaning of \cs{relax} and considers this as undefined. % This macro is not expandable without \eTeX. % % \begin{declcs}{ltx@LocalExpandAfter} % \end{declcs} % It expands the token after the next token but in a local % context. That is the difference to \cs{expandafter}. % The local context discards the side effect of \cs{csname} % and let the command undefined after the expansion step. % % \subsection{Stripping} % % \begin{declcs}{ltx@RemovePrefix}\\ % \cs{ltx@StripPrefix} % \end{declcs} % All tokens up to and including the next available character % `\textgreater' are thrown away. Usually it is used to strip % the first part of the output of the commands \cs{meaning} % or \cs{pdflastmatch}. Macro \cs{ltx@RemovePrefix} % has the same meaning as \LaTeX's \cs{strip@prefix}, whereas % macro \cs{ltx@StripPrefix} expands the next token % once before stripping the prefix. % % \subsection{File management} % % All macros in this section are expandable like % the counterparts of the \LaTeX\ kernel. Also they % can be used after the preamble. % % \subsubsection{File extensions} % % \begin{declcs}{ltx@clsextension}\\ % \cs{ltx@pkgextension} % \end{declcs} % If \cs{@clsextension}\slash\cs{@pkgextension} exists then % \cs{ltx@clsextension}\slash\cs{ltx@pkgextension} % returns this macro, otherwise the result is |cls|\slash|sty|. % % \subsubsection{Load check} % % \begin{declcs}{ltx@ifclassloaded} \M{class} \M{yes} \M{no}\\ % \cs{ltx@ifpackageloaded} \M{package} \M{yes} \M{no} % \end{declcs} % If the \meta{class}\slash\meta{package} are loaded the % macros \cs{ltx@ifclassloaded}\slash\cs{ltx@ifpackageloaded} % call the \meta{yes} argument. Otherwise \meta{no} is executed. % Both \meta{class} and \meta{package} are specified without % extension. % % \begin{declcs}{ltx@iffileloaded} \M{file} \M{yes} \M{no} % \end{declcs} % If \LaTeX's \cs{ProvidesFile} macro was called before % using \meta{file} as argument, then \cs{ltx@iffileloaded} % calls \meta{yes}, otherwise \meta{no}. % Therefore it is possible % that the \meta{file} is loaded, but \meta{no} is executed because % of a missing \cs{ProvidesFile}. The \LaTeX\ kernel does not have % a counterpart of \cs{ltx@iffileloaded}. % % Note that the file name used in \cs{ProvidesFile} and % \cs{ltx@iffileloaded} must match. For example, if \TeX's % default extension \xext{.tex} was given in the first command, % then it must also specified in the latter command and vice versa. % % \subsubsection{Version date check} % % \begin{declcs}{ltx@ifclasslater} \M{class} \M{date} \M{yes} \M{no}\\ % \cs{ltx@ifpackagelater} \M{package} \M{date} \M{yes} \M{no}\\ % \cs{ltx@iffilelater} \M{file} \M{date} \M{yes} \M{no} % \end{declcs} % If a \cs{ProvidesClass}\slash\cs{ProvidesPackage}\slash % \cs{ProvidesFile} command with exact the same class\slash package\slash % file was executed before with an optional % argument that starts with a \LaTeX\ version date, then % this version date is compared with the argument \meta{date}. % If they are equal or if the version date is the later date, % then \meta{yes} is called. In all other cases \meta{no} is executed. % % A \LaTeX\ date has the format |YYYY/MM/DD| with |YYYY| as year % with four digits, |MM| as month with two digits and |DD| as day % with two digits. If \pdfTeX's \cs{pdfmatch} is available, then % it is used to detect the version date, to reject invalid % date formats and to reject some invalid dates. % Dates before 1994/01/01 are always invalid, because version % dates are introduced with \LaTeXe\ in 1994. % % \subsection{Macro additions} % % \begin{declcs}{ltx@GlobalAppendToMacro} \M{cmd} \M{addition}\\ % \cs{ltx@LocalAppendToMacro} \M{cmd} \M{addition} % \end{declcs} % The \meta{addition} is appended to the parameterless macro \meta{cmd}. % If \meta{cmd} is undefined or has the meaning \cs{relax}, then % it will be initialized as empty macro before. % % \StopEventually{ % } % % \section{Implementation} % % \subsection{Identification} % % \begin{macrocode} %<*package> % \end{macrocode} % Reload check, especially if the package is not used with \LaTeX. % \begin{macrocode} \begingroup \catcode44 12 % , \catcode45 12 % - \catcode46 12 % . \catcode58 12 % : \catcode64 11 % @ \catcode123 1 % { \catcode125 2 % } \expandafter\let\expandafter\x\csname ver@ltxcmds.sty\endcsname \ifx\x\relax % plain-TeX, first loading \else \def\empty{}% \ifx\x\empty % LaTeX, first loading, % variable is initialized, but \ProvidesPackage not yet seen \else \catcode35 6 % # \expandafter\ifx\csname PackageInfo\endcsname\relax \def\x#1#2{% \immediate\write-1{Package #1 Info: #2.}% }% \else \def\x#1#2{\PackageInfo{#1}{#2, stopped}}% \fi \x{ltxcmds}{The package is already loaded}% \aftergroup\endinput \fi \fi \endgroup % \end{macrocode} % Package identification: % \begin{macrocode} \begingroup \catcode35 6 % # \catcode40 12 % ( \catcode41 12 % ) \catcode44 12 % , \catcode45 12 % - \catcode46 12 % . \catcode47 12 % / \catcode58 12 % : \catcode64 11 % @ \catcode91 12 % [ \catcode93 12 % ] \catcode123 1 % { \catcode125 2 % } \expandafter\ifx\csname ProvidesPackage\endcsname\relax \def\x#1#2#3[#4]{\endgroup \immediate\write-1{Package: #3 #4}% \xdef#1{#4}% }% \else \def\x#1#2[#3]{\endgroup #2[{#3}]% \ifx#1\@undefined \xdef#1{#3}% \fi \ifx#1\relax \xdef#1{#3}% \fi }% \fi \expandafter\x\csname ver@ltxcmds.sty\endcsname \ProvidesPackage{ltxcmds}% [2010/01/28 v1.2 LaTeX kernel commands for general use (HO)] % \end{macrocode} % % \begin{macrocode} \begingroup \catcode123 1 % { \catcode125 2 % } \def\x{\endgroup \expandafter\edef\csname LTXcmds@AtEnd\endcsname{% \catcode35 \the\catcode35\relax \catcode64 \the\catcode64\relax \catcode123 \the\catcode123\relax \catcode125 \the\catcode125\relax }% }% \x \catcode35 6 % # \catcode64 11 % @ \catcode123 1 % { \catcode125 2 % } \def\TMP@EnsureCode#1#2{% \edef\LTXcmds@AtEnd{% \LTXcmds@AtEnd \catcode#1 \the\catcode#1\relax }% \catcode#1 #2\relax } \TMP@EnsureCode{40}{12}% ( \TMP@EnsureCode{41}{12}% ) \TMP@EnsureCode{45}{12}% - \TMP@EnsureCode{46}{12}% . \TMP@EnsureCode{47}{12}% / \TMP@EnsureCode{60}{12}% < \TMP@EnsureCode{61}{12}% = \TMP@EnsureCode{62}{12}% > \TMP@EnsureCode{91}{12}% [ \TMP@EnsureCode{96}{12}% ` \TMP@EnsureCode{93}{12}% ] \TMP@EnsureCode{94}{12}% ^ (superscript) (!) \TMP@EnsureCode{124}{12}% | % \end{macrocode} % % \subsection{Argument killers} % % \begin{macro}{\ltx@gobble} % \begin{macrocode} \long\def\ltx@gobble#1{} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@gobbletwo} % \begin{macrocode} \long\def\ltx@gobbletwo#1#2{} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@gobblethree} % \begin{macrocode} \long\def\ltx@gobblethree#1#2#3{} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@gobblefour} % \begin{macrocode} \long\def\ltx@gobblefour#1#2#3#4{} % \end{macrocode} % \end{macro} % % \subsection{Argument grabbers} % % \begin{macro}{\ltx@firstofone} % \begin{macrocode} \long\def\ltx@firstofone#1{#1} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@firstoftwo} % \begin{macrocode} \long\def\ltx@firstoftwo#1#2{#1} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@secondoftwo} % \begin{macrocode} \long\def\ltx@secondoftwo#1#2{#2} % \end{macrocode} % \end{macro} % % \subsection{List helpers} % % \begin{macro}{\ltx@car} % \begin{macrocode} \long\def\ltx@car#1#2\@nil{#1} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@cdr} % \begin{macrocode} \long\def\ltx@cdr#1#2\@nil{#2} % \end{macrocode} % \end{macro} % % \subsection{Tail recursion} % % \begin{macro}{\ltx@ReturnAfterFi} % \begin{macrocode} \long\def\ltx@ReturnAfterFi#1\fi{#1} % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@ReturnAfterElseFi} % \begin{macrocode} \long\def\ltx@ReturnAfterFi#1\else#2\fi{#1} % \end{macrocode} % \end{macro} % % \subsection{Empty macro} % % \begin{macro}{\ltx@empty} % \begin{macrocode} \def\ltx@empty{} % \end{macrocode} % \end{macro} % % \subsection{Characters} % % \begin{macro}{\ltx@space} % \begin{macrocode} \def\ltx@space{ } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@percentchar} % \begin{macrocode} \begingroup \lccode`0=`\%\relax \lowercase{\endgroup \def\ltx@percentchar{0}% } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@backslashchar} % \begin{macrocode} \begingroup \lccode`0=`\\\relax \lowercase{\endgroup \def\ltx@backslashchar{0}% } % \end{macrocode} % \end{macro} % % \subsection{Command definitions} % % \begin{macro}{\ltx@LocalExpandAfter} % \begin{macrocode} \def\ltx@LocalExpandAfter{% \begingroup \expandafter\expandafter\expandafter \endgroup \expandafter } % \end{macrocode} % \end{macro} % % \begin{macrocode} \ltx@LocalExpandAfter \ifx\csname ifcsname\endcsname\relax % \end{macrocode} % \begin{macro}{\ltx@ifundefined} % \begin{macrocode} \def\ltx@ifundefined#1{% \expandafter\ifx\csname #1\endcsname\relax \expandafter\ltx@firstoftwo \else \expandafter\ltx@secondoftwo \fi }% % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@IfUndefined} % \begin{macrocode} \def\ltx@IfUndefined#1{% \begingroup\expandafter\expandafter\expandafter\endgroup \expandafter\ifx\csname #1\endcsname\relax \expandafter\ltx@firstoftwo \else \expandafter\ltx@secondoftwo \fi }% % \end{macrocode} % \end{macro} % \begin{macrocode} \expandafter\ltx@gobble \else \expandafter\ltx@firstofone \fi {% % \end{macrocode} % \begin{macro}{\ltx@ifundefined} % \begin{macrocode} \def\ltx@ifundefined#1{% \ifcsname #1\endcsname \expandafter\ifx\csname #1\endcsname\relax \expandafter\expandafter\expandafter\ltx@firstoftwo \else \expandafter\expandafter\expandafter\ltx@secondoftwo \fi \else \expandafter\ltx@firstoftwo \fi }% % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@IfUndefined} % \begin{macrocode} \let\ltx@IfUndefined\ltx@ifundefined % \end{macrocode} % \end{macro} % \begin{macrocode} } % \end{macrocode} % % \subsection{Stripping} % % \begin{macro}{\ltx@RemovePrefix} % \begin{macrocode} \def\ltx@RemovePrefix#1>{} % \end{macrocode} % \end{macro} % % \begin{macro}{\ltx@StripPrefix} % \begin{macrocode} \def\ltx@StripPrefix{% \expandafter\ltx@RemovePrefix } % \end{macrocode} % \end{macro} % % \subsection{File management} % % \subsubsection{File extensions} % % \begin{macro}{\ltx@clsextension} % \begin{macrocode} \def\ltx@clsextension{% \ltx@ifundefined{@clsextension}{cls}\@clsextension } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@pkgextension} % \begin{macrocode} \def\ltx@pkgextension{% \ltx@ifundefined{@pkgextension}{sty}\@pkgextension } % \end{macrocode} % \end{macro} % % \subsubsection{Load check} % % \begin{macro}{\ltx@iffileloaded} % \begin{macrocode} \def\ltx@iffileloaded#1{% \ltx@ifundefined{ver@#1}\ltx@secondoftwo\ltx@firstoftwo } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@ifclassloaded} % \begin{macrocode} \def\ltx@ifclassloaded#1{% \ltx@iffileloaded{#1.\ltx@clsextension}% } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@ifpackageloaded} % \begin{macrocode} \def\ltx@ifpackageloaded#1{% \ltx@iffileloaded{#1.\ltx@pkgextension}% } % \end{macrocode} % \end{macro} % % \subsubsection{Version date check} % % \begin{macro}{\ltx@iffilelater} % \begin{macrocode} \def\ltx@iffilelater#1#2{% \ltx@iffileloaded{#1}{% \expandafter\LTXcmds@IfLater\expandafter{% \number \expandafter\expandafter\expandafter\LTXcmds@ParseVersion \expandafter\expandafter\expandafter{% \csname ver@#1\endcsname }% \expandafter}\expandafter{% \number \expandafter\LTXcmds@ParseVersion\expandafter{#2}% }% }\ltx@secondoftwo } % \end{macrocode} % \end{macro} % \begin{macro}{\LTXcmds@IfLater} % \begin{macrocode} \def\LTXcmds@IfLater#1#2{% \ifcase 0% \ifnum#1<19940101 % \else \ifnum#2<19940101 % \else \ifnum#2>#1 % \else 1% \fi \fi \fi \ltx@space \expandafter\ltx@secondoftwo \else \expandafter\ltx@firstoftwo \fi } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@ifclasslater} % \begin{macrocode} \def\ltx@ifclasslater#1{% \ltx@ifclasslater{#1.\ltx@clsextension}% } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@ifpackagelater} % \begin{macrocode} \def\ltx@ifpackagelater#1{% \ltx@iffilelater{#1.\ltx@pkgextension}% } % \end{macrocode} % \end{macro} % % \begin{macrocode} \ltx@IfUndefined{pdfmatch}{% % \end{macrocode} % \begin{macro}{\LTXcmds@ParseVersion} % \begin{macrocode} \def\LTXcmds@ParseVersion#1{% \LTXcmds@@ParseVersion#10000/00/00\@nil }% % \end{macrocode} % \end{macro} % \begin{macro}{\LTXcmds@@ParseVersion} % \begin{macrocode} \def\LTXcmds@@ParseVersion#1#2#3#4/#5#6/#7#8#9\@nil{% #1#2#3#4#5#6#7#8% }% % \end{macrocode} % \end{macro} % \begin{macrocode} }{% % \end{macrocode} % \begin{macro}{\LTXcmds@ParseVersion} % \begin{macrocode} \def\LTXcmds@ParseVersion#1{% \ifnum\pdfmatch{% ^% (199[4-9]|[2-9][0-9][0-9][0-9])/% (0[1-9]|1[0-2])/% (0[1-9]|[1-2][0-9]|3[0-1])% }{#1}=1 % \ltx@StripPrefix\pdflastmatch1 % \ltx@StripPrefix\pdflastmatch2 % \ltx@StripPrefix\pdflastmatch3 % \else 0% \fi }% } % \end{macrocode} % \end{macro} % % \subsection{Macro additions} % % \begin{macro}{\ltx@GlobalAppendToMacro} % \begin{macrocode} \def\ltx@GlobalAppendToMacro#1#2{% \ifx\ltx@undefined#1% \let#1\ltx@empty \else \ifx\relax#1% \let#1\ltx@empty \fi \fi \begingroup \toks0\expandafter{#1#2}% \xdef#1{\the\toks0}% \endgroup } % \end{macrocode} % \end{macro} % \begin{macro}{\ltx@LocalAppendToMacro} % \begin{macrocode} \def\ltx@LocalAppendToMacro#1#2{% \global\let\LTXcmds@gtemp#1% \ifx\ltx@undefined\LTXcmds@gtemp \global\let\LTXcmds@gtemp\ltx@empty \else \ifx\relax\LTXcmds@gtemp \global\letLTXcmds@gtemp\ltx@empty \fi \fi \begingroup \toks0\expandafter{\LTXcmds@gtemp#2}% \xdef\LTXcmds@gtemp{\the\toks0}% \endgroup \let#1\LTXcmds@gtemp } % \end{macrocode} % \end{macro} % % \begin{macrocode} \LTXcmds@AtEnd % % \end{macrocode} % % \section{Test} % % \subsection{Catcode checks for loading} % % \begin{macrocode} %<*test1> % \end{macrocode} % \begin{macrocode} \catcode`\{=1 % \catcode`\}=2 % \catcode`\#=6 % \catcode`\@=11 % \expandafter\ifx\csname count@\endcsname\relax \countdef\count@=255 % \fi \expandafter\ifx\csname @gobble\endcsname\relax \long\def\@gobble#1{}% \fi \expandafter\ifx\csname @firstofone\endcsname\relax \long\def\@firstofone#1{#1}% \fi \expandafter\ifx\csname loop\endcsname\relax \expandafter\@firstofone \else \expandafter\@gobble \fi {% \def\loop#1\repeat{% \def\body{#1}% \iterate }% \def\iterate{% \body \let\next\iterate \else \let\next\relax \fi \next }% \let\repeat=\fi }% \def\RestoreCatcodes{} \count@=0 % \loop \edef\RestoreCatcodes{% \RestoreCatcodes \catcode\the\count@=\the\catcode\count@\relax }% \ifnum\count@<255 % \advance\count@ 1 % \repeat \def\RangeCatcodeInvalid#1#2{% \count@=#1\relax \loop \catcode\count@=15 % \ifnum\count@<#2\relax \advance\count@ 1 % \repeat } \expandafter\ifx\csname LoadCommand\endcsname\relax \def\LoadCommand{\input ltxcmds.sty\relax}% \fi \def\Test{% \RangeCatcodeInvalid{0}{47}% \RangeCatcodeInvalid{58}{64}% \RangeCatcodeInvalid{91}{96}% \RangeCatcodeInvalid{123}{255}% \catcode`\@=12 % \catcode`\\=0 % \catcode`\{=1 % \catcode`\}=2 % \catcode`\#=6 % \catcode`\[=12 % \catcode`\]=12 % \catcode`\%=14 % \catcode`\ =10 % \catcode13=5 % \LoadCommand \RestoreCatcodes } \Test \csname @@end\endcsname \end % \end{macrocode} % \begin{macrocode} % % \end{macrocode} % % % \section{Installation} % % \subsection{Download} % % \paragraph{Package.} This package is available on % CTAN\footnote{\url{ftp://ftp.ctan.org/tex-archive/}}: % \begin{description} % \item[\CTAN{macros/latex/contrib/oberdiek/ltxcmds.dtx}] The source file. % \item[\CTAN{macros/latex/contrib/oberdiek/ltxcmds.pdf}] Documentation. % \end{description} % % % \paragraph{Bundle.} All the packages of the bundle `oberdiek' % are also available in a TDS compliant ZIP archive. There % the packages are already unpacked and the documentation files % are generated. The files and directories obey the TDS standard. % \begin{description} % \item[\CTAN{install/macros/latex/contrib/oberdiek.tds.zip}] % \end{description} % \emph{TDS} refers to the standard ``A Directory Structure % for \TeX\ Files'' (\CTAN{tds/tds.pdf}). Directories % with \xfile{texmf} in their name are usually organized this way. % % \subsection{Bundle installation} % % \paragraph{Unpacking.} Unpack the \xfile{oberdiek.tds.zip} in the % TDS tree (also known as \xfile{texmf} tree) of your choice. % Example (linux): % \begin{quote} % |unzip oberdiek.tds.zip -d ~/texmf| % \end{quote} % % \paragraph{Script installation.} % Check the directory \xfile{TDS:scripts/oberdiek/} for % scripts that need further installation steps. % Package \xpackage{attachfile2} comes with the Perl script % \xfile{pdfatfi.pl} that should be installed in such a way % that it can be called as \texttt{pdfatfi}. % Example (linux): % \begin{quote} % |chmod +x scripts/oberdiek/pdfatfi.pl|\\ % |cp scripts/oberdiek/pdfatfi.pl /usr/local/bin/| % \end{quote} % % \subsection{Package installation} % % \paragraph{Unpacking.} The \xfile{.dtx} file is a self-extracting % \docstrip\ archive. The files are extracted by running the % \xfile{.dtx} through \plainTeX: % \begin{quote} % \verb|tex ltxcmds.dtx| % \end{quote} % % \paragraph{TDS.} Now the different files must be moved into % the different directories in your installation TDS tree % (also known as \xfile{texmf} tree): % \begin{quote} % \def\t{^^A % \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}} % ltxcmds.sty & tex/generic/oberdiek/ltxcmds.sty\\ % ltxcmds.pdf & doc/latex/oberdiek/ltxcmds.pdf\\ % test/ltxcmds-test1.tex & doc/latex/oberdiek/test/ltxcmds-test1.tex\\ % ltxcmds.dtx & source/latex/oberdiek/ltxcmds.dtx\\ % \end{tabular}^^A % }^^A % \sbox0{\t}^^A % \ifdim\wd0>\linewidth % \begingroup % \advance\linewidth by\leftmargin % \advance\linewidth by\rightmargin % \edef\x{\endgroup % \def\noexpand\lw{\the\linewidth}^^A % }\x % \def\lwbox{^^A % \leavevmode % \hbox to \linewidth{^^A % \kern-\leftmargin\relax % \hss % \usebox0 % \hss % \kern-\rightmargin\relax % }^^A % }^^A % \ifdim\wd0>\lw % \sbox0{\small\t}^^A % \ifdim\wd0>\linewidth % \ifdim\wd0>\lw % \sbox0{\footnotesize\t}^^A % \ifdim\wd0>\linewidth % \ifdim\wd0>\lw % \sbox0{\scriptsize\t}^^A % \ifdim\wd0>\linewidth % \ifdim\wd0>\lw % \sbox0{\tiny\t}^^A % \ifdim\wd0>\linewidth % \lwbox % \else % \usebox0 % \fi % \else % \lwbox % \fi % \else % \usebox0 % \fi % \else % \lwbox % \fi % \else % \usebox0 % \fi % \else % \lwbox % \fi % \else % \usebox0 % \fi % \else % \lwbox % \fi % \else % \usebox0 % \fi % \end{quote} % If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's % TDS installing feature, then some files can already be in the right % place, see the documentation of \docstrip. % % \subsection{Refresh file name databases} % % If your \TeX~distribution % (\teTeX, \mikTeX, \dots) relies on file name databases, you must refresh % these. For example, \teTeX\ users run \verb|texhash| or % \verb|mktexlsr|. % % \subsection{Some details for the interested} % % \paragraph{Attached source.} % % The PDF documentation on CTAN also includes the % \xfile{.dtx} source file. It can be extracted by % AcrobatReader 6 or higher. Another option is \textsf{pdftk}, % e.g. unpack the file into the current directory: % \begin{quote} % \verb|pdftk ltxcmds.pdf unpack_files output .| % \end{quote} % % \paragraph{Unpacking with \LaTeX.} % The \xfile{.dtx} chooses its action depending on the format: % \begin{description} % \item[\plainTeX:] Run \docstrip\ and extract the files. % \item[\LaTeX:] Generate the documentation. % \end{description} % If you insist on using \LaTeX\ for \docstrip\ (really, % \docstrip\ does not need \LaTeX), then inform the autodetect routine % about your intention: % \begin{quote} % \verb|latex \let\install=y\input{ltxcmds.dtx}| % \end{quote} % Do not forget to quote the argument according to the demands % of your shell. % % \paragraph{Generating the documentation.} % You can use both the \xfile{.dtx} or the \xfile{.drv} to generate % the documentation. The process can be configured by the % configuration file \xfile{ltxdoc.cfg}. For instance, put this % line into this file, if you want to have A4 as paper format: % \begin{quote} % \verb|\PassOptionsToClass{a4paper}{article}| % \end{quote} % An example follows how to generate the % documentation with pdf\LaTeX: % \begin{quote} %\begin{verbatim} %pdflatex ltxcmds.dtx %makeindex -s gind.ist ltxcmds.idx %pdflatex ltxcmds.dtx %makeindex -s gind.ist ltxcmds.idx %pdflatex ltxcmds.dtx %\end{verbatim} % \end{quote} % % \begin{History} % \begin{Version}{2009/08/05 v1.0} % \item % First version. % \end{Version} % \begin{Version}{2009/12/12 v1.1} % \item % Short title shortened. % \item % \cs{ltx@IfUndefined} added. % \end{Version} % \begin{Version}{2010/01/28 v1.2} % \item % \cs{ltx@RemovePrefix} and \cs{ltx@StripPrefix} added. % \item % \cs{ltx@ifclassloaded}, \cs{ltx@ifpackageloaded}, % \cs{ltx@iffileloaded}, % \cs{ltx@ifclasslater}, \cs{ltx@ifpackagelater}, % \cs{ltx@iffilelater}, % \cs{ltx@clsextension}, \cs{ltx@pkgextension} added. % \item % \cs{ltx@GlobalAppendMacro}, \cs{ltx@LocalAppendMacro} added. % \end{Version} % \end{History} % % \PrintIndex % % \Finale \endinput