%\psset{PstDebug=1}
\title{\texttt{News}\\ \Large new macros and bugfixes for the
basic package \nxLFile{pstricks}}
\subtitle{Summary of the yearly posted news}
\author{Herbert Voß}
\date{\today}
\maketitle
\clearpage
\tableofcontents
\clearpage
\part{\texttt{pstricks} -- package}
\section{General}
There exists a new document class \LClass{pst-doc} for writing PSTricks documentations,
like this news document. It depends on the KOMA-Script document class \LClass{scrartcl}.
\LClass{pst-doc} defines a lot of special macros to create a good index. Take one of
the already existing package documentation and look into the source file. Then it will be
easy to understand, how all these macros have to be used.
When running \Lprog{pdflatex} the title page is created with boxes and inserted
with the macro \Lcs{AddToShipoutPicture} from the package \LPack{eso-pic}. It
inserts the background title page image \Lfile{pst-doc-pdf} to use directly
\Lprog{pdflatex}.
When running \Lprog{latex} the title page
is created with \PST\ macros.This allows to use the Perl script \Lprog{pst2pdf} or
the package \LPack{pst-pdf} or \LPack{auto-pst-pdf} or any other program/package which
supports \PS\ code in the document.
\begin{description}
\item[\texttt{noxcolor}] load package \LPack{color} instead of \LPack{xcolor};
\item[\texttt{plain}] do nothing else as a \Lcs{input}\Largb{\nxLPack{pstricks}};
\item[\texttt{DIA}] a bug fix for the \verb+PSTricks+-export of the grafic program DIA.
\end{description}
% ---------------------------------------------------------------------------------------
\subsubsection{\nxLkeyword{shift}}\label{subsubsec:shift}
% ---------------------------------------------------------------------------------------
This option is the known one from older \texttt{PSTricks} versions, but now with the
common syntax for options. The shift is relative to the height of the defined \Lenv{pspicture}
environment, its lower left corner is by deafult on the base line. For older versions
the shift depends with its value to the baseline, a negative value raised up the \Lenv{pspicture}
box. Now the \verb+shift+ option works similiar to the known \Lcs{raisebox} makro, except that
\Lkeyword{shift} is relative to the box height. A positive \Lkeyword{shift} value raises up the box
and vice versa for a negative value.
With \Lkeyword{shift}=\Lkeyval{*}, instead of a value or a length
it is possible to center the \Lenv{pspicture} box vertically to the baseline
of the current line.
% ---------------------------------------------------------------------------------------
\subsubsection{\texttt{showgrid}}\label{subsubsec:showgrid}
% ---------------------------------------------------------------------------------------
This version of \texttt{PSTricks} defines internally a special grid style
which can be overwritten by the user. This style is only used for the \Lkeyword{showgrid}
option of the \Lenvpspicture} environment. The macro \Lcs{psgrid} doesn't use this predefined
style and works in the usual way. However, the user can use it like all
other self defined styles: \Lcs{psgrid}\Largs{\Lkeyset{style=gridstyle}}.
Depending to the internal structure of the \Lenv{pspicture} environment it is not possible
to set the \Lkeyword{shift} option global by \Lcs{psset}, it must always be locally defined
with optional part of the parameter, as seen in the above examples.
\subsection{Option \nxLkeyword{gridfont}}
By default the \Index{grid label}s were printed always in \Index{Helvetica}. With the new keyword \Lkeyword{gridfont}
one can define another \Index{PostScript Font}. Available are at least
\subsection{Macro \nxLcs{psLoop}}
\PST\marginpar[2.17]{2.17} already knows \Lcs{psforeach} and \Lcs{psForeach} for loops. The new
macro \Lcs{psLoop} allows a loop without defining a variable:
