csvsimple (12mar12)

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

8 files changed, 1133 insertions, 20 deletions

diff --git a/Master/texmf-dist/doc/latex/csvsimple/CHANGES b/Master/texmf-dist/doc/latex/csvsimple/CHANGES
index 4076a947193..a0ad80b3808 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/CHANGES
+++ b/Master/texmf-dist/doc/latex/csvsimple/CHANGES
@@ -1,7 +1,7 @@
-%% The LaTeX package csvsimple - version 1.04 (2011/11/11)

+%% The LaTeX package csvsimple - version 1.05 (2012/03/12)

 %%

 %% -------------------------------------------------------------------------------------------

-%% Copyright (c) 2008-2011 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>

+%% Copyright (c) 2008-2012 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>

 %% -------------------------------------------------------------------------------------------

 %%

 %% This work may be distributed and/or modified under the

@@ -40,3 +40,14 @@ version 1.04 (2011/11/11):
 - documentation update and correction

 - internal behaviour of 'before reading' and 'after reading' changed for tables

 

+version 1.05 (2012/03/12):

+- documentation language changed from German to English

+- source code of the documentation added

+- provision of the csvsimple.tds.zip file for easier installation

+- key @table removed from the documentation

+- new keys: preprocessed file, preprocessor, no preprocessing

+  for preprocessing support (e.g. sorting)

+- error in 'nocheckcolumncount' corrected and key renamed to 'no check column count'

+- key nofilter renamed to 'no filter' and 'nohead' to 'no head' (the old names

+  are kept as deprecated key names)

+

diff --git a/Master/texmf-dist/doc/latex/csvsimple/README b/Master/texmf-dist/doc/latex/csvsimple/README
index c22e2815f8e..1f730eaa61a 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/README
+++ b/Master/texmf-dist/doc/latex/csvsimple/README
@@ -1,7 +1,7 @@
-%% The LaTeX package csvsimple - version 1.04 (2011/11/11)
+%% The LaTeX package csvsimple - version 1.05 (2012/03/12)
 %%
 %% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2008-2011 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2008-2012 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
 %% -------------------------------------------------------------------------------------------
 %%
 %% This work may be distributed and/or modified under the
@@ -29,12 +29,15 @@ Contents of the package
   'CHANGES'                   log of changes (history)
   'csvsimple.sty'             LaTeX package file (style file)
   'csvsimple.pdf'             Documentation for csvsimple
+  'csvsimple.tex'             Source code of the documentation
   'csvsimple-example.tex'     Example file for package usage
   'csvsimple-example.csv'     CSV file as part of the example
   'csvsimple-example.pdf'     Compiled example
 
 Installation
 ============
-Put the files to their respective locations within the TeX installation:
+Copy the contents of the 'csvsimple.tds.zip' from CTAN to your local TeX file tree.
+
+Alternatively, put the files to their respective locations within the TeX installation:
   'csvsimple.sty'    ->  /tex/latex/csvsimple
   all other files    ->  /doc/latex/csvsimple
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.csv b/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.csv
deleted file mode 100644
index 9a988ac743b..00000000000
--- a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.csv
+++ /dev/null
@@ -1,5 +0,0 @@
-last name,first name,address,zip,telephone,year of birth
-Appleby,Anne,Shrimpsbury,SH-124,555-4455,1960
-Brown,Carl,Midsomer Garden,MD-945,555-2423,1982
-Smith,John,Shrimpsbury,SH-123,555-4584,1978
-Underwood,Mary,Oglsby,OG-345,555-3434,1956
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.pdf b/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.pdf
index b0891ff94f3..f1848b15ce7 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.pdf
+++ b/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.pdf
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.tex b/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.tex
index bccdba6191a..dcf284ed009 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.tex
+++ b/Master/texmf-dist/doc/latex/csvsimple/csvsimple-example.tex
@@ -1,4 +1,4 @@
-%% The LaTeX package csvsimple - version 1.04 (2011/11/11)
+%% The LaTeX package csvsimple - version 1.05 (2012/03/12)
 %% csvsimple-example.tex: an example for csvsimple
 %%
 %% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple.pdf b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.pdf
