pgfplots update (17feb09)

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

1 files changed, 16 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex
index 5663043b17c..581b033cfcb 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex
@@ -642,6 +642,7 @@ The command |\pgfutilensuremath| checks whether math mode is active and switches
 \end{key}
 
 \noindent As last example, we use \PGFPlotstable\ to write an |.html| (without number formatting, however):
+% \usepackage{listings}
 \begin{codeexample}[width=8cm]
 \pgfplotstabletypeset[
 	begin table={<table>}, end table={</table>},
@@ -677,6 +678,7 @@ c & d \\
 \end{codeexample}
 
 Now, the environment |pgfplotstablecoltype| can be used in \marg{before column} and \marg{after column} to define numerical columns:
+% \usepackage{array}
 \begin{codeexample}[]
 % requires \usepackage{array}
 \newcolumntype{L}[1]
@@ -1113,6 +1115,7 @@ Typesetting cells means to take their value and ``do something''. In many cases,
 
 \begin{stylekey}{/pgfplots/table/date type=\marg{date format}}% (initially \year-\month-\day)}
 	A style which expects ISO dates of the form |YYYY-MM-DD| in each cell and produces pretty-printed strings on output. The output format is given as \marg{date format}. Inside of \marg{date format}, several macros which are explained below can be used.
+% \usepackage{pgfcalendar}
 \begin{codeexample}[]
 % Requires 
 % \usepackage{pgfcalendar}
@@ -1411,6 +1414,19 @@ It is possible to create new tables from scratch or to change tables after they
 \end{codeexample}
 \end{command}
 
+\begin{command}{\pgfplotstablevertcat\marg{\textbackslash table1}\marg{\textbackslash table2 or filename}}
+	Appends the contents of \marg{\textbackslash table2} to \marg{\textbackslash table1} (``vertical cat''). To be more precise, only columns which exist already in \marg{\textbackslash table1} will be appended and every column which exists in \marg{\textbackslash table1} must exist in \marg{\textbackslash table2} (or there must be |alias| or |create on use| specifications to generate them).
+
+	If the second argument is a file name, that file will be loaded from disk. 
+
+	If \marg{\textbackslash table1} does not exist, \marg{\textbackslash table2} will be copied to \marg{\textbackslash table1}.
+\begin{codeexample}[code only]
+\pgfplotstablevertcat{\output}{datafile1} % loads `datafile1' -> `\output'
+\pgfplotstablevertcat{\output}{datafile2} % appends rows of datafile2
+\pgfplotstablevertcat{\output}{datafile3} % appends rows of datafile3
+\end{codeexample}
+\end{command}
+
 \subsection{Creating New Columns From Existing Ones}
 \begin{command}{\pgfplotstablecreatecol\oarg{options}\marg{new col name}\marg{\textbackslash table}}
 Creates a new column named \marg{new col name} and appends it to an already existing table \marg{\textbackslash table}.