summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx')
-rw-r--r--Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx220
1 files changed, 114 insertions, 106 deletions
diff --git a/Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx b/Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx
index 6b8e3140238..fd3d403a1bd 100644
--- a/Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx
+++ b/Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx
@@ -1,6 +1,6 @@
% \iffalse meta-comment
%
-% Copyright (C) 2005--2006
+% Copyright (C) 2005--2008
% Rolf Niepraschk, <Rolf.Niepraschk@ptb.de>
% Hubert Gaesslein
% --------------------------------------------------------------
@@ -24,7 +24,7 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{pst-pdf}
%<*package>
- [2007/06/04 v1.1p PS graphics for pdfLaTeX (RN,HjG)]
+ [2008/02/24 v1.1q PS graphics for pdfLaTeX (RN,HjG)]
%</package>
%
%<*driver>
@@ -50,7 +50,7 @@
%</driver>
% \fi
%
-% \CheckSum{849}
+% \CheckSum{861}
%
% \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
@@ -92,7 +92,7 @@
% \changes{v1.1c}{2005/04/17}{New package option ``tightpage'' added. (RN)}
% \changes{v1.1k}{2006/02/10}{New environment pst-pdf-defs: Support for
% PSTricks environment ``psmatrix'' inside user definitions. (RN,HjG)}
-% \changes{v1.1m}{2006/03/10}{Merge english and german version of the
+% \changes{v1.1m}{2006/03/10}{Merge english and german version of the
% documentation. (RN)}
% \GetFileInfo{pst-pdf.dtx}
%
@@ -135,13 +135,13 @@
%
% \newcommand*\META[1]{\meta{\normalfont#1}}
% \newcommand*\TorF{\META{true\textbar false}}
-%
-% \newif\ifGERMAN \GERMANfalse
+%
+% \newif\ifGERMAN \GERMANfalse
% \newif\ifENGLISH \ENGLISHfalse
% \iflanguage{ngerman}{\GERMANtrue}{%
% \iflanguage{german}{\GERMANtrue}{\GERMANfalse}}
% \iflanguage{english}{\ENGLISHtrue}{\ENGLISHfalse}
-%
+%
% ^^A ----------------------------------------------------------
%
% \ifGERMAN
@@ -153,7 +153,7 @@
% corresponds to \textsf{pst-pdf}~\fileversion, dated \filedate.
% Thanks to Peter Dyballa for the translation.}}
% \fi
-%
+%
% \author{%
% Rolf Niepraschk\thanks{\texttt{Rolf.Niepraschk@ptb.de}}
% \and
@@ -165,12 +165,12 @@
% \ifGERMAN
% \section{Einleitung}
%
-% Das Paket \pkgname{pst-pdf} vereinfacht die Verwendung von
-% PSTricks-Grafiken und anderem \PS-Code in PDF-Dokumenten.
-% \"Ahnlich wie beim Erstellen des Literaturverzeichnisses mit bib\TeX{}
-% werden zus\"atzlich externe Programme aufgerufen. Sie dienen in
-% diesem Fall dazu, eine PDF-Datei, die s\"amtliche Grafiken
-% enth\"alt, zu erzeugen. Ihr Inhalt wird im endg\"ultigen Dokument
+% Das Paket \pkgname{pst-pdf} vereinfacht die Verwendung von
+% PSTricks-Grafiken und anderem \PS-Code in PDF-Dokumenten.
+% \"Ahnlich wie beim Erstellen des Literaturverzeichnisses mit bib\TeX{}
+% werden zus\"atzlich externe Programme aufgerufen. Sie dienen in
+% diesem Fall dazu, eine PDF-Datei, die s\"amtliche Grafiken
+% enth\"alt, zu erzeugen. Ihr Inhalt wird im endg\"ultigen Dokument
% statt des urspr\"unglichen \PS-Codes eingef\"ugt.
% \fi
%
@@ -196,64 +196,64 @@
%
% \ifGERMAN
% \subsection{Paketoptionen}
-%
-% \begin{optlist}
-%
-% \item[active] Aktiviert den Extraktionsmodus (DVI-Ausgabe).
-% Die explizite Angabe ist normalerweise unn\"otig (Standard im
+%
+% \begin{optlist}
+%
+% \item[active] Aktiviert den Extraktionsmodus (DVI-Ausgabe).
+% Die explizite Angabe ist normalerweise unn\"otig (Standard im
% \LaTeX-Modus).
%
-% \item[inactive] Keine besonderen Aktionen; es werden nur die
-% Pakete \pkgname{pstricks} und \pkgname{graphicx} geladen
-% (Standard bei Verwendung von V\TeX). Kann dazu benutzt werden,
-% um das Dokument mit \LaTeX\ in eine DVI-Datei zu wandeln und
-% dabei die automatische Verwendung des Extraktionsmodus' zu vermeiden.
-%
-% \item[pstricks] Das Paket \pkgname{pstricks} wird geladen
+% \item[inactive] Keine besonderen Aktionen; es werden nur die
+% Pakete \pkgname{pstricks} und \pkgname{graphicx} geladen
+% (Standard bei Verwendung von V\TeX). Kann dazu benutzt werden,
+% um das Dokument mit \LaTeX\ in eine DVI-Datei zu wandeln und
+% dabei die automatische Verwendung des Extraktionsmodus' zu vermeiden.
+%
+% \item[pstricks] Das Paket \pkgname{pstricks} wird geladen
% (Standard).
-%
-% \item[nopstricks] Das Paket \pkgname{pstricks} wird nicht
-% geladen. Wird sp\"ater festgestellt, dass \pkgname{pstricks} doch
-% noch anderweitig geladen wurde, wird die Umgebung |pspicture|
-% nachtr\"aglich in der Weise behandelt, als w\"are die Option
+%
+% \item[nopstricks] Das Paket \pkgname{pstricks} wird nicht
+% geladen. Wird sp\"ater festgestellt, dass \pkgname{pstricks} doch
+% noch anderweitig geladen wurde, wird die Umgebung |pspicture|
+% nachtr\"aglich in der Weise behandelt, als w\"are die Option
% ``pstricks'' doch angegeben worden.
-%
-% \item[draft] Im pdf\LaTeX-Modus werden aus der
+%
+% \item[draft] Im pdf\LaTeX-Modus werden aus der
% Containerdatei eingef\"ugte Grafiken nur als Rahmen dargestellt.
-%
-% \item[final] Im pdf\LaTeX-Modus werden aus der
-% Containerdatei eingef\"ugte Grafiken vollst\"andig
+%
+% \item[final] Im pdf\LaTeX-Modus werden aus der
+% Containerdatei eingef\"ugte Grafiken vollst\"andig
% dargestellt (Standard).
-%
-% \item[tightpage] Die Abmessung Grafiken in der Containerdatei
+%
+% \item[tightpage] Die Abmessung Grafiken in der Containerdatei
% entsprechen denen der zugeh\"origen \TeX-Boxen (Standard).
-%
-% \item[notightpage]
-% Die Abmessung der zur Grafik geh\"orenden \TeX-Box ist manchmal
-% nicht korrekt, da \PS-Anweisungen auch au{\ss}erhalb der Box
-% zeichnen k\"onnen. Die Option ``notightpage'' f\"uhrt dazu, dass die
-% Grafiken in der Containerdatei mindestens die Gr\"o{\ss}e des
-% gesamten Blattes einnehmen. Um die Grafiken
-% im sp\"ateren pdf\LaTeX-Lauf verwenden zu k\"onnen, muss die
-% Containerdatei nachbearbeitet werden, so dass die Gr\"o{\ss}e der
-% Grafiken auf die der sichtbaren Bestandteile reduziert ist. Dazu
+%
+% \item[notightpage]
+% Die Abmessung der zur Grafik geh\"orenden \TeX-Box ist manchmal
+% nicht korrekt, da \PS-Anweisungen auch au{\ss}erhalb der Box
+% zeichnen k\"onnen. Die Option ``notightpage'' f\"uhrt dazu, dass die
+% Grafiken in der Containerdatei mindestens die Gr\"o{\ss}e des
+% gesamten Blattes einnehmen. Um die Grafiken
+% im sp\"ateren pdf\LaTeX-Lauf verwenden zu k\"onnen, muss die
+% Containerdatei nachbearbeitet werden, so dass die Gr\"o{\ss}e der
+% Grafiken auf die der sichtbaren Bestandteile reduziert ist. Dazu
% kann z.\,B. das Programm |pdfcrop|\footnote{%
-% CTAN:~\url{support/pdfcrop/}} dienen. Die Anwendung dieses Verfahrens
-% kann die Angabe der Option ``trim'' er\"ubrigen (siehe
+% CTAN:~\url{support/pdfcrop/}} dienen. Die Anwendung dieses Verfahrens
+% kann die Angabe der Option ``trim'' er\"ubrigen (siehe
% Abschnitt~\ref{sec:copt}).
-%
+%
% \item[displaymath]
-% Es werden zus\"atzlich die mathematischen Umgebungen
-% \env{displaymath}, \env{eqnarray} und \env{\$\$} extrahiert und im
-% pdf-Modus
-% als Grafik eingefügt. So k\"onnen zus\"atzliche PSTricks-Erg\"anzungen
-% leicht dem Inhalt dieser Umgebungen zugef\"ugt werden. (Frage: Wie
+% Es werden zus\"atzlich die mathematischen Umgebungen
+% \env{displaymath}, \env{eqnarray} und \env{\$\$} extrahiert und im
+% pdf-Modus
+% als Grafik eingefügt. So k\"onnen zus\"atzliche PSTricks-Erg\"anzungen
+% leicht dem Inhalt dieser Umgebungen zugef\"ugt werden. (Frage: Wie
% verhalten sich die AMS\LaTeX-Umgebungen?)
-%
-% \item[\meta{other}] Alle anderen Optionen werden an das Paket
-% \pkgname{pstricks} weitergereicht.
%
-% \end{optlist}
+% \item[\meta{other}] Alle anderen Optionen werden an das Paket
+% \pkgname{pstricks} weitergereicht.
+%
+% \end{optlist}
% \fi
% \ifENGLISH
% \subsection{Package options}
@@ -312,10 +312,10 @@
%
% Die folgende Tabelle zeigt den Ablauf, der n\"otig ist, um ein
% PDF-Dokument mit \PS-Grafiken zu erzeugen\footnote{%
-% Die Shell-Scripte |ps4pdf| bzw. |ps4pdf.bat| f\"uhren alle angegebenen
-% Programmaufrufe automatisch aus.}. Im Vergleich dazu ist der
+% Die Shell-Scripte |ps4pdf| bzw. |ps4pdf.bat| f\"uhren alle angegebenen
+% Programmaufrufe automatisch aus.}. Im Vergleich dazu ist der
% analoge Ablauf f\"ur Literaturverzeichnisse angegeben.\bigskip
-%
+%
% \newcolumntype{P}[1]{>{\mbox{}\raggedright}p{#1}}
% \noindent
% \begin{tabular}[t]{@{}P{.65\linewidth}@{}P{.35\linewidth}@{}}
@@ -327,20 +327,20 @@
% |latex document.tex| \tabularnewline
% |dvips -o document-pics.ps document.dvi| \tabularnewline
% |ps2pdf document-pics.ps|
-% &
+% &
% |bibtex document.aux|
% \tabularnewline\midrule
% |pdflatex document.tex| & |pdflatex document.tex|
% \end{tabular}\bigskip
-%
-% Bei der Erzeugung wird nur
+%
+% Bei der Erzeugung wird nur
% Code ber\"ucksichtigt, der sich innerhalb der Umgebungen |pspicture|
-% oder |postscript| befindet. Ebenfalls werden \PS-Grafiken, die
-% als Parameter von \cmd{\includegraphics} angegeben wurden, der
+% oder |postscript| befindet. Ebenfalls werden \PS-Grafiken, die
+% als Parameter von \cmd{\includegraphics} angegeben wurden, der
% Containerdatei hinzugef\"ugt.
% Der Name dieser Datei ist standardm\"a{\ss}ig
% \meta{\cmd{\jobname}}|-pics.pdf|.
-% Er kann durch Umdefinieren des Makros
+% Er kann durch Umdefinieren des Makros
% \cmd{\PDFcontainer} ge\"andert werden. \medskip
% \fi
% \ifENGLISH
@@ -379,38 +379,38 @@
%
% \ifGERMAN
% \subsection{Nutzeranweisungen}
-%
+%
% \DescribeEnv{pspicture}
% \indent\cmd{\begin}|{pspicture}|\oarg{keys}%
% \parg{x0,x1}\parg{y0,y1} \dots\cmd{\end}|{pspicture}|
% \par\noindent
-% Die |pspicture|-Umgebung steht zur Verf\"ugung, wenn nicht die Option
-% ``|nopstricks|'' angegeben wurde. Sie wird so wie in PSTricks \"ublich
-% verwendet. Im pdf\LaTeX-Modus wird ihr Inhalt nur dann dargestellt,
-% wenn vorher die Containerdatei erzeugt wurde.
+% Die |pspicture|-Umgebung steht zur Verf\"ugung, wenn nicht die Option
+% ``|nopstricks|'' angegeben wurde. Sie wird so wie in PSTricks \"ublich
+% verwendet. Im pdf\LaTeX-Modus wird ihr Inhalt nur dann dargestellt,
+% wenn vorher die Containerdatei erzeugt wurde.
% \medskip
%
% \DescribeEnv{postscript}
% \cmd{\begin}|{postscript}|\oarg{keys} \dots\cmd{\end}|{postscript}|
% \par\noindent
-% Die |postscript|-Umgebung kann beliebigen Code mit Ausnahme von
-% Gleitumgebungen aufnehmen. Im pdf\LaTeX-Modus wird ihr Inhalt
-% ebenfalls der Containerdatei entnommen. Ist diese Datei nicht
-% vorhanden, wird -- anders als bei der |pspicture|-Umgebung -- der
+% Die |postscript|-Umgebung kann beliebigen Code mit Ausnahme von
+% Gleitumgebungen aufnehmen. Im pdf\LaTeX-Modus wird ihr Inhalt
+% ebenfalls der Containerdatei entnommen. Ist diese Datei nicht
+% vorhanden, wird -- anders als bei der |pspicture|-Umgebung -- der
% sp\"ater ben\"otigte Platz m\"oglicherweise nicht korrekt frei gehalten.
% \medskip
-%
+%
% \DescribeMacro{\includegraphics}
-% \cmd{\includegraphics}\oarg{keys}\marg{filename}
+% \cmd{\includegraphics}\oarg{keys}\marg{filename}
% \par\noindent
% Wie in \pkgname{graphics}/\pkgname{graphicx} definiert zu verwenden.
-% Zus\"atzlich ist es nun m\"oglich, auch im pdf\LaTeX-Modus
+% Zus\"atzlich ist es nun m\"oglich, auch im pdf\LaTeX-Modus
% EPS-Dateien als Argument anzugeben und ihren Inhalt darzustellen. Er
% wird dazu ebenfalls der Containerdatei entnommen.
% \medskip
-%
+%
% \newcommand*\ooarg[1]{{\ttfamily<}\meta{#1}{\ttfamily>}}
-%
+%
% \DescribeMacro{\includegraphicx}
% \cmd{\includegraphicx}\oarg{keys}\parg{pfxadd}\ooarg{ovpfgd}\oarg{ovpbgd}%
% \marg{filename}
@@ -422,21 +422,21 @@
% \cmd{\savepicture}\marg{name}
% \par\noindent
% Die zuletzt ausgegebene Grafik (Ergebnisse der Umgebungen |pspicture|,
-% |postscript| und der \cmd{\includegraphics}-Anweisungen mit
-% \PS-Dateien) wird unter dem als Parameter \"ubergebenen
-% Namen gespeichert.
-% \medskip
-%
+% |postscript| und der \cmd{\includegraphics}-Anweisungen mit
+% \PS-Dateien) wird unter dem als Parameter \"ubergebenen
+% Namen gespeichert.
+% \medskip
+%
% \DescribeMacro{\usepicture}
% \cmd{\usepicture}\oarg{keys}\marg{name}
% \par\noindent
-% Die zuvor mit \cmd{\savepicture} gespeicherte Grafik wird
-% ausgegeben. Der optionale Parameter entpricht dem bei der Anweisung
+% Die zuvor mit \cmd{\savepicture} gespeicherte Grafik wird
+% ausgegeben. Der optionale Parameter entpricht dem bei der Anweisung
% \cmd{\includegraphics} m\"oglichen.
-% \medskip
+% \medskip
%
% \DescribeEnv{pst-pdf-defs}
-% \cmd{\begin}\texttt{\{pst-pdf-defs\}} \dots
+% \cmd{\begin}\texttt{\{pst-pdf-defs\}} \dots
% \cmd{\end}\texttt{\{pst-pdf-defs\}}
% \par\noindent
% Sollen eigene Makros oder Umgebungen definiert werden, die das Zeichen
@@ -502,7 +502,7 @@
% \medskip
%
% \DescribeEnv{pst-pdf-defs}
-% \cmd{\begin}\texttt{\{pst-pdf-defs\}} \dots
+% \cmd{\begin}\texttt{\{pst-pdf-defs\}} \dots
% \cmd{\end}\texttt{\{pst-pdf-defs\}}
% \par\noindent
% Sollen eigene Makros oder Umgebungen definiert werden, die das Zeichen
@@ -510,7 +510,7 @@
% Definitionen von der Umgebung |pst-pdf-defs| umschlossen werden.
% \medskip
% \fi
-%
+%
% \ifGERMAN
% \subsection{Command options} \label{sec:copt}
% Das Verhalten der Anweisungen \cmd{\includegraphics}, \cmd{\usepicture}
@@ -546,8 +546,8 @@
%
% Alle Parameter k\"onnen auch global per
% \cmd{\setkeys}|{Gin}|\marg{key=value} gesetzt werden.
-% \fi
-%
+% \fi
+%
% \ifENGLISH
% \subsection{Command options} \label{sec:copt}
% The behaviour of the \cmd{\includegraphics} and \cmd{\usepicture}
@@ -578,7 +578,7 @@
% All parameters can be set globally as in
% \cmd{\setkeys}|{Gin}|\marg{key=value}.
% \fi
-%
+%
% \bigskip \pagebreak[2]
%
% \StopEventually{}
@@ -814,16 +814,18 @@
% exactly one page in the \cmd{\PDFcontainer} file. The \TeX\ compiler with
% DVI output and the package option ``|active|'' both force this mode.
% \fi
-% \changes{v1.1n}{2006/07/14}{\cmd{\nofiles} added (suggestion of Torsten
+% \changes{v1.1n}{2006/07/14}{\cmd{\nofiles} added (suggestion of Torsten
% Bronger).}
-% \changes{v1.1p}{2007/06/04}{\cmd{\nofiles} makes \cmd{\makeindex} and
-% \cmd{\makeglossary} to \cmd{\relax}. \cmd{\@empty} is better
-% because of later \cmd{\renewcommand}'s}.
+% \changes{v1.1p}{2007/06/04}{\cmd{\nofiles} makes \cmd{\makeindex} and
+% \cmd{\makeglossary} to \cmd{\relax}. \cmd{\@empty} is better
+% because of later \cmd{\renewcommand}'s.}
+% \changes{v1.1q}{2008/02/17}{\cmd{\overfullrule} must not be > 0.}
% \begin{macrocode}
\PackageInfo{pst-pdf}{%
MODE: \ppf@TeX@mode\space (dvi -- extraction mode)}
\nofiles
\let\makeindex\@empty \let\makeglossary\@empty
+ \AtBeginDocument{\overfullrule=\z@}%
\if@ppf@PST@used\RequirePackage{pstricks}\fi
\RequirePackage[active,dvips,tightpage]{preview}[2005/01/29]%
\newcommand*\ppf@PreviewBbAdjust{}
@@ -1023,11 +1025,14 @@
% Prevent multiple test-wise setting of table contents by ``tabularx''.
% \fi
% \changes{v1.1c}{2005/04/17}{Special support for ``tabularx''. (RN)}
+% \changes{v1.1q}{2008/02/17}{Problem with ``tabularx'' and
+% ``threeparttabel'' solved. (RN)}
% \begin{macrocode}
\@ifundefined{tabularx}{}{%
- \def\tabularx#1#2{\tabular{#2}}%
\newcolumntype{X}{c}%
- \let\endtabularx=\endtabular}%
+ \expandafter\let\expandafter\tabularx\csname tabular*\endcsname
+ \expandafter\let\expandafter\endtabularx\csname endtabular*\endcsname
+ }%
% \end{macrocode}
% \changes{v1.1l}{2006/02/18}{Support for the package ``psfragx''. (RN)}
% \ifGERMAN
@@ -1206,9 +1211,12 @@
% \fi
% \changes{v1.1b}{2005/04/09}{Ignore the call of
% \cmd{\nofiles} inside of \pkgname{preview}. (RN)}
+% \changes{v1.1p1}{2007/07/27}{\cmd{\let}\cmd{\output}\cmd{\@gobble}
+% before loading of ``preview'' added. (RN)}
% \begin{macrocode}
\newtoks\ppf@temptoken
\ppf@temptoken\expandafter{\the\output}%
+ \let\output\@gobble
\let\ppf@nofiles\nofiles \let\nofiles\relax
\RequirePackage[active]{preview}[2005/01/29]%
\let\shipout=\pr@shipout \let\nofiles\ppf@nofiles
@@ -1703,14 +1711,14 @@
%
% \begin{environment}{pst-pdf-defs}
% \ifGERMAN
-% Umgebung, die keine eigene Gruppe aufmacht. Innerhalb der Umgebung
+% Umgebung, die keine eigene Gruppe aufmacht. Innerhalb der Umgebung
% bekommt das Zeichen |&| den Kategoriecode "`other"'. Gedacht f\"ur
% eigene Makros, die z.\,B.\ eine \env{psmatrix} enthalten.
% (Einen ``Hook'' verwenden, falls andere Zeichen auch noch ben\"otigt
% werden!?)
% \fi
% \ifENGLISH
-% Umgebung, die keine eigene Gruppe aufmacht. Innerhalb der Umgebung
+% Umgebung, die keine eigene Gruppe aufmacht. Innerhalb der Umgebung
% bekommt das Zeichen |&| den Kategoriecode "`other"'. Gedacht f\"ur
% eigene Makros, die z.\,B.\ eine \env{psmatrix} enthalten.
% (Einen ``Hook'' verwenden, falls andere Zeichen auch noch ben\"otigt
@@ -1761,7 +1769,7 @@
%
% \Finale
%\endinput
-%
+%
% And here comes the example document ...
%<*example>
%% Process this file with the scripts `ps4pdf' or `ps4pdf.bat' or call