diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/grfext.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/oberdiek/grfext.dtx | 201 |
1 files changed, 145 insertions, 56 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/grfext.dtx b/Master/texmf-dist/source/latex/oberdiek/grfext.dtx index 570efab6c2b..9e1906c2466 100644 --- a/Master/texmf-dist/source/latex/oberdiek/grfext.dtx +++ b/Master/texmf-dist/source/latex/oberdiek/grfext.dtx @@ -1,6 +1,6 @@ % \iffalse meta-comment % -% Copyright (C) 2007 by +% Copyright (C) 2007, 2010 by % Heiko Oberdiek <heiko.oberdiek at googlemail.com> % % This work may be distributed and/or modified under the @@ -74,7 +74,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: grfext 2007/09/30 v1.0 Managing graphics extensions (HO)} +\Msg{* Package: grfext 2010/08/19 v1.1 Managing graphics extensions (HO)} \Msg{************************************************************************} \keepsilent @@ -85,7 +85,7 @@ This is a generated file. -Copyright (C) 2007 by +Copyright (C) 2007, 2010 by Heiko Oberdiek <heiko.oberdiek at googlemail.com> This work may be distributed and/or modified under the @@ -148,7 +148,7 @@ and the derived files %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{grfext.drv}% - [2007/09/30 v1.0 Managing graphics extensions (HO)]% + [2010/08/19 v1.1 Managing graphics extensions (HO)]% \documentclass{ltxdoc} \usepackage{holtxdoc}[2008/08/11] \begin{document} @@ -157,7 +157,7 @@ and the derived files %</driver> % \fi % -% \CheckSum{635} +% \CheckSum{721} % % \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 @@ -178,7 +178,7 @@ and the derived files % \GetFileInfo{grfext.drv} % % \title{The \xpackage{grfext} package} -% \date{2007/09/30 v1.0} +% \date{2010/08/19 v1.1} % \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}} % % \maketitle @@ -254,6 +254,30 @@ and the derived files % The macros described before do this automatically % after their operation. % +% \subsection{Option support for package \xpackage{graphicx}} +% +% Package \xpackage{graphicx} uses the interface of package +% \xpackage{keyval} in order to specify options for +% \cs{includegraphics}. The options can also be set using +% \begin{quote} +% |\setkeys{Gin}{|\meta{options}|}| +% \end{quote} +% The four user macros with the two star forms are available +% as options in family |Gin| as well: +% \begin{quote} +% |AppendGraphicsExtensions={|\meta{ext-list}|}|\\ +% |AppendGraphicsExtensions*={|\meta{ext-list}|}|\\ +% |PrependGraphicsExtensions={|\meta{ext-list}|}|\\ +% |PrependGraphicsExtensions*{|\meta{ext-list}|}|\\ +% |RemoveGraphicsExtensions={|\meta{ext-list}|}|\\ +% |PrintGraphicsExtensions| +% \end{quote} +% This makes it easier to locally change the extension list +% for an included graphics, e.g.: +% \begin{quote} +% |\includegraphics[RemoveGraphicsExtensions={.pdf,PDF}]{image}| +% \end{quote} +% % \subsection{\plainTeX} % % \LaTeX's graphics packages can also be used with \plainTeX. @@ -282,14 +306,18 @@ and the derived files % \subsection{Relead check and identification} % 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 % } +\begingroup\catcode61\catcode48\catcode32=10\relax% + \catcode13=5 % ^^M + \endlinechar=13 % + \catcode35=6 % # + \catcode39=12 % ' + \catcode44=12 % , + \catcode45=12 % - + \catcode46=12 % . + \catcode58=12 % : + \catcode64=11 % @ + \catcode123=1 % { + \catcode125=2 % } \expandafter\let\expandafter\x\csname ver@grfext.sty\endcsname \ifx\x\relax % plain-TeX, first loading \else @@ -297,7 +325,6 @@ and the derived files \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.}% @@ -309,24 +336,27 @@ and the derived files \aftergroup\endinput \fi \fi -\endgroup +\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 % } +\begingroup\catcode61\catcode48\catcode32=10\relax% + \catcode13=5 % ^^M + \endlinechar=13 % + \catcode35=6 % # + \catcode39=12 % ' + \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}% @@ -345,44 +375,53 @@ and the derived files \fi \expandafter\x\csname ver@grfext.sty\endcsname \ProvidesPackage{grfext}% - [2007/09/30 v1.0 Managing graphics extensions (HO)] + [2010/08/19 v1.1 Managing graphics extensions (HO)]% % \end{macrocode} % % \subsection{Catcodes} % % \begin{macrocode} -\begingroup - \catcode123 1 % { - \catcode125 2 % } +\begingroup\catcode61\catcode48\catcode32=10\relax% + \catcode13=5 % ^^M + \endlinechar=13 % + \catcode123=1 % { + \catcode125=2 % } + \catcode64=11 % @ \def\x{\endgroup \expandafter\edef\csname grfext@AtEnd\endcsname{% - \catcode35 \the\catcode35\relax - \catcode64 \the\catcode64\relax - \catcode123 \the\catcode123\relax - \catcode125 \the\catcode125\relax + \endlinechar=\the\endlinechar\relax + \catcode13=\the\catcode13\relax + \catcode32=\the\catcode32\relax + \catcode35=\the\catcode35\relax + \catcode61=\the\catcode61\relax + \catcode64=\the\catcode64\relax + \catcode123=\the\catcode123\relax + \catcode125=\the\catcode125\relax }% }% -\x -\catcode35 6 % # -\catcode64 11 % @ -\catcode123 1 % { -\catcode125 2 % } +\x\catcode61\catcode48\catcode32=10\relax% +\catcode13=5 % ^^M +\endlinechar=13 % +\catcode35=6 % # +\catcode64=11 % @ +\catcode123=1 % { +\catcode125=2 % } \def\TMP@EnsureCode#1#2{% \edef\grfext@AtEnd{% \grfext@AtEnd - \catcode#1 \the\catcode#1\relax + \catcode#1=\the\catcode#1\relax }% - \catcode#1 #2\relax + \catcode#1=#2\relax } \TMP@EnsureCode{42}{12}% * \TMP@EnsureCode{44}{12}% , \TMP@EnsureCode{47}{12}% / \TMP@EnsureCode{58}{12}% : \TMP@EnsureCode{60}{12}% < -\TMP@EnsureCode{61}{12}% = \TMP@EnsureCode{62}{12}% > \TMP@EnsureCode{91}{12}% [ \TMP@EnsureCode{93}{12}% ] +\edef\grfext@AtEnd{\grfext@AtEnd\noexpand\endinput} % \end{macrocode} % % \subsection{\plainTeX} @@ -563,8 +602,32 @@ and the derived files % \end{macrocode} % \end{macro} % +% \subsection{Defining options for package \xpackage{graphicx}} +% % \begin{macrocode} -\grfext@AtEnd +\RequirePackage{kvdefinekeys}[2010/03/01] +\kv@define@key{Gin}{AppendGraphicsExtensions}{% + \AppendGraphicsExtensions{#1}% +} +\kv@define@key{Gin}{AppendGraphicsExtensions*}{% + \AppendGraphicsExtensions*{#1}% +} +\kv@define@key{Gin}{PrependGraphicsExtensions}{% + \PrependGraphicsExtensions{#1}% +} +\kv@define@key{Gin}{PrependGraphicsExtensions*}{% + \PrependGraphicsExtensions*{#1}% +} +\kv@define@key{Gin}{RemoveGraphicsExtensions}{% + \RemoveGraphicsExtensions{#1}% +} +\kv@define@key{Gin}{PrintGraphicsExtensions}[]{% + \PrintGraphicsExtensions +} +% \end{macrocode} +% +% \begin{macrocode} +\grfext@AtEnd% %</package> % \end{macrocode} % @@ -636,6 +699,22 @@ and the derived files \advance\count@ 1 % \repeat } +\def\RangeCatcodeCheck#1#2#3{% + \count@=#1\relax + \loop + \ifnum#3=\catcode\count@ + \else + \errmessage{% + Character \the\count@\space + with wrong catcode \the\catcode\count@\space + instead of \number#3% + }% + \fi + \ifnum\count@<#2\relax + \advance\count@ 1 % + \repeat +} +\def\space{ } \expandafter\ifx\csname LoadCommand\endcsname\relax \def\LoadCommand{\input grfext.sty\relax}% \fi @@ -646,15 +725,20 @@ and the derived files \RangeCatcodeInvalid{123}{255}% \catcode`\@=12 % \catcode`\\=0 % - \catcode`\{=1 % - \catcode`\}=2 % - \catcode`\#=6 % - \catcode`\[=12 % - \catcode`\]=12 % \catcode`\%=14 % - \catcode`\ =10 % - \catcode13=5 % \LoadCommand + \RangeCatcodeCheck{0}{36}{15}% + \RangeCatcodeCheck{37}{37}{14}% + \RangeCatcodeCheck{38}{47}{15}% + \RangeCatcodeCheck{48}{57}{12}% + \RangeCatcodeCheck{58}{63}{15}% + \RangeCatcodeCheck{64}{64}{12}% + \RangeCatcodeCheck{65}{90}{11}% + \RangeCatcodeCheck{91}{91}{15}% + \RangeCatcodeCheck{92}{92}{0}% + \RangeCatcodeCheck{93}{96}{15}% + \RangeCatcodeCheck{97}{122}{11}% + \RangeCatcodeCheck{123}{255}{15}% \RestoreCatcodes } \Test @@ -675,7 +759,7 @@ and the derived files \nofiles \documentclass{article} \usepackage[pdftex]{graphics} -\usepackage{grfext}[2007/09/30] +\usepackage{grfext}[2010/08/19] \usepackage{qstest} \IncludeTests{*} \LogTests{log}{*}{*} @@ -1034,7 +1118,12 @@ and the derived files % \begin{History} % \begin{Version}{2007/09/30 v1.0} % \item -% First public version, +% First public version. +% \end{Version} +% \begin{Version}{2010/08/19 v1.1} +% \item +% User macros are also made available as keyval options for +% package \xpackage{graphicx}. % \end{Version} % \end{History} % |