summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pstricks
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-10-04 23:04:03 +0000
committerKarl Berry <karl@freefriends.org>2017-10-04 23:04:03 +0000
commitd47159a7f43a28a563b1f7c94f982e3f57945395 (patch)
tree4c7924ce3e34e9cf83978bf0bf3e3b3bdc89849b /Master/texmf-dist/doc/generic/pstricks
parentb3a6a312f02486563f90e24dbb7555d63d54c31a (diff)
pstricks (4oct17)
git-svn-id: svn://tug.org/texlive/trunk@45464 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pstricks')
-rw-r--r--Master/texmf-dist/doc/generic/pstricks/Makefile95
-rw-r--r--Master/texmf-dist/doc/generic/pstricks/pst-docfull.pdfbin565330 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pstricks/pst-news17.pdfbin75093 -> 75819 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pstricks/pst-news17.tex131
-rw-r--r--Master/texmf-dist/doc/generic/pstricks/pst-quickref.pdfbin30070 -> 0 bytes
5 files changed, 115 insertions, 111 deletions
diff --git a/Master/texmf-dist/doc/generic/pstricks/Makefile b/Master/texmf-dist/doc/generic/pstricks/Makefile
deleted file mode 100644
index 0b4f5519d33..00000000000
--- a/Master/texmf-dist/doc/generic/pstricks/Makefile
+++ /dev/null
@@ -1,95 +0,0 @@
-# `Makefile' for `pst-news.pdf', hv, 2007/03/17
-
-.SUFFIXES : .tex .ltx .dvi .ps .pdf .eps
-
-PACKAGE = pst-news$(shell date +%y)
-
-MAIN = $(PACKAGE)
-
-BASE = pstricks-base
-
-TDSBASE = pstricks
-
-LATEX = latex
-
-TDS = ~/PSTricks/PSTricks-TDS
-
-ARCHNAME = $(MAIN)-$(shell date +%y%m%d)
-
-ARCHFILES = $(PACKAGE).sty $(PACKAGE).tex $(PACKAGE).pro $(MAIN).tex README Changes Makefile
-
-all : doc clean
-doc: $(MAIN).pdf
-
-$(MAIN).pdf : $(MAIN).ps
- GS_OPTIONS=-dAutoRotatePages=/None ps2pdf $<
-
-$(MAIN).ps : $(MAIN).dvi
- dvips $<
-
-$(MAIN).dvi : $(MAIN).tex
- $(LATEX) $<
- $(LATEX) $<
- if ! test -f $(basename $<).glo ; then touch $(basename $<).glo; fi
- if ! test -f $(basename $<).idx ; then touch $(basename $<).idx; fi
- makeindex -s gglo.ist -t $(basename $<).glg -o $(basename $<).gls \
- $(basename $<).glo
- makeindex -t $(basename $<).ilg -o $(basename $<).ind \
- $(basename $<).idx
- biber $(basename $<)
- $(LATEX) $<
- $(LATEX) $<
-
-clean :
- $(RM) $(addprefix $(MAIN), .log .aux .glg .glo .gls .ilg .idx .ind .tmp .toc .out .blg .Roessler .bbl )
- $(RM) $(addprefix $(MAIN), .dvi .ps .bcf .run.xml)
-
-veryclean : clean
- $(RM) $(addprefix $(MAIN), .pdf .bbl .blg)
-
-arch :
- zip $(ARCHNAME).zip $(ARCHFILES)
-
-tds:
-#################### base #########################
- cp -u ../config/* ../.base/$(BASE)/config/
-#
- cp -u ../Changes ../.base/$(BASE)/
- cp -u pst-doc.* ../.base/$(BASE)/doc/
- cp -u PSTricks.bib* ../.base/$(BASE)/doc/
- cp -u pst-news* ../.base/$(BASE)/doc/
- cp -u pst-user* ../.base/$(BASE)/doc/
- cp -u *.sty ../.base/$(BASE)/doc/
- cp -u pstricks-* ../.base/$(BASE)/doc/
- cp -u test* ../.base/$(BASE)/doc/
- cp -u images/* ../.base/$(BASE)/doc/images/
-#
- cp -u ../dvips/* ../.base/$(BASE)/dvips/
- cp -u ../generic/* ../.base/$(BASE)/generic/
- cp -u ../latex/* ../.base/$(BASE)/latex/
- cp -u ../README ../.base/$(BASE)/
-#
-#################### TDS #########################
- cp -u ../Changes $(TDS)/doc/generic/$(TDSBASE)/
-# cp -u README $(TDS)/doc/generic/$(TDSBASE)/
- cp -u $(MAIN).pdf $(TDS)/doc/generic/$(TDSBASE)/
-#
-# cp -u ../latex/Changes $(TDS)/tex/latex/$(TDSBASE)/
- cp -u ../latex/* $(TDS)/tex/latex/$(TDSBASE)/
-#
-# cp -u ../generic/Changes $(TDS)/tex/generic/$(TDSBASE)/
- cp -u ../generic/* $(TDS)/tex/generic/$(TDSBASE)/
-#
-# cp -u ../dvips/Changes $(TDS)/dvips/$(TDSBASE)/
-# cp -u ../dvips/$(BASE).pro $(TDS)/dvips/$(TDSBASE)/
-# cp -u ../dvips/$(BASE)97.pro $(TDS)/dvips/$(TDSBASE)/
- cp -u ../dvips/*.pro $(TDS)/dvips/$(TDSBASE)/
-#
-# cp -u Changes $(TDS)/source/$(TDSBASE)/
- cp -u $(MAIN).tex $(TDS)/source/$(TDSBASE)/
-# cp -u $(MAIN).bib $(TDS)/source/$(TDSBASE)/
- cp -u Makefile $(TDS)/source/$(TDSBASE)/
-
- cp -u ../dvips/*.pro ~/Links/dvips-local/
-
-# EOF
diff --git a/Master/texmf-dist/doc/generic/pstricks/pst-docfull.pdf b/Master/texmf-dist/doc/generic/pstricks/pst-docfull.pdf
deleted file mode 100644
index 6666f0a0244..00000000000
--- a/Master/texmf-dist/doc/generic/pstricks/pst-docfull.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pstricks/pst-news17.pdf b/Master/texmf-dist/doc/generic/pstricks/pst-news17.pdf
index 2a991b265ab..9360b231c20 100644
--- a/Master/texmf-dist/doc/generic/pstricks/pst-news17.pdf
+++ b/Master/texmf-dist/doc/generic/pstricks/pst-news17.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pstricks/pst-news17.tex b/Master/texmf-dist/doc/generic/pstricks/pst-news17.tex
index 563c5943ec8..8d0669e3d0f 100644
--- a/Master/texmf-dist/doc/generic/pstricks/pst-news17.tex
+++ b/Master/texmf-dist/doc/generic/pstricks/pst-news17.tex
@@ -1,12 +1,9 @@
-%% $Id: pst-news17.tex 444 2017-04-19 10:55:35Z herbert $
+%% $Id: pst-news17.tex 616 2017-10-04 16:14:42Z herbert $
\documentclass[11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small,
headinclude=false,footinclude=false,twoside]{pst-doc}
\listfiles
\let\Lfile\LFile
\usepackage[utf8]{inputenc}
-\usepackage{pstricks}
-\let\pstricksFV\fileversion
-\let\pstricksFD\filedate
\usepackage{pst-node}
\let\pstnodeFV\fileversion
\let\pstnodeFD\filedate
@@ -38,25 +35,102 @@ basic package \nxLFile{pstricks}}
\clearpage
\part{\texttt{pstricks} -- package}
-\iffalse
%--------------------------------------------------------------------------------------
\section{\texttt{pstricks.sty} -- \texttt{pstricks-pdf.sty}}
%--------------------------------------------------------------------------------------
+
+There is now a new optional argument for the package: \Loption{psfonts}. If it is
+enabled PSTricks will use the original PostScript fonts like Helvetica, Times, \ldots.
+The default is to use the URW fonts (Nimbus Roman, Nimbus Sans, \ldots) which are embedded by default!
+The PostScript fonts are only embedded if present on your system.
%--------------------------------------------------------------------------------------
-\section{\texttt{pstricks-pdf.sty}}
+\section{\texttt{pstricks-tex.tex}}
%--------------------------------------------------------------------------------------
-This package allows to use pstricks code with \Lprog{pdflatex} or \Lprog{lualatex}.
-All optional arguments of package \LPack{auto-pst-pdf} are possible. In difference to
-this package \LPack{pstricks-pdf} has no problems with running \Lprog{lualatex}.
-Internally \Lprog{lualatex} starts \Lprog{xelatex} for creating the environments
-\Lenv{pspicture} as single images.
+This package collects all additional latex macros which must be definied
+when running PSTricks with tex. They all moved from the base \texttt{pstricks.tex} into
+this new file.
-\fi
%--------------------------------------------------------------------------------------
-\section{\texttt{pstricks.tex} (\pstricksFV -- \pstricksFD)}
+\section{\texttt{pstricks.tex} (v. 2.76 -- 2017/09/17)}
%--------------------------------------------------------------------------------------
+
+
+\subsection{PostScript Fonts}
+This version of PSTricks uses the Ghostscript fonts from URW instead of the
+original base 14 fonts of PostScript. For example: instead of Helvetica we use
+NimbusSanL-Regu. The URW fonts are always embedded in the created ps or pdf output.
+This is not the default for the PostScript fonts. You change this setting with the optional
+argument to \LPack{pstricks.sty}.
+
+
+\subsection{Error message}
+
+Using PSTricks with \Lprog{pdflatex} will work only when using package
+\LPack{auto-pst-pdf} and running the \TeX-file with
+
+\begin{verbatim}
+pdflatex -shell-escape <file>
+\end{verbatim}
+
+otherwise you'll get an error message which was misleading in the past:
+
+\begin{verbatim}
+[...]
+! Undefined control sequence.
+<recently read> \c@lor@to@ps
+\end{verbatim}
+
+This changes now to
+
+
+\begin{verbatim}
+[...]
+! Undefined control sequence.
+\c@lor@to@ps ->\PSTricks
+ _Not_Configured_For_This_Format
+\end{verbatim}
+
+\subsection{Random colors}
+There are now four predefined random ''colors``:
+
+\begin{verbatim}
+ \definecolor[ps]{randomgray}{gray}{Rand}%
+ \definecolor[ps]{randomrgb}{rgb}{Rand Rand Rand}%
+ \definecolor[ps]{randomcmyk}{cmyk}{Rand Rand Rand Rand}%
+ \definecolor[ps]{randomhsb}{hsb}{Rand Rand Rand}%
+\end{verbatim}
+
+\begin{LTXexample}[pos=t]
+\begin{pspicture}(10,5)
+\multido{\rA=0.0+0.1}{50}{\psline[linecolor=randomgray,linewidth=1mm](0,\rA)(10,\rA)}
+\end{pspicture}
+\end{LTXexample}
+
+\begin{LTXexample}[pos=t]
+\begin{pspicture}(10,5)
+\multido{\rA=0.0+0.1}{50}{\psline[linecolor=randomrgb,linewidth=1mm](0,\rA)(10,\rA)}
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[pos=t]
+\begin{pspicture}(10,5)
+\multido{\rA=0.0+0.1}{50}{\psline[linecolor=randomcmyk,linewidth=1mm](0,\rA)(10,\rA)}
+\end{pspicture}
+\end{LTXexample}
+
+
+\begin{LTXexample}[pos=t]
+\begin{pspicture}(10,5)
+\multido{\rA=0.0+0.1}{50}{\psline[linecolor=randomhsb,linewidth=1mm](0,\rA)(10,\rA)}
+\end{pspicture}
+\end{LTXexample}
+
+
+The random counter can be initialized with \verb|\pstVerb{rrand srand}|.
+
\subsection{refangle}
This version fixes a bug with \verb|pst@refangle| which is used inside PostScript.
@@ -89,12 +163,12 @@ area of the \Lenv{pspicture} coordinates is seen by a rectangle (only for \LaTe
\end{LTXexample}
-\subsection{\Lcs{newpsstyle}}
+\subsection{\nxLcs{newpsstyle}}
The command \Lcs{newpsstyle} has a new syntax:
\begin{BDef}
-\Lcs{newpssytle}\OptArg{package name}\Largb{name}\Largb{definitions}
+\Lcs{newpsstyle}\OptArg{package name}\Largb{name}\Largb{definitions}
\end{BDef}
For example
@@ -105,6 +179,32 @@ For example
\end{verbatim}
+%--------------------------------------------------------------------------------------
+\section{\texttt{pstricks.pro}}
+%--------------------------------------------------------------------------------------
+
+A full circle has by default an angle of 360 degrees.
+Setting the circle with \Lcs{degrees}\Largs{17} to another value doesn't work for the
+PostScript function \texttt{PtoC} (Polat to Cartesian -- $(r,\phi)\rightarrow (x,y)$).
+Now there is a \texttt{PtoCrel} for the new definition
+which now takes
+the setting of \Lcs{pst@angleunit} into account.
+
+\bigskip
+\begin{LTXexample}[pos=t]
+\degrees[16]
+\begin{pspicture}[showgrid](-2,-2)(2,2)
+\psline[linecolor=blue](!1.8 2 PtoCrel)% 45 degrees
+\end{pspicture}
+\end{LTXexample}
+
+The command \Lcs{framed} was build by clockwise line sequence. Now it is the
+other way round to get the same behaviour as for all other commands
+with closed lines.
+
+
+
+
\clearpage
\nocite{*}
\printbibliography
@@ -114,4 +214,3 @@ For example
\end{document}
-
diff --git a/Master/texmf-dist/doc/generic/pstricks/pst-quickref.pdf b/Master/texmf-dist/doc/generic/pstricks/pst-quickref.pdf
deleted file mode 100644
index 24d8d07b21e..00000000000
--- a/Master/texmf-dist/doc/generic/pstricks/pst-quickref.pdf
+++ /dev/null
Binary files differ