From 38ec9aef43ec2ac43feceade32200c22d6e1c436 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 9 Mar 2014 21:36:55 +0000 Subject: datatool git-svn-id: svn://tug.org/texlive/trunk@33136 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/datatool/CHANGES | 22 ++++++++++ Master/texmf-dist/doc/latex/datatool/README | 4 +- .../doc/latex/datatool/datatool-code.pdf | Bin 913625 -> 918044 bytes .../doc/latex/datatool/datatool-user.pdf | Bin 601441 -> 603313 bytes .../doc/latex/datatool/datatool-user.tex | 47 ++++++++++++++++----- .../doc/latex/datatool/samples/sample-barchart.pdf | Bin 35074 -> 35074 bytes .../latex/datatool/samples/sample-datatooltk.pdf | Bin 22860 -> 22860 bytes .../doc/latex/datatool/samples/sample-dict.pdf | Bin 122594 -> 122594 bytes .../latex/datatool/samples/sample-europecv-bib.pdf | Bin 0 -> 89562 bytes .../latex/datatool/samples/sample-europecv-bib.tex | 19 +++++++++ .../doc/latex/datatool/samples/sample-gidx.pdf | Bin 180122 -> 179875 bytes .../doc/latex/datatool/samples/sample-glossary.pdf | Bin 104729 -> 104484 bytes .../doc/latex/datatool/samples/sample-index.pdf | Bin 128783 -> 128783 bytes .../latex/datatool/samples/sample-mail-merge.pdf | Bin 21885 -> 21619 bytes .../doc/latex/datatool/samples/sample-piechart.pdf | Bin 33964 -> 33964 bytes .../doc/latex/datatool/samples/sample-sort.pdf | Bin 61053 -> 61053 bytes .../datatool/samples/sample-student-scores.pdf | Bin 34615 -> 34615 bytes .../latex/datatool/samples/sample-two-per-row.pdf | Bin 31752 -> 31752 bytes 18 files changed, 79 insertions(+), 13 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.pdf create mode 100644 Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.tex (limited to 'Master/texmf-dist/doc/latex/datatool') diff --git a/Master/texmf-dist/doc/latex/datatool/CHANGES b/Master/texmf-dist/doc/latex/datatool/CHANGES index ef25ed86ad0..ff065adeb16 100644 --- a/Master/texmf-dist/doc/latex/datatool/CHANGES +++ b/Master/texmf-dist/doc/latex/datatool/CHANGES @@ -1,3 +1,25 @@ +v2.21: + + * datatool: + + - Fixed misplaced locations of \dtldisplaystarttab and + \dtldisplayafterhead within \DTLdisplaylongdb + + - Fixed bug in \dtl@gathervalues that ignored #3 + + * databib: + + - Added \gDTLforeachbibentry + + - Fixed bug in \DTLforeachbibentry* + + - fixed typo in documentation + \DTLforeachbib -> \DTLforeachbibentry + + * datagidx: + + - Fixed bug in \datagidx@parse@location + v2.20: * datatool: diff --git a/Master/texmf-dist/doc/latex/datatool/README b/Master/texmf-dist/doc/latex/datatool/README index 283cdcb7a0f..df1c3a5b00b 100644 --- a/Master/texmf-dist/doc/latex/datatool/README +++ b/Master/texmf-dist/doc/latex/datatool/README @@ -1,6 +1,6 @@ -LaTeX Bundle : datatool v2.20 +LaTeX Bundle : datatool v2.21 -Last Modified : 2014-02-03 +Last Modified : 2014-03-08 Author : Nicola Talbot diff --git a/Master/texmf-dist/doc/latex/datatool/datatool-code.pdf b/Master/texmf-dist/doc/latex/datatool/datatool-code.pdf index 9d28367745b..7c25b37d2b8 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/datatool-code.pdf and b/Master/texmf-dist/doc/latex/datatool/datatool-code.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/datatool-user.pdf b/Master/texmf-dist/doc/latex/datatool/datatool-user.pdf index 9833f3266f6..65f3f640479 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/datatool-user.pdf and b/Master/texmf-dist/doc/latex/datatool/datatool-user.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/datatool-user.tex b/Master/texmf-dist/doc/latex/datatool/datatool-user.tex index db2f306c297..25ab4e4d173 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.20} + \title{User Manual for datatool bundle version~2.21} \author{Nicola L.C. Talbot\\ \url{http://www.dickimaw-books.com/}} - \date{2014-02-03} + \date{2014-03-08} \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.20} + read \qt{Documented Code for datatool v2.21} \item[INSTALL] Installation instructions. @@ -2723,18 +2723,25 @@ Specifies how to separate rows. Defaults to just \end{definition} This is a hook to add something at the beginning of the \env{tabular} environment. This defaults to nothing. +In the case of \cs{DTLdisplaylongdb}, this hook is done before the +header row on each page of the \env{longtable}. \begin{definition}[\DescribeMacro{\dtldisplayendtab}]% \cs{dtldisplayendtab} \end{definition} This is a hook to add something at the end of the \env{tabular} environment. This defaults to nothing. +In the case of \cs{DTLdisplaylongdb}, this hook is only done on the +\emph{last} page of the \env{longtable}. You have to use the +\texttt{foot} option to specify some code to do at the end of each page. \begin{definition}[\DescribeMacro{\dtldisplayafterhead}]% \cs{dtldisplayafterhead} \end{definition} This is a hook to add something after the header row, before the first row of data. This defaults to nothing. +In the case of \cs{DTLdisplaylongdb}, this hook is done after the +header row on each page of the \env{longtable}. \begin{definition}[\DescribeMacro{\dtldisplaystartrow}]% \cs{dtldisplaystartrow} @@ -5596,7 +5603,9 @@ The \sty{datagidx} package is provided as an alternative to the indexing application, such as \app{xindy} or \app{makeindex}, it uses the database mechanism of the \sty{datatool} package. \emph{\sty{datagidx} and \sty{glossaries} -are not compatible.} +are not compatible.} (Note: \sty{glossaries} version 4.04 now has an +option that uses \TeX\ to sort the glossaries instead of using +\app{makeindex} or \app{xindy}.) First a repeat of the caveat at the start of this manual: \begin{important} @@ -9019,7 +9028,7 @@ For example, you may want to sort the bibliography in reverse chronological order. Once you have sorted the bibliography, you can display it using \cs{DTLbibliography}, described in \autoref{sec:thebib}, or you can iterate through the database -using \cs{DTLforeachbib}, described in \autoref{sec:foreachbib}. +using \cs{DTLforeachbibentry}, described in \autoref{sec:foreachbib}. Note that the \sty{databib} package is not automatically loaded by \sty{datatool}, so if @@ -9759,16 +9768,28 @@ not meet your needs. For example, you may be required to list journal papers and conference proceedings in separate sections. In which case, you may find it easier to iterate through the bibliography using: -\begin{definition}[\DescribeMacro{\DTLforeachbib}]% -\cs{DTLforeachbib}\oarg{condition}\marg{db name}\marg{text} +\begin{definition}[\DescribeMacro{\DTLforeachbibentry}]% +\cs{DTLforeachbibentry}\oarg{condition}\marg{db name}\marg{text} \end{definition} -\begin{definition}[\DescribeMacro{\DTLforeachbib*}]% -\cs{DTLforeachbib*}\oarg{condition}\marg{db name}\marg{text} +\begin{definition}[\DescribeMacro{\DTLforeachbibentry*}]% +\cs{DTLforeachbibentry*}\oarg{condition}\marg{db name}\marg{text} \end{definition} This iterates through the \sty{databib} database called \meta{db name} and does \meta{text} if \meta{condition} is met. As with \cs{DTLforeach}, the starred version is read-only. +\cs{DTLforeachbibentry} only makes local assignments, which means that it's unsuitable to display the references +in a~\env{tabular}-like environment (for example, the +\env{europecv} environment provided by the \cls{europecv} class). It's also a~short command, so +\meta{text} can't contain any paragraph breaks. Instead you can use +the analogous commands: +\begin{definition}[\DescribeMacro{\gDTLforeachbibentry}]% +\cs{gDTLforeachbibentry}\oarg{condition}\marg{db name}\marg{text} +\end{definition} +\begin{definition}[\DescribeMacro{\gDTLforeachbibentry*}]% +\cs{gDTLforeachbibentry*}\oarg{condition}\marg{db name}\marg{text} +\end{definition} + For each row of the database, the following commands are set: \begin{itemize} \item \cs{DBIBcitekey} \DescribeMacro{\DBIBcitekey}This is the @@ -9821,7 +9842,11 @@ This formats the bibliography entry for the current row. It checks for the existence of the command \cs{DTLformat}\meta{entry type}, where \meta{entry type} is given by \cs{DBIBentrytype}. These commands are defined -by the bibliography style. +by the bibliography style. There is also a~version for use with +\cs{gDTLforeachbibentry}: +\begin{definition}[\DescribeMacro{\gDTLformatbibentry}]% +\cs{gDTLformatbibentry} +\end{definition} \begin{definition}[\DescribeMacro{\DTLcomputewidestbibentry}]% \cs{DTLcomputewidestbibentry}\marg{conditions}\marg{db @@ -9835,7 +9860,7 @@ argument of the \env{thebibliography} environment. The counter \desctr{DTLbibrow} keeps track of the current bibliography entry. This is reset at the start of each -\cs{DTLforeachbib} and is incremented if \meta{conditions} +\cs{DTLforeachbibentry} and is incremented if \meta{conditions} is met. Within the optional argument \meta{condition}, you may use any of the diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-barchart.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-barchart.pdf index b150c9f9fef..32105fbb3df 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-barchart.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-barchart.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-datatooltk.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-datatooltk.pdf index 0758d182ba8..4a1f512a56b 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-datatooltk.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-datatooltk.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-dict.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-dict.pdf index 160f341c484..73c3569c736 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-dict.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-dict.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.pdf new file mode 100644 index 00000000000..63ad2749252 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.tex b/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.tex new file mode 100644 index 00000000000..cecc23010df --- /dev/null +++ b/Master/texmf-dist/doc/latex/datatool/samples/sample-europecv-bib.tex @@ -0,0 +1,19 @@ +\documentclass[narrow,helvetica,a4paper]{europecv} + +\usepackage[T1]{fontenc} +\usepackage{graphicx} +\usepackage{databib} + +\begin{document} +\DTLloadbbl{myrefs}{xampl.bib} +\nocite{*} + +\begin{europecv} + \ecvsection{Publications} + + \gDTLforeachbibentry*{myrefs}{% + \ecvitem{}{\gDTLformatbibentry}% +} +\end{europecv} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-gidx.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-gidx.pdf index 74bef9cc213..63df880b647 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-gidx.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-gidx.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-glossary.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-glossary.pdf index 1efa20caaa6..d9fc71b212b 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-glossary.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-glossary.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-index.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-index.pdf index 1fd01ce35b8..47f289c4994 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-index.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-index.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-mail-merge.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-mail-merge.pdf index 18c7c59c940..3f5eb9cde7f 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-mail-merge.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-mail-merge.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-piechart.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-piechart.pdf index 92223a3d67d..0d57d1b5653 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-piechart.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-piechart.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-sort.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-sort.pdf index 06ddbdc1fe2..9491afb760f 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-sort.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-sort.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-student-scores.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-student-scores.pdf index 0ac59407a3e..536af516690 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-student-scores.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-student-scores.pdf differ diff --git a/Master/texmf-dist/doc/latex/datatool/samples/sample-two-per-row.pdf b/Master/texmf-dist/doc/latex/datatool/samples/sample-two-per-row.pdf index 0832275c680..85a9334a3b7 100644 Binary files a/Master/texmf-dist/doc/latex/datatool/samples/sample-two-per-row.pdf and b/Master/texmf-dist/doc/latex/datatool/samples/sample-two-per-row.pdf differ -- cgit v1.2.3