summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx')
-rw-r--r--Master/texmf-dist/source/latex/oberdiek/epstopdf.dtx160
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