diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx')
| -rw-r--r-- | Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx | 160 |
1 files changed, 131 insertions, 29 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx b/Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx index ded8879a4ce..a9e6bc75b5a 100644 --- a/Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx +++ b/Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx @@ -1,6 +1,7 @@ % \iffalse meta-comment % -% Copyright (C) 2001, 2006 by Heiko Oberdiek <oberdiek@uni-freiburg.de> +% Copyright (C) 2001, 2006, 2007 by +% Heiko Oberdiek <oberdiek@uni-freiburg.de> % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either @@ -66,7 +67,7 @@ \input docstrip.tex \Msg{************************************************************************} \Msg{* Installation} -\Msg{* Package: epstopdf 2006/08/26 v1.3 Conversion with epstopdf on the fly (HO)} +\Msg{* Package: epstopdf 2007/04/26 v1.4 Conversion with epstopdf on the fly (HO)} \Msg{************************************************************************} \keepsilent @@ -76,7 +77,8 @@ This is a generated file. -Copyright (C) 2001, 2006 by Heiko Oberdiek <oberdiek@uni-freiburg.de> +Copyright (C) 2001, 2006, 2007 by + Heiko Oberdiek <oberdiek@uni-freiburg.de> This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either @@ -126,7 +128,7 @@ and the derived files %<*driver> \NeedsTeXFormat{LaTeX2e} \ProvidesFile{epstopdf.drv}% - [2006/08/26 v1.3 Conversion with epstopdf on the fly (HO)]% + [2007/04/26 v1.4 Conversion with epstopdf on the fly (HO)]% \documentclass{ltxdoc} \usepackage{holtxdoc} \begin{document} @@ -135,7 +137,7 @@ and the derived files %</driver> % \fi % -% \CheckSum{182} +% \CheckSum{192} % % \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 @@ -156,7 +158,7 @@ and the derived files % \GetFileInfo{epstopdf.drv} % % \title{The \xpackage{epstopdf} package} -% \date{2006/08/26 v1.3} +% \date{2007/04/26 v1.4} % \author{Heiko Oberdiek\\\xemail{oberdiek@uni-freiburg.de}} % % \maketitle @@ -170,30 +172,116 @@ and the derived files % % \tableofcontents % +% \providecommand*{\xprogram}[1]{\textsf{#1}} +% +% \section{Documentation} +% +% \subsection{Requirements} +% +% \begin{itemize} +% \item +% The program \xprogram{epstopdf} for the conversion from EPS +% to PDF. However, other programs can +% be used and configured by \cs{DeclareGraphicsRule}. +% \item +% The feature \cs{write18} must be enabled. This allows the +% running of external programs during \TeX's compile run. +% Keep in mind that this is a security risk. The feature is an +% addition to \cs{TeX}. Mik\TeX, te\TeX, \TeX\ Live support it. +% In Web2C based \TeX\ distributions (te\TeX, \TeX\ Live) it can be +% enabled in the configuration file \xfile{texmf.cnf}: +% \begin{quote} +% |shell_escape = 1| +% \end{quote} +% Because of the security risk, it is better to do it on the +% command line only: +% \begin{quote} +% \texttt{-shell-escape} (te\TeX, \TeX\ Live)\\ +% \texttt{--enable-write18} (MiK\TeX) +% \end{quote} +% Example: +% \begin{quote} +% |pdflatex -shell-escape test.tex| +% \end{quote} +% \end{itemize} +% % \section{Usage} +% +% The package is loaded after graphic\{s,x\}, e.g.: +% \begin{quote} +% |\usepackage[pdftex]{graphicx}|\\ +% |\usepackage{epstopdf}| +% \end{quote} +% Now images with extension `.eps' are detected +% and supported: +% \begin{itemize} +% \item +% Implicitly: |\includegraphics{bild}|\\ +% If \xfile{bild.eps} is present, but \xfile{bild.pdf} is missed, +% then \xfile{bild.eps} is converted to \xfile{bild.pdf} that +% is then included by \pdfTeX. +% On the next ocurrences or on the next \pdfTeX\ run, +% the PDF file is already available, so the +% conversion step is skipped. +% \item +% Explicitly: |\includegraphics{bild.eps}|\\ +% Each time the conversion program is called. +% \end{itemize} +% +% \subsection{Configuration} +% +% Package \xpackage{epstopdf} implements the forth argument +% of \cs{DeclareGraphicsRule} for \pdfTeX. There conversion programs +% can be configured and package \xpackage{epstopdf} declares: +% \begin{quote} +% |\DeclareGraphicsRule{.eps}{pdf}{.pdf}{`epstopdf #1}| +% \end{quote} +% Additionally the extension \xfile{.eps} is added to the +% list of extensions that are recognized by package \xpackage{graphics}, +% see \cs{GraphicsExtensions}. +% +% Instead of \xprogram{epstopdf} other programs can be used, +% for example \xprogram{ghostscript}: +% \begin{quote} +% |\DeclareGraphicsRule{.eps}{pdf}{.pdf}{`ps2pdf -dEPSCrop #1}| +% \end{quote} +% +% \subsection{Other image formats} +% +% The support that package \xpackage{epstopdf} implements is not +% limited to EPS files. Other image conversions can be declared. +% The following example shows it for GIF images under Unix with +% ImageMagick's \xprogram{convert}: +%\begin{quote} +%\begin{verbatim} +%\DeclareGraphicsRule{.gif}{png}{.png}{% +% `convert #1 `basename #1 .gif`.png% +%} +%\end{verbatim} +%\end{quote} +% Or without \xprogram{basename}: +%\begin{quote} %\begin{verbatim} -% Required: * The program `epstopdf'. -% * The feature `\write18' has to be enabled to get -% the conversion via the program epstopdf work: -% * command line option: -shell-escape -% example: pdflatex -shell-escape test.tex -% * configuraton file `texmf.cnf': shell_escape = 1 -% -% Use: The package is loaded after graphic{s,x}, eg: -% \usepackage[pdftex]{graphicx} -% \usepackage{epstopdf} -% Images with extension `.eps' are now detected -% and supported: -% * Implicitly: \includegraphics{bild} -% If `bild.eps' can only be found, -% then it is converted to the file `bild.pdf', -% that will be used by pdfTeX. -% On the next ocurrences or on the next pdfTeX run, -% the pdf file is already available, so the -% conversion step is skipped. -% * Explicitly: \includegraphics{bild.eps} -% Each time the conversion program is called. +%\makeatletter +%\DeclareGraphicsRule{.gif}{png}{.png}{% +% `convert #1 \noexpand\Gin@base.png% +%} +%\makeatother %\end{verbatim} +%\end{quote} +% The file extension \xfile{.gif} can be added to the extension list that +% package \xpackage{graphics} searches if the file extension +% is not given in \cs{includegraphics}. +% The list can be set by \cs{GraphicsExtensions}. +% The following example shows another way by adding \xfile{.gif} to the +% list: +%\begin{quote} +%\begin{verbatim} +%\makeatletter +%\g@addto@macro\Gin@extensions{,.gif} +%\makeatother +%\end{verbatim} +%\end{quote} % % \StopEventually{ % } @@ -208,6 +296,11 @@ and the derived files % Reload check, especially if the package is not used with \LaTeX. % \begin{macrocode} \begingroup + \catcode44 12 % , + \catcode45 12 % - + \catcode46 12 % . + \catcode58 12 % : + \catcode64 11 % @ \expandafter\let\expandafter\x\csname ver@epstopdf.sty\endcsname \ifcase 0% \ifx\x\relax % plain @@ -234,6 +327,11 @@ and the derived files % Package identification: % \begin{macrocode} \begingroup + \catcode44 12 % , + \catcode45 12 % - + \catcode46 12 % . + \catcode58 12 % : + \catcode64 11 % @ \expandafter\ifx\csname ProvidesPackage\endcsname\relax \def\x#1#2#3[#4]{\endgroup \immediate\write-1{Package: #3 #4}% @@ -249,7 +347,7 @@ and the derived files \fi \expandafter\x\csname ver@epstopdf.sty\endcsname \ProvidesPackage{epstopdf}% - [2006/08/26 v1.3 Conversion with epstopdf on the fly (HO)] + [2007/04/26 v1.4 Conversion with epstopdf on the fly (HO)] % \end{macrocode} % % \subsection{Help macros for miniltx mode} @@ -343,7 +441,7 @@ and the derived files % \end{macrocode} % % Adding .eps at the end of the list of extensions, -% defined by \cs{DeclareGraphicsExtensions}. +% defined by \cs{GraphicsExtensions}. % \begin{macrocode} \@ifundefined{Gin@extensions}{% \def\Gin@extensions{.eps}% @@ -516,6 +614,10 @@ and the derived files % Check for \cs{write18} if available and print a warning % if the feature is not enabled. % \end{Version} +% \begin{Version}{2007/04/26 v1.4} +% \item +% Documentation rewritten and extended. +% \end{Version} % \end{History} % % \PrintIndex |