summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-06-28 21:55:40 +0000
committerKarl Berry <karl@freefriends.org>2013-06-28 21:55:40 +0000
commit35f4733179fc116420810062bf3bd6891f86b5d9 (patch)
tree3b0927edac46e09d985b5a5253b08757858b7ee4 /Master/texmf-dist/doc/latex/datatool/datatool-user.tex
parentefeeb862227d6416e7450a72d6f37ebba3563b20 (diff)
datatool (28jun13)
git-svn-id: svn://tug.org/texlive/trunk@31007 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/datatool/datatool-user.tex')
-rw-r--r--Master/texmf-dist/doc/latex/datatool/datatool-user.tex39
1 files changed, 28 insertions, 11 deletions
diff --git a/Master/texmf-dist/doc/latex/datatool/datatool-user.tex b/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
index a38dc6c7060..d2cb0a0eb38 100644
--- a/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
+++ b/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
@@ -82,20 +82,20 @@
\newterm[see={caiman}]{cayman}
-
\begin{document}
% Some of the commands are too long to produce nicely formatted
% paragraphs so use ragged-right:
\raggedright
+\setlength{\parindent}{1em}%
\MakeShortVerb{"}
\DeleteShortVerb{\|}
- \title{User Manual for datatool bundle version~2.13}
+ \title{User Manual for datatool bundle version~2.14}
\author{Nicola L.C. Talbot\\
\url{http://www.dickimaw-books.com/}}
- \date{2013-01-15}
+ \date{2013-06-28}
\maketitle
\pagenumbering{roman}
@@ -110,7 +110,7 @@ The \styfmt{datatool} bundle comes with the following documentation:
\item[\url{datatool-code.pdf}]
Advanced users wishing to know more about the inner workings of
all the packages provided in the \styfmt{datatool} bundle should
- read \qt{Documented Code for datatool v2.13}
+ read \qt{Documented Code for datatool v2.14}
\item[INSTALL] Installation instructions.
@@ -2004,8 +2004,8 @@ attempting to use it as such is like trying to fasten a screw
with a knife instead of a screwdriver: it can be done, but requires
great care and is more time consuming. Version 2.0 of the
\sty{datatool} package uses a completely different method of storing
-the data to previous versions.\footnote{Thanks to Morten H\o gholm
-for the suggestion.} As a result, the code is much more efficient,
+the data to previous versions.\footnote{Many thanks to Morten H\o gholm
+for providing the new code.} As a result, the code is much more efficient,
however, large databases and complex operations will still slow the
time taken to process your document. Therefore, if you can, it is
better to do the complex operations using whatever system created
@@ -2017,6 +2017,15 @@ described in \autoref{sec:advanced}, but using \TeX\ is nowhere near
as efficient as, say, using a SQL database, so don't expect too much
from this package.
+
+I'm working on a Java helper application to accompany \sty{datatool}
+called \app{datatooltk}. The source code is available on GitHub at
+\url{https://github.com/nlct/datatooltk}. I'll upload it to CTAN
+when it's ready for release. The application will allow you to edit
+files saved using \ics{DTLsaverawdb} in a~graphical interface or
+import data from a~SQL database, a~CSV file or a~\sty{probsoln}
+dataset.
+
\section{Creating a New Database}
\label{sec:newdb}
@@ -5142,7 +5151,7 @@ Gets the value from \cs{dtlcurrentrow} for the column given by
control sequence.
\begin{definition}[\DescribeMacro{\dtlreplaceentryincurrentrow}]
-\cs{dtlreplaceentryincurrentrow}\meta{new value}\marg{col idx}
+\cs{dtlreplaceentryincurrentrow}\marg{new value}\marg{col idx}
\end{definition}
Replaces the value in \cs{dtlcurrentrow} for the column given by
\meta{col idx} (an integer) with \meta{new value}.
@@ -5170,7 +5179,7 @@ Appends \meta{value} to the current row for column given by
\meta{key}. (Produces an error if there is already an entry for that
column in the current row.)
-\begin{definition}[\DescribeMacro{\dtlappendentrytocurrentrow}]
+\begin{definition}[\DescribeMacro{\dtlupdateentryincurrentrow}]
\cs{dtlupdateentryincurrentrow}\marg{key}\marg{value}
\end{definition}
Behaves like \cs{dtlappendentrytocurrentrow} if the current row
@@ -6274,6 +6283,14 @@ If \textsf{true}, the columns are balanced. If \textsf{false}, the
columns aren't balanced. If no value is specified, \textsf{true} is
assumed.
+\item[\csopt{printterms}{condition}] This specifies a boolean
+condition (as used by \ics{DTLforeach}) so you can display only
+those entries where the condition is met. For example, to only
+display entries starting with ``H'' (not including any entry that is
+just the letter ``H'') you can do:
+\begin{verbatim}
+\printterms[condition={\DTLisiopenbetween{\Name}{H}{I}}]
+\end{verbatim}
\end{description}
\subsection{Index or Glossary Styles}
@@ -7344,12 +7361,12 @@ Suppose you have a file called "groupa.csv" that contains the
following:
\DTLnewdb{groupa}\relax
\DTLnewrow{groupa}\relax
-\DTLnewdbentry{groupa}{Height}{1.55}\relax
-\DTLnewdbentry{groupa}{Weight}{45.4}\relax
-\DTLnewrow{groupa}\relax
\DTLnewdbentry{groupa}{Height}{1.54}\relax
\DTLnewdbentry{groupa}{Weight}{48.0}\relax
\DTLnewrow{groupa}\relax
+\DTLnewdbentry{groupa}{Height}{1.55}\relax
+\DTLnewdbentry{groupa}{Weight}{45.4}\relax
+\DTLnewrow{groupa}\relax
\DTLnewdbentry{groupa}{Height}{1.56}\relax
\DTLnewdbentry{groupa}{Weight}{58.0}\relax
\DTLnewrow{groupa}\relax