index 44e40b77d94..38a992ea27e 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/csvsimple.pdf
+++ b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.pdf
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
new file mode 100644
index 00000000000..96ac0ffeb56
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
@@ -0,0 +1,1088 @@
+% \LaTeX-Main\
+%% The LaTeX package csvsimple - version 1.05 (2012/03/12)
+%% csvsimple.sty: Simple LaTeX CSV file processing
+%%
+%% -------------------------------------------------------------------------------------------
+%% Copyright (c) 2008-2012 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% -------------------------------------------------------------------------------------------
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%%   http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status `author-maintained'.
+%%
+%% This work consists of all files listed in README
+%%
+\documentclass[a4paper,11pt]{ltxdoc}
+
+\usepackage[T1]{fontenc}
+\usepackage[latin1]{inputenc}
+\usepackage[english]{babel}
+\usepackage{lmodern,parskip,array,ifthen,calc,makeidx}
+\usepackage{amsmath,amssymb}
+\usepackage[svgnames,table,hyperref]{xcolor}
+\usepackage{tikz}
+\usepackage[pdftex,bookmarks,raiselinks,pageanchor,hyperindex,colorlinks]{hyperref}
+\urlstyle{sf}
+
+\usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm,
+    marginparsep=5mm,marginparwidth=10mm,
+    headheight=0mm,headsep=0cm,
+    footskip=1.5cm,includeheadfoot]{geometry}
+\usepackage{fancyhdr}
+\fancyhf{}
+\fancyfoot[C]{\thepage}%
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+\pagestyle{fancy}
+\tolerance=2000%
+\setlength{\emergencystretch}{20pt}%
+
+\RequirePackage{csquotes}
+\RequirePackage[style=numeric-comp,sorting=nyt,
+  maxnames=8,minnames=8,abbreviate=false,backend=biber]{biblatex}
+\DeclareFieldFormat{url}{\newline\url{#1}}%
+\DeclareListFormat{language}{}%
+\setlength{\bibitemsep}{\smallskipamount}
+\addbibresource{\jobname.bib}
+
+\usepackage[documentation]{tcolorbox}
+\usepackage{longtable}
+\usepackage{csvsimple}
+
+\tcbmakedocSubKey{docCsvKey}{csv}
+
+\newcommand{\csvlisting}[1]{%
+  \tcbinputlisting{docexample,listing style=tcbdocumentation,
+  listing only,title={CSV file \texttt{#1.csv}},listing file=#1.csv}}
+
+\makeatletter
+\newcommand{\auxCommand}[1]{\disp@com{\cs{#1}}\index@Com{#1}}
+\makeatother
+
+\hypersetup{
+  pdftitle={Manual for the csvsimple package},
+  pdfauthor={Thomas F. Sturm},
+  pdfsubject={csv file processing with LaTeX},
+  pdfkeywords={csv file, comma separated values, key value syntax}
+}
+
+\def\version{1.05}%
+\def\datum{2012/03/12}%
+\makeindex
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\begin{document}
+\begin{center}
+\vspace*{5mm}\par
+{\bfseries\LARGE The \texttt{csvsimple} package\par}
+{\large Version \version\ (\datum)\par}\bigskip
+{\large Thomas F.~Sturm%
+  \footnote{Prof.~Dr.~Dr.~Thomas F.~Sturm, Institut f\"{u}r Mathematik und Informatik,
+    Universit\"{a}t der Bundeswehr M\"{u}nchen, D-85577 Neubiberg, Germany;
+     email: \href{mailto:thomas.sturm@unibw.de}{thomas.sturm@unibw.de}} }
+\end{center}
+\bigskip
+\begin{absquote}
+  \begin{center}\bfseries Abstract\end{center}
+  |csvsimple| provides a simple \LaTeX\ interface for the processing of files with
+  comma separated values (CSV). |csvsimple| relies heavily on the key value
+  syntax from |pgfkeys| which results (hopefully) in an easy way of usage.
+  Filtering and table generation is especially supported. Since the package
+  is considered as a lightweight tool, there is no support for data sorting
+  or data base storage.
+\end{absquote}
+
+\tableofcontents
+
+
+\section{Introduction}%
+The |csvsimple| package is applied to the processing of
+CSV\footnote{CSV file: file with comma separated values.} files.
+This processing is controlled by key value assignments according to the
+syntax of |pgfkeys| \cite{tantau:2010c}. Sample applications of the package
+are tabular lists, serial letters, and charts.
+
+An alternative to |csvsimple| is the |datatool| package \cite{talbot:2009a}
+which provides considerably more functions like exchange of separator and
+delimiter symbols or sorting of data.
+|csvsimple| has a different approach for the user interface and
+is deliberately restricted to some basic functions with fast
+processing speed.
+
+
+\subsection{Loading the Package}
+The package |csvsimple| loads the packages
+|pgfkeys| \cite{tantau:2010c} and |ifthen| \cite{carlisle:2001b}.
+|csvsimple| itself is loaded in the usual manner in the preamble:
+\begin{dispListing}
+\usepackage{csvsimple}
+\end{dispListing}
+
+
+\subsection{First Steps}
+Every line of a processable CSV file has to contain an identical amount of
+comma separated values. The curly braces |{}| of \TeX\ groups can be used
+to mask a block which may contain commas not to be processed as separators.
+
+The first line of such a CSV file is usually but not necessarily a header line
+which contains the identifiers for each column.
+
+%-- file embedded for simplicity --
+\begin{tcbverbatimwrite}{grade.csv}
+name,givenname,matriculation,gender,grade
+Maier,Hans,12345,m,1.0
+Huber,Anna,23456,f,2.3
+Wei\ss{}b\"{a}ck,Werner,34567,m,5.0
+\end{tcbverbatimwrite}
+%-- end embedded file --
+
+\csvlisting{grade}
+
+The most simple way to display a CSV file in tabular form is the processing
+with the \refCom{csvautotabular} command.
+
+\begin{dispExample}
+\csvautotabular{grade.csv}
+\end{dispExample}
+
+Typically, one would use \refCom{csvreader} instead of |\csvautotabular| to
+gain full control over the interpretation of the included data.
+
+In the following example, the entries of the header line are automatically
+assigned to \TeX\ macros which may be used deliberately.
+
+\begin{dispExample}
+\begin{tabular}{|l|c|}\hline%
+\bfseries Person & \bfseries Matr.~No.
+\csvreader[head to column names]{grade.csv}{}%
+{\\\givenname\ \name & \matriculation}%
+  \\\hline
+\end{tabular}
+\end{dispExample}
+
+\newpage
+|\csvreader| is controlled by a plenty of options. For example, for table
+applications line breaks are easily inserted by
+\refKey{/csv/late after line}. This defines a macro execution just before
+the following line.
+Additionally, the assignment of columns to \TeX\ macros is shown in a non automated
+way.
+
+\begin{dispExample}
+\begin{tabular}{|r|l|c|}\hline%
+& Person & Matr.~No.\\\hline\hline
+\csvreader[late after line=\\\hline]%
+  {grade.csv}{name=\name,givenname=\firstname,matriculation=\matnumber}%
+  {\thecsvrow & \firstname~\name & \matnumber}%
+\end{tabular}
+\end{dispExample}
+
+An even more comfortable way to create a table is setting
+appropriate option keys. Note, that this gives you the possibility to create a
+|pgfkeys| style which contains the whole table creation.
+
+\begin{dispExample}
+\csvreader[tabular=|r|l|c|,
+    table head=\hline & Person & Matr.~No.\\\hline\hline,
+    late after line=\\\hline]%
+  {grade.csv}{name=\name,givenname=\firstname,matriculation=\matnumber}%
+  {\thecsvrow & \firstname~\name & \matnumber}%
+\end{dispExample}
+
+The next example shows such a style definition with the convenience macro
+\refCom{csvstyle}. Here, we see again the automated assignment of header
+entries to column names by \refKey{/csv/head to column names}.
+For this, the header entries have to be without spaces and special characters.
+But you can always assign entries to canonical macro names by hand like in the examples
+above.
+
+\begin{dispExample}
+\csvstyle{myTableStyle}{tabular=|r|l|c|,
+    table head=\hline & Person & Matr.~No.\\\hline\hline,
+    late after line=\\\hline,
+    head to column names}
+
+\csvreader[myTableStyle]{grade.csv}{}%
+  {\thecsvrow & \givenname~\name & \matriculation}%
+\end{dispExample}
+
+\newpage
+Another way to address columns is to use their roman numbers.
+The direct addressing is done by |\csvcoli|, |\csvcolii|, |\csvcoliii|, \ldots:
+
+\begin{dispExample}
+\csvreader[tabular=|r|l|c|,
+    table head=\hline & Person & Matr.~No.\\\hline\hline,
+    late after line=\\\hline]%
+  {grade.csv}{}%
+  {\thecsvrow & \csvcolii~\csvcoli & \csvcoliii}%
+\end{dispExample}
+
+And yet another method to assign macros to columns is to use arabic numbers
+for the assignment:
+
+\begin{dispExample}
+\csvreader[tabular=|r|l|c|,
+    table head=\hline & Person & Matr.~No.\\\hline\hline,
+    late after line=\\\hline]%
+  {grade.csv}{1=\name,2=\firstname,3=\matnumber}%
+  {\thecsvrow & \firstname~\name & \matnumber}%
+\end{dispExample}
+
+For recurring applications, the |pgfkeys| syntax allows to create own styles
+for a consistent and centralized design. The following example is easily
+modified to obtain more or less option settings.
+
+\begin{dispExample}
+\csvset{myStudentList/.style={%
+  tabular=|r|l|c|,
+  table head=\hline & Person & #1\\\hline\hline,
+  late after line=\\\hline,
+  column names={name=\name,givenname=\firstname}
+  }}
+
+\csvreader[myStudentList={Matr.~No.}]{grade.csv}{matriculation=\matnumber}%
+{\thecsvrow & \firstname~\name & \matnumber}%
+\hfill%
+\csvreader[myStudentList={Grade}]{grade.csv}{grade=\grade}%
+{\thecsvrow & \firstname~\name & \grade}%
+\end{dispExample}
+
+\newpage
+Alternatively, column names can be set by \refCom{csvnames}
+and style definitions by \refCom{csvstyle}.
+With this, the last example is rewritten as follows:
+
+\begin{dispExample}
+\csvnames{myNames}{1=\name,2=\firstname,3=\matnumber,5=\grade}
+\csvstyle{myStudentList}{tabular=|r|l|c|,
+  table head=\hline & Person & #1\\\hline\hline,
+  late after line=\\\hline, myNames}
+
+\csvreader[myStudentList={Matr.~No.}]{grade.csv}{}%
+{\thecsvrow & \firstname~\name & \matnumber}%
+\hfill%
+\csvreader[myStudentList={Grade}]{grade.csv}{}%
+{\thecsvrow & \firstname~\name & \grade}%
+\end{dispExample}
+
+The data lines of a CSV file can also be filtered. In the following example,
+a certificate is printed only for students with grade unequal to 5.0.
+
+\begin{dispExample}
+\csvreader[filter not equal={\grade}{5.0}]%
+  {grade.csv}{1=\name,2=\firstname,3=\matnumber,4=\gender,5=\grade}%
+  {\begin{center}\Large\bfseries Certificate in Mathematics\end{center}
+  \large\ifthenelse{\equal{\gender}{f}}{Ms.}{Mr.}
+  \firstname~\name, matriculation number \matnumber, has passed the test
+  in mathematics with grade \grade.\par\ldots\par
+  }%
+\end{dispExample}
+
+
+\clearpage
+\section{Macros for the Processing of CSV Files}\label{sec:makros}%
+
+\begin{docCommand}{csvreader}{\oarg{options}\marg{file name}\marg{assignments}\marg{command list}}
+  |\csvreader| reads the file denoted by \meta{file name} line by line.
+  Every line of the file has to contain an identical amount of
+  comma separated values. The curly braces |{}| of \TeX\ groups can be used
+  to mask a block which may contain commas not to be processed as separators.\smallskip
+
+  The first line of such a CSV file is by default but not necessarily
+  processed as a header line which contains the identifiers for each column.
+  The entries of this line can be used to give \meta{assignments} to \TeX\ macros
+  to address the columns. The number of entries of this first line
+  determines the accepted number of entries for all following lines.
+  Every line which contains a higher or lower number of entries is ignored
+  during standard processing.\smallskip
+
+  The \meta{assignments} are given by key value pairs
+  \mbox{\meta{name}|=|\meta{macro}}. Here, \meta{name} is an entry from the
+  header line \emph{or} the arabic number of the addressed column.
+  \meta{macro} is some \TeX\ macro which gets the content of the addressed column.\smallskip
+
+  The \meta{command list} is executed for every accepted data line. Inside the
+  \meta{command list} is applicable:
+  \begin{itemize}
+  \item \auxCommand{thecsvrow} or the counter |csvrow| which contains the number of the
+    current data line (starting with 1).
+  \item \auxCommand{csvcoli}, \auxCommand{csvcolii}, \auxCommand{csvcoliii}, \ldots,
+    which contain the contents of the column entries of the current data line.
+    Alternatively can be used:
+  \item \meta{macro} from the \meta{assignments} to have a logical
+    addressing of a column entry.
+  \end{itemize}
+  Note, that the \meta{command list} is allowed to contain |\par| and
+  that all macro definitions are made global to be used for table applications.\smallskip
+
+  The processing of the given CSV file can be controlled by various
+  \meta{options} given as key value list. The feasible option keys
+  are described in section \ref{sec:schluessel} from page \pageref{sec:schluessel}.
+
+\begin{dispExample}
+\csvreader[tabular=|r|l|l|, table head=\hline, late after line=\\,
+           late after last line=\\\hline]{grade.csv}%
+  {name=\name,givenname=\firstname,grade=\grade}%
+  {\grade & \firstname~\name & \csvcoliii}
+\end{dispExample}
+
+Mainly, the |\csvreader| command consists of a \refCom{csvloop} macro with
+following parameters:\par
+|\csvloop{|\meta{options}|, file=|\meta{file name}|, column names=|\meta{assignments}|,|\\
+  \hspace*{2cm} |command=|\meta{command list}|}|\par
+  Therefore, the application of the keys \refKey{/csv/file} and \refKey{/csv/command}
+is useless for |\csvreader|.
+\end{docCommand}
+
+\begin{docCommand}{csvloop}{\marg{options}}
+  Usually, \refCom{csvreader} may be preferred instead of |\csvloop|.
+  \refCom{csvreader} is based on |\csvloop| which takes a mandatory list of
+  \meta{options} in key value syntax.
+  This list of \meta{options} controls the total processing. Especially,
+  it has to contain the CSV file name.
+\begin{dispExample}
+\csvloop{file={grade.csv}, column names={name=\name}, command=\name,
+  before reading={List of students:\ },
+  late after line={{,}\ }, late after last line=.}
+\end{dispExample}
+\end{docCommand}
+
+\clearpage
+\begin{docCommand}{csvautotabular}{\marg{file name}}
+  |\csvautotabular| is an abbreviation for the application of the option key
+  \refKey{/csv/autotabular}.
+  This macro reads the whole CSV file denoted by \meta{file name}
+  with an automated formatting.
+\begin{dispExample}
+\csvautotabular{grade.csv}
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvautolongtable}{\marg{file name}}
+  |csvautolongtable| is an abbreviation for the application of the option key
+  \refKey{/csv/autolongtable}.
+  This macro reads the whole CSV file denoted by \meta{file name}
+  with an automated formatting.
+  For application, the package |longtable| is required which has to be
+  loaded in the preamble.
+\end{docCommand}
+
+
+\begin{docCommand}{csvset}{\marg{options}}
+  Sets \meta{options} for every following
+  \refCom{csvreader} and \refCom{csvloop}. For example, this command may
+  be used for style definitions.
+\begin{dispExample}
+\csvset{grade list/.style=
+    {column names={name=\name,givenname=\firstname,grade=\grade}},
+  passed/.style={filter not equal={\grade}{5.0}} }
+
+The following students passed the test in mathematics:
+\csvreader[grade list,passed]{grade.csv}{}{\firstname\ \name\ (\grade); }%
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvstyle}{\marg{Stilname}\marg{options}}
+  Abbreviation for |\csvset{|\meta{style name}|/.style=|\marg{options}|}|
+  to define a new style.
+\end{docCommand}
+
+\begin{docCommand}{csvnames}{\marg{Stilname}\marg{Zuweisungsliste}}
+  Abbreviation for |\csvset{|\meta{style name}|/.style={column names=|\marg{assignments}|}}|
+  to define additional \meta{assignments} of macros to columns.
+\begin{dispExample}
+\csvnames{grade list}{name=\name,givenname=\firstname,grade=\grade}
+\csvstyle{passed}{filter not equal={\grade}{5.0}}
+
+The following students passed the test in mathematics:
+\csvreader[grade list,passed]{grade.csv}{}{\firstname\ \name\ (\grade); }%
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvheadset}{\marg{assignments}}
+  For some special cases, this command can be used to change the
+  \meta{assignments} of macros to columns during execution of
+  \refCom{csvreader} and \refCom{csvloop}.
+\begin{dispExample}
+\csvreader{grade.csv}{}%
+  { \csvheadset{name=\n} \fbox{\n}
+    \csvheadset{givenname=\n} \ldots\ \fbox{\n}  }%
+\end{dispExample}
+\end{docCommand}
+
+\clearpage
+
+\begin{docCommand}{csviffirstrow}{\marg{then macros}\marg{else macros}}
+  Inside the command list of \refCom{csvreader}, the \meta{then macros}
+  are executed for the first data line, and the \meta{else macros}
+  are executed for all following lines.
+\begin{dispExample}
+\csvreader[tabbing, head to column names, table head=\hspace*{3cm}\=\kill]%
+  {grade.csv}{}%
+  {\givenname~\name \> (\csviffirstrow{first entry!!}{following entry})}
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvifoddrow}{\marg{then macros}\marg{else macros}}
+  Inside the command list of \refCom{csvreader}, the \meta{then macros}
+  are executed for odd-numbered   data lines, and the \meta{else macros}
+  are executed for even-numbered lines.
+\begin{dispExample}
+\csvreader[head to column names,tabular=|l|l|l|l|,
+  table head=\hline\bfseries \# & \bfseries Name & \bfseries Grade\\\hline,
+  late after line=\\, late after last line=\\\hline]{grade.csv}{}{%
+    \csvifoddrow{\slshape\thecsvrow & \slshape\name, \givenname & \slshape\grade}%
+    {\bfseries\thecsvrow & \bfseries\name, \givenname & \bfseries\grade}}
+\end{dispExample}
+
+The |\csvifoddrow| macro may be used for striped tables:
+
+\begin{dispExample}
+% This example needs the xcolor package
+\csvreader[head to column names,tabular=rlcc,
+  table head=\hline\rowcolor{red!50!black}\color{white}\# & \color{white}Person
+    & \color{white}Matr.~No. & \color{white}Grade,
+  late after head=\\\hline\rowcolor{yellow!50},
+  late after line=\csvifoddrow{\\\rowcolor{yellow!50}}{\\\rowcolor{red!25}}]%
+  {grade.csv}{}%
+  {\thecsvrow & \givenname~\name & \matriculation & \grade}%
+\end{dispExample}
+
+Alternatively, |\rowcolors| from the |xcolor| package can be used for this
+purpose:
+
+\begin{dispExample}
+% This example needs the xcolor package
+\csvreader[tabular=rlcc, before table=\rowcolors{2}{red!25}{yellow!50},
+  table head=\hline\rowcolor{red!50!black}\color{white}\# & \color{white}Person
+    & \color{white}Matr.~No. & \color{white}Grade\\\hline,
+  late after line=\\,head to column names]{grade.csv}{}%
+  {\thecsvrow & \givenname~\name & \matriculation & \grade}%
+\end{dispExample}
+\end{docCommand}
+
+\clearpage
+
+\begin{docCommand}{csvfilteraccept}{}
+  All following consistent data lines will be accepted and processed.
+  This command overwrites all previous filter settings and may be used
+  inside \refKey{/csv/before filter} to implement
+  an own filtering rule together with |\csvfilterreject|.
+\begin{dispExample}
+\csvreader[autotabular,
+  before filter=\ifthenelse{\equal{\csvcoliv}{m}}{\csvfilteraccept}{\csvfilterreject}
+  ]{grade.csv}{}{\csvlinetotablerow}%
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvfilterreject}{}
+  All following data lines will be ignored.
+  This command overwrites all previous filter settings.
+\end{docCommand}
+
+
+\begin{docCommand}{csvline}{}
+  This macro contains the current and unprocessed data line.
+\begin{dispExample}
+\csvreader[no head, tabbing, table head=\textit{line XX:}\=\kill]%
+  {grade.csv}{}{\textit{line \thecsvrow:} \> \csvline}%
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{thecsvrow}{}
+  Typesets the current data line number. This is the
+  current number of accepted data lines without the header line.
+  The \LaTeX\ counter |csvrow| can be addressed directly in the usual way,
+  e.\,g. by |\roman{csvrow}|.
+\end{docCommand}
+
+
+\begin{docCommand}{thecsvinputline}{}
+  Typesets the current file line number. This is the
+  current number of all data lines including the header line.
+  The \LaTeX\ counter |csvinputline| can be addressed directly in the usual way,
+  e.\,g. by |\roman{csvinputline}|.
+\begin{dispExample}
+\csvreader[no head, filter equal={\thecsvinputline}{3}]%
+  {grade.csv}{}%
+  {The line with number \thecsvinputline\ contains: \csvline}%
+\end{dispExample}
+\end{docCommand}
+
+
+\begin{docCommand}{csvlinetotablerow}{}
+  Typesets the current processed data line with |&| between the entries.
+  Most users will never apply this command.
+\end{docCommand}
+
+
+
+\clearpage
+\section{Option Keys}\label{sec:schluessel}%
+For the \meta{options} in \refCom{csvreader} respectively \refCom{csvloop}
+the following |pgf| keys can be applied. The key tree path |/csv/| is not
+to be used inside these macros.
+
+
+\subsection{Command Definition}%--------%[[
+
+\begin{docCsvKey}{before reading}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed before the CSV file is processed.
+\end{docCsvKey}
+
+\begin{docCsvKey}{after head}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after the header line is read.
+\end{docCsvKey}
+
+\begin{docCsvKey}{before filter}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after reading and consistency checking
+  of a data line. They are executed before any filter condition is checked,
+  see \refKey{/csv/filter}.
+\end{docCsvKey}
+
+\begin{docCsvKey}{late after head}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after reading and disassembling
+  of the first accepted data line. They are executed before further processing
+  of this line.
+\end{docCsvKey}
+
+\begin{docCsvKey}{late after line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after reading and disassembling
+  of the next accepted data line (after \refKey{/csv/before filter}).
+  They are executed before further processing of this next line.
+  |late after line| overwrites |late after first line| and |late after last line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{late after first line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after reading and disassembling
+  of the second accepted data line instead of \refKey{/csv/late after line}.
+  This key has to be set after |late after line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{late after last line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after processing of the last
+  accepted data line instead of \refKey{/csv/late after line}.
+  This key has to be set after |late after line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{before line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after \refKey{/csv/late after line}
+  and before \refKey{/csv/command}.
+  |before line| overwrites |before first line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{before first line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed instead of \refKey{/csv/before line}
+  for the first accepted data line.
+  This key has to be set after |before line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{command}{=\meta{macros}}{no default, initially \cs{csvline}}
+  Sets the \meta{macros} to be executed for every accepted data line.
+  They are executed between \refKey{/csv/before line} and \refKey{/csv/after line}.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{after line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed for every accepted data line
+  after \refKey{/csv/command}.
+  |after line| overwrites |after first line|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{after first line}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed instead of \refKey{/csv/after line}
+  for the first accepted data line.
+  This key has to be set after |after line|.
+\end{docCsvKey}
+
+\begin{docCsvKey}{after reading}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after the CSV file is processed.
+\end{docCsvKey}
+
+
+\begin{dispExample}
+\csvreader[
+  before reading        = \meta{before reading}\\,
+  after head            = \meta{after head},
+  before filter         = \\\meta{before filter},
+  late after head       = \meta{late after head},
+  late after line       = \meta{late after line},
+  late after first line = \meta{late after first line},
+  late after last line  = \\\meta{late after last line},
+  before line           = \meta{before line},
+  before first line     = \meta{before first line},
+  after line            = \meta{after line},
+  after first line      = \meta{after first line},
+  after reading         = \\\meta{after reading}
+    ]{grade.csv}{name=\name}{\textbf{\name}}%
+\end{dispExample}
+
+Additional command definition keys are provided for the supported tables,
+see section \ref{subsec:tabsupport} from page
+\pageref{subsec:tabsupport}.
+
+
+\subsection{Header Processing and Column Name Assignment}%
+
+\begin{docCsvKey}{head}{\colOpt{=\meta{boolean value}}}{default |true|, initially |true|}
+  If this key is set, the first line of the CSV file is treated as a header
+  line which can be used for column name assignments.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{no head}{}{no value}
+  Abbreviation for |head=false|, i.\,e. the first line of the CSV file is
+  treated as data line.
+\end{docCsvKey}
+
+\begin{docCsvKey}{column names}{=\meta{assignments}}{no default, initially empty}
+  Adds some new \meta{assignments} of macros to columns in key value syntax.
+  Existing assignments are kept.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{column names reset}{}{no value}
+  Clears all assignments of macros to columns.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{head to column names}{\colOpt{=\meta{boolean value}}}{default |true|, initially |false|}
+  If this key is set, the entries of the header line are used automatically
+  as macro names for the columns. This option can be used only, if
+  the header entries do not contain spaces and special characters to be
+  used as feasible \LaTeX\ macro names.
+\end{docCsvKey}
+
+
+\clearpage
+\subsection{Consistency Check and Filtering}%
+
+\begin{docCsvKey}{check column count}{\colOpt{=\meta{boolean value}}}{default |true|, initially |true|}
+  This key defines, if the number of entries in a data line is checked against
+  an expected value.\\
+  If |true|, every non consistent line is ignored without announcement.\\
+  If |false|, every line is accepted and may produce an error during
+  further processing.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{no check column count}{}{no value}
+  Abbreviation for |check column count=false|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{column count}{=\meta{number}}{no default}
+  Sets the \meta{number} of feasible entries per data line.
+  This setting is only useful in connection with \refKey{/csv/no head},
+  since \meta{number} would be replaced by the number of entries in the
+  header line otherwise.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{on column count error}{=\meta{macros}}{no default, initially empty}
+  \meta{macros} to be executed for unfeasible data lines.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{warn on column count error}{}{style, no value}
+  Display of a warning for unfeasible data lines.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{filter}{=\meta{condition}}{no default}
+  Only data lines which fulfill a logical \meta{condition} are accepted.
+  For the \meta{condition}, every term from the |ifthen| package \cite{carlisle:2001b}
+  is feasible.
+  To preprocess the data line before testing the \meta{condition},
+  the option key \refKey{/csv/before filter} can be used.
+\end{docCsvKey}
+
+\begin{docCsvKey}{no filter}{}{no value, initially set}
+  Clears a set filter.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{filter accept all}{}{no value, initially set}
+  Alias for |no filter|. All consistent data lines are accepted.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{filter reject all}{}{no value}
+  All data line are ignored.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{filter equal}{=\marg{string A}\marg{string B}}{style, no default}
+  Only lines where \meta{string A} and \meta{string B} are equal after expansion
+  are accepted.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{filter not equal}{=\marg{string A}\marg{string B}}{style, no default}
+  Only lines where \meta{string A} and \meta{string B} are not equal after expansion
+  are accepted.
+\end{docCsvKey}
+
+
+%]]
+
+
+\clearpage
+\subsection{Table Support}\label{subsec:tabsupport}%--------%[[
+
+\begin{docCsvKey}{tabular}{=\meta{table format}}{style, no default}
+  Surrounds the CSV processing with |\begin{tabular}|\marg{table format}
+  at begin and with |\end{tabular}| at end.
+Additionally, the commands defined by the key values of
+  \refKey{/csv/before table}, \refKey{/csv/table head}, \refKey{/csv/table foot},
+  and \refKey{/csv/after table} are executed at the appropriate places.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{centered tabular}{=\meta{table format}}{style, no default}
+  Like \refKey{/csv/tabular} but inside an additional |center| environment.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{longtable}{=\meta{table format}}{style, no default}
+  Like \refKey{/csv/tabular} but for the |longtable| environment.
+  This requires the package |longtable| (not loaded automatically).
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{tabbing}{}{style, no value}
+  Like \refKey{/csv/tabular} but for the |tabbing| environment.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{centered tabbing}{}{style, no value}
+  Like \refKey{/csv/tabbing} but inside an additional |center| environment.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{no table}{}{style, no value}
+  Deactivates |tabular|, |longtable|, and |tabbing|.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{before table}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed before |\begin{tabular}| or before |\begin{longtable}|
+  or before |\begin{tabbing}|, respectively.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{table head}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after |\begin{tabular}| or after |\begin{longtable}|
+  or after |\begin{tabbing}|, respectively.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{table foot}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed before |\end{tabular}| or before |\end{longtable}|
+  or before |\end{tabbing}|, respectively.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{after table}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} to be executed after |\end{tabular}| or after |\end{longtable}|
+  or after |\end{tabbing}|, respectively.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{autotabular}{=\meta{file name}}{no default}
+  Reads the whole CSV file denoted \meta{file name} with an automated formatting.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{autolongtable}{=\meta{file name}}{no default}
+  Reads the whole CSV file denoted \meta{file name} with an automated formatting
+  using the required |longtable| package.
+\end{docCsvKey}
+
+
+\clearpage
+\subsection{Miscellaneous}%
+
+\begin{docCsvKey}{every csv}{}{style, initially empty}
+  A style definition which is used for every following CSV file.
+  This definition can be overwritten with user code.
+\begin{dispListing}
+% Sets a warning message for unfeasible data lines.
+\csvset{every csv/.style={warn on column count error}}
+% Alternatively:
+\csvstyle{every csv}{warn on column count error}
+\end{dispListing}
+\end{docCsvKey}
+
+\begin{docCsvKey}{default}{}{style}
+  A style definition which is used for every following CSV file which
+  resets all settings to default values\footnote{\texttt{default} is used
+  because of the global nature of most settings.}.
+  This key should not be used or changed by the user if there is not a
+  really good reason (and you know what you do).
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{file}{=\meta{file name}}{no default, initially |unknown.csv|}
+  Sets the \meta{file name} of the CSV file to be processed.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{preprocessed file}{=\meta{file name}}{no default, initially unused}
+  Sets the \meta{file name} of the CSV file which is the output of a
+  preprocessor.
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{preprocessor}{=\meta{macro}}{no default}
+  Defines a preprocessor for the given CSV file.
+  The \meta{macro} has to have two mandatory arguments. The first argument
+  is the original CSV file which is set by \refKey{/csv/file}.
+  The second argument is the preprocessed CSV file
+  which is set by \refKey{/csv/preprocessed file}.\par\smallskip
+  Typically, the \meta{macro} may call an external program which preprocesses
+  the original CSV file (e.\,g. sorting the file) and creates the
+  preprocessed CSV file. The later file is used by \refCom{csvreader}
+  or \refCom{csvloop}.
+\begin{dispListing}
+\newcommand{\mySortTool}[2]{%
+  % call to an external program to sort file #1 with resulting file #2
+}
+
+\csvreader[%
+  preprocessed file=\jobname_sorted.csv,
+  preprocessor=\mySortTool,
+  ]{some.csv}{}{%
+  % do something
+}
+\end{dispListing}
+\end{docCsvKey}
+
+
+\begin{docCsvKey}{no preprocessing}{}{style, no value, initially set}
+  Clears any preprocessing, i.\,e. preprocessing is switched of.
+\end{docCsvKey}
+
+
+
+\clearpage
+\section{Examples}%
+
+\subsection{A Serial Letter}%
+In this example, a serial letter is to be written to all persons with
+addresses from the following CSV file. Deliberately, the file content is
+not given in very pretty format.
+
+%-- file embedded for simplicity --
+\begin{tcbverbatimwrite}{address.csv}
+name,givenname,gender,degree,street,zip,location,bonus
+Maier,Hans,m,,Am Bachweg 17,10010,Hopfingen,20
+    % next line with a comma in curly braces
+Huber,Erna,f,Dr.,{Moosstra\ss{}e 32, Hinterschlag},10020,\"{O}rtingstetten,30
+Wei\ss{}b\"{a}ck,Werner,m,Prof. Dr.,Brauallee 10,10030,Klingenbach,40
+    % this line is ignored %
+  Siebener ,  Franz,m,   ,  Blaumeisenweg 12  , 10040 ,  Pardauz , 50
+    % preceding and trailing spaces in entries are removed %
+Schmitt,Anton,m,,{\AE{}lfred-Esplanade, T\ae{}g 37}, 10050,\OE{}resung,60
+\end{tcbverbatimwrite}
+%-- end embedded file --
+
+\csvlisting{address}
+
+Firstly, we survey the file content quickly using
+|\csvautotabular|.
+As can be seen, unfeasible lines are ignored automatically.
+
+\begin{dispExample}
+\tiny\csvautotabular{address.csv}
+\end{dispExample}
+
+Now, we create the serial letter where every feasible data line produces
+an own page. Here, we simulate the page by a |tcolorbox| (from the package
+|tcolorbox|).
+For the gender specific salutations, an auxiliary macro |\ifmale| is
+introduced.
+
+\begin{dispExample}
+% this example requires the tcolorbox package
+\newcommand{\ifmale}[2]{\ifthenelse{\equal{\gender}{m}}{#1}{#2}}
+
+\csvreader[head to column names]{address.csv}{}{%
+\begin{tcolorbox}[colframe=DarkGray,colback=White,arc=0mm,width=(\linewidth-2pt)/2,
+                  before=,after=\hfill,title={Letter to \name},fonttitle=\bfseries]
+  \ifthenelse{\equal{\degree}{}}{\ifmale{Mr.}{Ms.}}{\degree}~\givenname~\name\\
+  \street\\\zip~\location
+  \tcblower
+  {\itshape Dear \ifmale{Sir}{Madam},}\\
+  we are pleased to announce you a bonus value of \bonus\%{}
+  which will be delivered to \location\ soon.\\\ldots
+\end{tcolorbox}}
+\end{dispExample}
+
+
+
+\clearpage
+\subsection{A Graphical Presentation}%
+For this example, we use some artificial statistical data given by a CSV file.
+
+%-- file embedded for simplicity --
+\begin{tcbverbatimwrite}{data.csv}
+land,group,amount
+Bayern,A,1700
+Baden-W\"{u}rttemberg,A,2300
+Sachsen,B,1520
+Th\"{u}ringen,A,1900
+Hessen,B,2100
+\end{tcbverbatimwrite}
+%-- end embedded file --
+
+\csvlisting{data}
+
+Firstly, we survey the file content using
+|\csvautotabular|.
+
+\begin{dispExample}
+\csvautotabular{data.csv}
+\end{dispExample}
+
+The amount values are presented in the following diagram by bars where
+the group classification is given using different colors.
+
+\begin{dispExample}
+% This example requires the package tikz
+\begin{tikzpicture}[Group/A/.style={left color=red!10,right color=red!20},
+                    Group/B/.style={left color=blue!10,right color=blue!20}]
+\csvreader[head to column names]{data.csv}{}{%
+  \begin{scope}[yshift=-\thecsvrow cm]
+  \path [draw,Group/\group] (0,-0.45)
+    rectangle node[font=\bfseries] {\amount} (\amount/1000,0.45);
+  \node[left] at (0,0) {\land};
+  \end{scope}  }
+\end{tikzpicture}
+\end{dispExample}
+
+\clearpage
+Next, we create a pie chart by calling |\csvreader| twice.
+In the first step, the total sum of amounts is computed, and in the second
+step the slices are drawn.
+
+\begin{dispExample}
+% Modified example from www.texample.net for pie charts
+% This example needs the packages tikz, xcolor, calc
+\definecolorseries{myseries}{rgb}{step}[rgb]{.95,.85,.55}{.17,.47,.37}
+\resetcolorseries{myseries}%
+
+% a pie slice
+\newcommand{\slice}[4]{
+  \pgfmathsetmacro{\midangle}{0.5*#1+0.5*#2}
+  \begin{scope}
+    \clip (0,0) -- (#1:1) arc (#1:#2:1) -- cycle;
+    \colorlet{SliceColor}{myseries!!+}%
+    \fill[inner color=SliceColor!30,outer color=SliceColor!60] (0,0) circle (1cm);
+  \end{scope}
+  \draw[thick] (0,0) -- (#1:1) arc (#1:#2:1) -- cycle;
+  \node[label=\midangle:#4] at (\midangle:1) {};
+  \pgfmathsetmacro{\temp}{min((#2-#1-10)/110*(-0.3),0)}
+  \pgfmathsetmacro{\innerpos}{max(\temp,-0.5) + 0.8}
+  \node at (\midangle:\innerpos) {#3};
+}
+
+% sum of amounts
+\csvreader[before reading=\def\mysum{0}]{data.csv}{amount=\amount}{%
+  \pgfmathsetmacro{\mysum}{\mysum+\amount}%
+}
+
+% drawing of the pie chart
+\begin{tikzpicture}[scale=3]%
+\def\mya{0}\def\myb{0}
+\csvreader[head to column names]{data.csv}{}{%
+  \let\mya\myb
+  \pgfmathsetmacro{\myb}{\myb+\amount}
+  \slice{\mya/\mysum*360}{\myb/\mysum*360}{\amount}{\land}
+}
+\end{tikzpicture}%
+\end{dispExample}
+
+
+\clearpage
+Finally, the filter option is demonstrated by separating the groups A and B.
+Every item is piled upon the appropriate stack.
+
+\begin{dispExample}
+\newcommand{\drawGroup}[2]{%
+  \def\mya{0}\def\myb{0}
+  \node[below=3mm] at (2.5,0) {\bfseries Group #1};
+  \csvreader[head to column names,filter equal={\group}{#1}]{data.csv}{}{%
+    \let\mya\myb
+    \pgfmathsetmacro{\myb}{\myb+\amount}
+    \path[draw,top color=#2!25,bottom color=#2!50]
+      (0,\mya/1000) rectangle node{\land\ (\amount)} (5,\myb/1000);
+}}
+
+\begin{tikzpicture}
+  \fill[gray!75] (-1,0) rectangle (13,-0.1);
+  \drawGroup{A}{red}
+  \begin{scope}[xshift=7cm]
+  \drawGroup{B}{blue}
+  \end{scope}
+\end{tikzpicture}
+
+\end{dispExample}
+
+
+% Actually, it is not a good idea to include the references like this!
+% Do not follow this bad example ...
+\begin{tcbverbatimwrite}{\jobname.bib}
+@manual{tantau:2010c,
+   author    = {Till Tantau},
+   title     = {The TikZ and PGF Packages},
+   subtitle  = {Manual for version 2.10},
+   url       = {http://mirror.ctan.org/graphics/pgf/base/doc/generic/pgf/pgfmanual.pdf},
+   date      = {2010-10-25},
+}
+
+@manual{carlisle:2001b,
+   author    = {David Carlisle},
+   title     = {The ifthen package},
+   url       = {http://mirror.ctan.org/macros/latex/base/},
+   Xnote      = {},
+   day       = 26,
+   month     = may,
+   year      = 2001,
+   language  = {english}
+}
+
+@manual{talbot:2009a,
+  author    = {Nicola L. C. Talbot},
+  title     = {datatool v 2.03: Databases and data manipulation},
+  url       = {http://mirror.ctan.org/macros/latex/contrib/datatool/datatool.pdf},
+  date      = {2009-11-15},
+}
+\end{tcbverbatimwrite}
+
+
+\printbibliography[heading=bibintoc]
+
+\printindex
+
+\end{document}
diff --git a/Master/texmf-dist/tex/latex/csvsimple/csvsimple.sty b/Master/texmf-dist/tex/latex/csvsimple/csvsimple.sty
index d2945adf221..545e15e638f 100644
--- a/Master/texmf-dist/tex/latex/csvsimple/csvsimple.sty
+++ b/Master/texmf-dist/tex/latex/csvsimple/csvsimple.sty
@@ -1,4 +1,4 @@
-%% The LaTeX package csvsimple - version 1.04 (2011/11/11)
+%% The LaTeX package csvsimple - version 1.05 (2012/03/12)
 %% csvsimple.sty: Simple LaTeX CSV file processing
 %%
 %% -------------------------------------------------------------------------------------------
@@ -18,7 +18,7 @@
 %% This work consists of all files listed in README
 %%
 \NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{csvsimple}[2011/11/11 version 1.04 LaTeX CSV file processing]
+\ProvidesPackage{csvsimple}[2012/03/12 version 1.05 LaTeX CSV file processing]
 
 \RequirePackage{pgfkeys,ifthen}
 
@@ -108,6 +108,10 @@
   }
 
 
+% default preprocessor (no preprocessing)
+\def\csv@no@preprocessor#1#2{\let#2=#1\relax}
+
+
 %---- the loop
 
 \def\csv@AtEndLoop{\csv@addto@macro\@endloophook}
@@ -222,13 +226,14 @@
   \global\let\@endloophook\csv@empty%
   % options
   \csvset{default,every csv,#1}%
+  \csv@preprocessor\csv@filename\csv@ppfilename%
   \csv@prereading%
   \csv@table@begin%
   \setcounter{csvinputline}{0}%
   % start reading
-  \openin\csv@file=\csv@filename\relax%
+  \openin\csv@file=\csv@ppfilename\relax%
   \ifeof\csv@file%
-    \csv@warning{File \csv@filename\ not existent, not readable, or empty!}%
+    \csv@warning{File \csv@ppfilename\ not existent, not readable, or empty!}%
   \else%
     % the head line
     \csv@opt@processheadline%
@@ -303,6 +308,9 @@
 
 \csvset{%
   file/.gstore in=\csv@filename,%
+  preprocessed file/.gstore in=\csv@ppfilename,%
+  preprocessor/.gstore in=\csv@preprocessor,%
+  no preprocessing/.style={preprocessor=\csv@no@preprocessor},
   column names reset/.code={\gdef\csv@columnnames{}},%
   column names/.code={%
       \toks0=\expandafter{\csv@columnnames}%
@@ -329,7 +337,7 @@
   filter/.code={%
     \def\temp{#1}\toks@=\expandafter{\temp}%
     \xdef\csv@iffilter{\noexpand\ifthenelse{\the\toks@}}},
-  nofilter/.code={\csvfilteraccept},
+  no filter/.code={\csvfilteraccept},
   filter reject all/.code={\csvfilterreject},
   filter accept all/.code={\csvfilteraccept},
   before filter/.gstore in=\csv@prefiltercommand,
@@ -354,13 +362,14 @@
   % default for reset
   default/.style={
     file=unknown.csv,
+    no preprocessing,
     command=\csvline,
     column names reset,
     head,
     head to column names=false,
     column count=10,
     on column count error=,
-    nofilter,
+    no filter,
     before filter=,
     before line=,
     after line=,
@@ -379,9 +388,9 @@
   %
   % styles
   every csv/.style={},
-  nohead/.style={head=false},
-  nocheckcolumncount/.style={checkcolumncount=false},
-  warn on column count error/.style={on column count error={\csv@warning{>\thecsvcol< instead of >\csv@columncount< columns for input line >\thecsvinputline< of file >\csv@filename<}}},
+  no head/.style={head=false},
+  no check column count/.style={check column count=false},
+  warn on column count error/.style={on column count error={\csv@warning{>\thecsvcol< instead of >\csv@columncount< columns for input line >\thecsvinputline< of file >\csv@ppfilename<}}},
   filter equal/.style 2 args={filter=\equal{#1}{#2}},
   filter not equal/.style 2 args={filter=\not\equal{#1}{#2}},
   tabular/.style={
@@ -418,6 +427,13 @@
     command=\csvlinetotablerow}
 }
 
+% deprecated keys
+\csvset{
+  nofilter/.style=no filter,
+  nohead/.style=no head,
+}
+
+
 \def\csvautotabular#1{\csvloop{autotabular={#1}}}
 
 \def\csvautolongtable#1{\csvloop{autolongtable={#1}}}