summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/datatool/datatool-user.tex')
-rw-r--r--Master/texmf-dist/doc/latex/datatool/datatool-user.tex28
1 files changed, 23 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/latex/datatool/datatool-user.tex b/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
index 07da5dd87a8..d641d8a5f3a 100644
--- a/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
+++ b/Master/texmf-dist/doc/latex/datatool/datatool-user.tex
@@ -91,11 +91,11 @@
\MakeShortVerb{"}
\DeleteShortVerb{\|}
- \title{User Manual for datatool bundle version~2.17}
+ \title{User Manual for datatool bundle version~2.18}
\author{Nicola L.C. Talbot\\
\url{http://www.dickimaw-books.com/}}
- \date{2013-08-29}
+ \date{2013-09-06}
\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.17}
+ read \qt{Documented Code for datatool v2.18}
\item[INSTALL] Installation instructions.
@@ -1328,6 +1328,11 @@ match.
\chapter{Fixed Point Arithmetic}
\label{sec:fp}
+\begin{important}
+The \sty{datatool} bundle doesn't support scientific
+notation.
+\end{important}
+
The \sty{datatool-base} package uses either the \sty{fp} or the \sty{pgfmath} package to perform
fixed point arithmetic, however all numbers must be converted
from the locale dependent format into the format required by the
@@ -1423,6 +1428,19 @@ back into the locale format using
Note that since these commands use \cs{DTLconverttodecimal} the
caveat above regarding expansion also applies to all the commands.
+\begin{important}
+If you don't require currency or locale conversion, you can reduce
+the package overheads by using the commands defined in the
+\sty{datatool-fp} or \sty{datatool-pgfmath} packages which provide
+interface commands to \sty{fp} or \sty{pgfmath}, respectively.
+(See sections~\ref*{sec:code:datatool-fp}
+and~\ref*{sec:code:datatool-pgfmath} of the documented code,
+\texttt{datatool-code.pdf}.)
+Alternatively, you can just use the \sty{fp} or \sty{pgfmath}
+commands explicitly. (See the \sty{fp} or \sty{pgf} manuals for
+further details.)
+\end{important}
+
\begin{definition}[\DescribeMacro{\DTLadd}]%
\cs{DTLadd}\marg{cmd}\marg{num1}\marg{num2}
@@ -8387,10 +8405,10 @@ The \sty{databar} package options are as follows:
\begin{definition}[\DescribeMacro{\DTLbarchart}]%
-\cs{DTLbarchart}\oarg{condition}\marg{db name}\marg{settings}\marg{values}
+\cs{DTLbarchart}\oarg{condition}\marg{settings}\marg{db name}\marg{values}
\end{definition}
\begin{definition}[\DescribeMacro{\DTLmultibarchart}]%
-\cs{DTLmultibarchart}\oarg{condition}\marg{db name}\marg{settings}\marg{values}
+\cs{DTLmultibarchart}\oarg{condition}\marg{settings}\marg{db name}\marg{values}
\end{definition}
These commands both create a bar chart from the information in
the database \meta{db name}, where \meta{condition} is the same