summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex55
1 files changed, 22 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex b/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex
index 238bf937673..a89995f74b8 100644
--- a/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex
+++ b/Master/texmf-dist/doc/latex/pst2pdf/pst2pdf-doc.tex
@@ -16,7 +16,7 @@
\begin{document}
\title{\texttt{pst2pdf}}
-\subtitle{Running a PSTricks document with pdflatex;\\ \small v. 0.14}
+\subtitle{Running a PSTricks document with pdflatex;\\ \small v. 0.15}
\author{Herbert Vo\ss \\ Pablo Gonz\'{a}lez Luengo}
\docauthor{}
\date{\today}
@@ -26,20 +26,6 @@
\clearpage
-%\begin{abstract}
-%\noindent
-%\Lprog{pst2pdf} is a \Lprog{perl} \emph{script} for running a PSTricks document in a last run
-%with pdflatex.
-
-%\vfill\noindent
-%Thanks to:
-%Rolf Niepraschk
-
-%\end{abstract}
-
-%\clearpage
-
-
\section{Introduction}
\PST\ as \PS\ related package uses the programming language \PS\ for internal
calculations. This is an important advantage, because floating point arithmetic is no
@@ -58,7 +44,8 @@ main document is replaced by the created images.
\section{Requirements}
\subsection{Programs needed}
-\nxLprog{pst2pdf} needs \Lprog{pdftk}, \Lprog{ImageMagick} and \Lprog{poppler-utils} (or \Lprog{xpdf-utils}) for the process file in usual way. If you need a create .pdf image files (whitout related software) use single mode (see \ref{single}).
+\nxLprog{pst2pdf} needs \Lprog{pdftk}, \Lprog{ImageMagick}, \Lprog{pdftoppm} and \Lprog{pdftops}
+(from \Lprog{poppler-utils} or \Lprog{xpdf-utils}) for the process file. If you need a create .pdf image files (whitout \Lprog{pdftk}) use single mode (see \ref{single}).
\subsection{Preparating file}
The script scan the file for \Lenv{pspicture} and \Lenv{postscript} environments,
@@ -120,16 +107,17 @@ For \TeX Live users:
\nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--options}
\end{BDef}
+In this way \nxLprog{pst2pdf} creates a new file called \Larg{file-pst.tex} and copy all \Lenv{pspicture}
+and \Lenv{postscript} environments, then processed and create file-pdf.pdf and file-fig-1.pdf, file-fig-2.pdf, file-fig-\dots.pdf and file-fig-1.tex, file-fig-2.tex, file-fig-\dots.tex for all \Lenv{pspicture} and \Lenv{postscript} using \nxLprog{pdftk}.
\subsection{Single mode}
\label{single}
-If \nxLprog{pst2pdf} can not process a file, used the option \Loption{--single} this process will create the file, whiout pdftk
-(take a more time to create images files) by default create PDF files. For exampple:
+If you do not have \nxLprog{pdftk} use the option \Loption{--single} in this mode the files are processed separately (take a more time to create images files) by default create PDF files. For example:
\begin{BDef}
-\nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--pdf} \OptArg*{--single}
+\nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--single}
\end{BDef}
-create file-pdf.pdf and file-pst-1.pdf, file-pst-2.pdf, file-pst-\dots.pdf for all \Lenv{pspicture} and \Lenv{postscript} environments in the directory for the created images (see \ref{options}).
+create file-pdf.pdf and file-fig-1.pdf, file-fig-2.pdf, file-fig-\dots.pdf and file-fig-1.tex, file-fig-2.tex, file-fig-\dots.tex for all \Lenv{pspicture} and \Lenv{postscript} environments (see \ref{options}).
\section{Options}
\label{options}
@@ -143,19 +131,18 @@ The options listed in Table~\ref{perloptions} refer only to the \emph{script} an
\Loption{--Iext} & literal & .pdf & the extension for \Loption{PrependGraphicsExtensions}.\\
\Loption{--DPI} & integer & 75 & the dots per inch for a created \Lext{ppm} file.\\
\Loption{--Iscale} & real & 1 & the value for the option \Loption{scale} in \Lcs{includegraphics}.\\
-\Loption{--eps} & boolean & 0 & creates \Lext{eps} images files (need pdftops).\\
-\Loption{--ppm} & boolean & 0 & creates \Lext{ppm} images files (need pdftoppm).\\
-\Loption{--files} & boolean & 0 & creates \Lext{tex} for all images.\\
+\Loption{--eps} & boolean & 0 & creates \Lext{eps} images (need \Lprog{pdftops}).\\
+\Loption{--jpg} & boolean & 0 & creates \Lext{jpg} images (need \Lprog{pdftoppm} and \Lprog{ImageMagick}).\\
+\Loption{--png} & boolean & 0 & creates \Lext{png} images (need \Lprog{pdftoppm} and \Lprog{ImageMagick}).\\
\Loption{--verbose} & boolean & 1 & for a long \nxLprog{pst2pdf} log.\\
-\Loption{--norun} & boolean & 0 & create files, but no compile.\\
+\Loption{--PS2} & literal & empty & pass options to \nxLprog{ps2pdf}.\\
\Loption{--clear} & boolean & 0 & delete all temporary files.\\
\Loption{--help} & boolean & 1 & print help and exit.\\
\Loption{--single} & boolean & 0 & create images type (whitout pdftk).\\
-\Loption{--all} & boolean & 0 & generte all image type (.pdf, .eps, .tex).\\
-\Loption{--version} & boolean & 0 & print version and exit.\\
+\Loption{--all} & boolean & 0 & generte all image (.pdf, .eps, .jpg, .png, .tex) and clear.\\
\Loption{--license} & boolean & 0 & print license and exit.\\
\Loption{--xetex} & boolean & 0 & using \Lprog{xelatex} instead of \Lprog{latex} for the process.\\
-\Loption{--noImages} & boolean & 0 & generate files but no images (need \Loption{--norun}).\\
+\Loption{--noImages} & boolean & 0 & generate file-pdf.tex, but no images.\\
\Loption{--runBibTeX}& boolean & 0 & runs \Lprog{bibtex} \\
\Loption{--runBiber} & boolean & 0 & runs \Lprog{biber} if a file with extension \Lext{bcf} exists \\\bottomrule
\end{tabularx}
@@ -167,17 +154,19 @@ For Help in command line use:
\nxLprog{pst2pdf} \OptArg*{--help}
\end{BDef}
-\section{Other image format}
-If your need \Lext{png}, \Lext{jpg} or other image type use \nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{--ppm} , than move to images dir and use \nxLprog{mogrify} command (from \Lprog{ImageMagick}), for examples:\\
+\section{Image format}
+\nxLprog{pst2pdf} can create image files in the formats: \Lext{pdf}, \Lext{eps}, \Lext{jpg} and \Lext{png}. If you need to create other image formats use \nxLprog{pst2pdf} \Larg{file.tex} \OptArg*{-png} without the option
+\OptArg*{-clear} , than move to images dir and use \nxLprog{mogrify} command (from \Lprog{ImageMagick}), for examples:\\
\begin{BDef}
-\nxLprog{mogrify} -format \OptArg*{png *.ppm}
+\nxLprog{mogrify} -format gif \OptArg*{*.ppm}
\end{BDef}
-generate PNG images files and \\
+generate \Lext{gif} images files and \\
\begin{BDef}
-\nxLprog{mogrify} -format \OptArg*{jpg *.ppm}
+\nxLprog{mogrify} -format tiff \OptArg*{*.ppm}
\end{BDef}
-generate JPG images files.
+generate \Lext{tiff} images files.
+\enlargethispage{1cm}
\bgroup
\raggedright
\nocite{*}