pgfplots 1.6.1 (29aug12)

git-svn-id: svn://tug.org/texlive/trunk@27550 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 22 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.symbolic-transformations.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.symbolic-transformations.tex
index 5c1d36ee684..8a30dbfc371 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.symbolic-transformations.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.symbolic-transformations.tex
@@ -71,6 +71,28 @@ It is possible to provide a string dictionary to \PGFPlots. An input coordinate
 	
 	The effect of the transformation is simply that input coordinates can be elements of the dictionary and tick labels will be chosen out of this dictionary as well.
 
+	Note that |symbolic x coords| is more-or-less equivalent to explicitly provided |xtick| positions and |xticklabels|:
+\begin{codeexample}[]
+\begin{tikzpicture}
+\begin{axis}[
+	xtick={0,1,2,...,20},
+	xticklabels={a,b,c,d,e,f,g,h,i},
+	xticklabel style={
+		anchor=base,
+		yshift=-\baselineskip
+	},
+	]
+	\addplot+[smooth] coordinates {
+		(0,42)
+		(1,50)
+		(2,80)
+		(5,60)
+		(6,62)
+		(8,90)};
+\end{axis}
+\end{tikzpicture}
+\end{codeexample}
+	\noindent The difference is that the approach with |symbolic x coords| is simpler to read whereas the |xtick| approach is simpler with respect to coordinate arithmetics (for example to increase limits using |enlargelimits|). The |xticklabel style| here is an attempt to align all tick labels at their base line (which would be useful for |symbolic x coords| as well as soon as labels have characters which exceed the baseline).
 
 	\paragraph{See also} the option to add tick and/or grid lines at every encountered coordinate using |xtick=data| (or |minor xtick=data|).
 \end{pgfplotsxykeylist}