3 files changed, 78 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/latex/tikz-palattice/elsa.tex b/Master/texmf-dist/doc/latex/tikz-palattice/elsa.tex
index 335ab469c65..4d619144c97 100644
--- a/Master/texmf-dist/doc/latex/tikz-palattice/elsa.tex
+++ b/Master/texmf-dist/doc/latex/tikz-palattice/elsa.tex
@@ -32,10 +32,10 @@
 
 \def\scale{0.5}
 
-\tikzset{biggestlabel/.style={font=\bfseries\Huge,scale=2.5, align=center}}
-\tikzset{biglabel/.style={font=\bfseries\Huge,scale=2, align=center}}
-\tikzset{mediumlabel/.style={font=\huge,scale=2, align=center}}
-\tikzset{smalllabel/.style={font=\Large,scale=2.2, align=center}}
+\tikzset{biggestlabel/.style={font=\bfseries\Huge,scale=2.5, align=center,faded}}
+\tikzset{biglabel/.style={font=\bfseries\Huge,scale=2, align=center,faded}}
+\tikzset{mediumlabel/.style={font=\huge,scale=2, align=center,faded}}
+\tikzset{smalllabel/.style={font=\Large,scale=2.2, align=center,faded}}
 
 
 
diff --git a/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.pdf b/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.pdf
index d218b6d24b9..41b362c0424 100644
--- a/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.pdf
+++ b/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.pdf
diff --git a/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.tex b/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.tex
index 201c4e44d7c..1d557bd4edf 100644
--- a/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.tex
+++ b/Master/texmf-dist/doc/latex/tikz-palattice/tikz-palattice_documentation.tex
@@ -41,7 +41,7 @@
 \newcommand{\tikzlabel}{Ti\textit{k}Z}
 
 \author{Jan Schmidt <schmidt@physik.uni-bonn.de>}
-\date{v2.2 (March 01, 2015)}
+\date{v2.21 (March 18, 2015)}
 \title{tikz-palattice - draw particle accelerator lattices with \tikzlabel}
 
 \hypersetup{
@@ -203,7 +203,7 @@ the default value of "scale" is 1.
 
 To draw a lattice just add
 \begin{lstlisting}
-\usepackage{lattice}
+\usepackage{tikz-palattice}
 \end{lstlisting}
 to your preambel and use the lattice environment with
 \begin{lstlisting}
@@ -405,7 +405,7 @@ sets the text label font size. Default is \lstinline+\normalsize+.
 
 
 
-\subsubsection{Colors}
+\subsection{Colors}
 \label{sec:colors}
 The colors can be changed at any point of the lattice. A setting is valid until the next
 color command. The reset commands set the according default color. Use a \lstinline+scope+
@@ -430,6 +430,10 @@ for all element types. Set \optiondef{gradient color}{white} equal to \option{co
 for textlabels. Set to background color to hide text labels.
 
 
+
+\subsection{Fade Out}
+\label{sec:fade-out}
+
 \begin{lstlisting}
   \begin{fade}[(*\optiondef{opacity}{0.25}*)]
     ...
@@ -437,8 +441,63 @@ for textlabels. Set to background color to hide text labels.
 \end{lstlisting}
  reduces the opacity of all elements within the environment and sets all colors to gray.
  So you can fade out regions of the lattice - e.g. for presentations.
- This can also be used to completely hide regions by setting \optiondef{opacity}{0.25} to zero.
+ This can also be used to completely hide regions by setting \optiondef{opacity}{0.25} to
+ zero.
 
+ Custom drawings and annotations (see section \ref{sec:coords}) can also be faded out
+ automatically. The tikz style \lstinline{faded} provides the appropriate settings: Add
+ \lstinline{faded} to the style of any tikz drawing or node within the \lstinline{lattice}
+ environment. If it is drawn within a \lstinline{fade} environment, it is faded out. Else
+ its style is not changed:
+
+\begin{minipage}[c]{0.6\textwidth}
+\begin{lstlisting}
+  \begin{lattice}
+    \tikzset{mynode/.style={
+        anchor=west,xshift=7mm,font=\bf,red}}
+    \setangle{-90}
+    \drift{0.2}
+    \sextupole{S1}{0.2}
+    \drift{0.267}
+    \begin{fade}[0.4]
+      \quadrupole{Q1}{0.4}
+      \savecoordinate{Q1}[center]
+      \node[mynode,faded] at (Q1) {a quadrupole!};
+      \drift{0.29}
+    \end{fade}
+    \kicker{VC1}{0.1}
+    \savecoordinate{kick}[center]
+    \node[mynode,faded] at (kick) {a kicker!};
+    \drift{0.2}   
+    \dipole{M1}{0.8}{30}
+    \drift{0.29}
+  \end{lattice}
+\end{lstlisting}
+\end{minipage}
+%
+\begin{minipage}[c]{0.4\textwidth}
+  \begin{center}
+    \begin{lattice}
+      \tikzset{mynode/.style={anchor=west,xshift=7mm,font=\bf,red}}
+      \setangle{-90}
+      \drift{0.2}
+      \sextupole{S1}{0.2}
+      \drift{0.267}
+      \begin{fade}[0.4]
+        \quadrupole{Q1}{0.4}
+        \savecoordinate{Q1}[center]
+        \node[mynode,faded] at (Q1) {a quadrupole!};
+        \drift{0.29}
+      \end{fade}
+      \kicker{VC1}{0.1}
+      \savecoordinate{kick}[center]
+      \node[mynode,faded] at (kick) {a kicker!};
+      \drift{0.2}   
+      \dipole{M1}{0.8}{30}
+      \drift{0.29}
+    \end{lattice}
+  \end{center}
+\end{minipage}
 
 
 
@@ -572,6 +631,7 @@ exact place of the element. \textit{east} and \textit{center} are available (see
 
 
 
+\clearpage
 \section{Changelog}
 \label{sec:changelog}
 v2.1 from 2015/02/23 is the first published version.
@@ -583,6 +643,13 @@ v2.1 from 2015/02/23 is the first published version.
 \item minor documentation improvements
 \end{itemize}
 
+\paragraph{v2.21 from 2015/03/18}
+\begin{itemize}
+\item added \lstinline+faded+ style (apply fade out to custom annotations)
+\item fixed sector dipole drawing
+\item documentation fixes
+\end{itemize}
+
 
 \section{TODO}
 \label{sec:todo}
@@ -604,6 +671,9 @@ bunch of macros. So there is:
 
 \paragraph{Known issues:}
 \begin{itemize}
+\item A circular lattice can have a significant offset (no closed circle), if the dipole
+  bending angles are not integer. Probably, this is due to rounding or calculation
+  accuracy.
 \item Please report bugs!
 \end{itemize}