diff options
Diffstat (limited to 'Master/texmf-dist/source')
-rw-r--r-- | Master/texmf-dist/source/generic/pst-pdf/pst-pdf.dtx | 220 |
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 |