CTAN package update: datatool
Date: July 23, 2012 12:57:45 PM CEST
the daemon wrote:
> The following information was provided by the package's contributor.
>
> Name of contribution: datatool
> Author's name: Nicola Talbot
> Package version: 2.10
> Location on CTAN: macros/latex/contrib/datatool/
> Summary description: Tools to load and manipulate data
> License type: lppl
>
> Announcement text given by the package's contributor:
> ----------------------------------------------------------------------
> v2.10 (2012/07/18):
>
> * datatool.sty:
>
> - Split package into datatool-base.sty, datatool-fp.sty and
> datatool-pgfmath.sty
>
> - Added package option "math" (math=fp -> use fp.sty,
> math=pgfmath -> use pgfmath.sty)
>
> - datatool.sty now requires etoolbox (changed commands like
> \@ifundefined to etoolbox equivalents)
>
> - Added 'omitlines' option when loading csv file (from patch
> supplied by Bruno Le Floch
> at:
> http://tex.stackexchange.com/questions/22942/skipping-the-first-line-of-a-data-file-for-pgfplotstable/25133#25133 )
>
> - \DTLloaddb : adds default column header if missing
>
> - Added optional argument to \DTLdisplaydb
>
> - Added omit key to \DTLdisplaylongdb
>
> - added environment dtlenvgforint
>
> - added environments DTLenvforeach and DTLenvforeach*
>
> - added check for at least version 1.2 (2009/10/20) of substr.sty
>
> - added \DTLassign
>
> - added DTLnumitemsinlist
>
> - added \dtlrecombine, \dtlrecombineomitcurrent,
> \dtlreplaceentryincurrentrow, \dtlswapentriesincurrentrow,
> \dtlremoveentryincurrentrow, \dtlappendentrytocurrentrow
>
> - Rewritten \@dtl at ifDigitOrDecimalSep (code provided by Bruno Le Floch)
>
> - ensured first argument of \DTLconverttodecimal gets one-level
> expansion in commands like \DTLaddall
>
> - Fixed \DTLloaddb to work if % used at the start of a row in CSV file.
>
> - Fixed \@dtl at qlopoff to substitute escaped CSV delimiters
>
> - Fixed bug in \DTLloadrawdb, which only performed a single
> substitution per line
>
> - Added \long before \edef in \DTLsubstituteall
>
> - Fixed bug in \@dtl at getkeyforcolumn (affects
> \DTLgetkeyforcolumn)
>
> - Changed tab character to ^^I
>
> - Fixed bug in \DTLloaddb and \DTLloadrawdb when CSV file only
> contains one column
>
> * databib.bst:
>
> - Added eprints field
>
> * datatool-user.tex (User guide):
>
> - fixed typo "\value{DTLbibrow}<11" => "\value{DTLbibrow}<10"
>
> - added section "Operating on Current Row"
>
> - added remark on using etoolbox to check for empty values
> ----------------------------------------------------------------------
>
> Users may view the package catalogue entry at
> http://mirror.ctan.org/help/Catalogue/entries/datatool.html
> or they may browse the package directory at
> http://mirror.ctan.org/macros/latex/contrib/datatool/
thanks for the upload; i have installed the new version and updated the
catalogue repository.
Robin Fairbairns
For the CTAN team
datatool – Tools to load and manipulate data
The tools comprise the packages:
- datatool-base.sty: the underlying base package used by all the other packages in this bundle;
- datatool.sty: databases may be created using LaTeX commands or by importing external files; they may be sorted numerically or alphabetically; repetitive operations (such as mail merging) may be performed on each row of a database, subject to conditions to exclude particular rows; commands are provided to examine database elements, and to convert formats (for example, to convert a numeric element to a format compatible with l3fp or the fp package;
- datapie.sty: a database may be represented as a pie chart; flexible options allow colouring of the chart, and annotation hooks are available;
- dataplot.sty: a database may be represented as a 2-dimensional scatter or line plot; flexible options control of the plot's overall appearance, and of legends and other extra information;
- databar.sty: a database may be represented as a bar chart; overall appearance, colouring and annotation are controllable;
- datagidx.sty: provides a way of indexing or creating glossaries/lists of abbreviations that uses TeX to do the sorting and collating instead of using an external indexing application, such as xindy or makeindex (although you may prefer \printnoidxglossary now provided by the glossaries package);
- databib.sty: a bibliography may be loaded into a datatool database, and manipulated there before being printed (this permits a LaTeX-based route to printing bibliographies in formats for which no BibTeX style is available, although biblatex is now the better route); and
- person.sty: provides support for displaying a person’s name and pronoun in a document, thus avoiding cumbersome use of “he/she”, etc.
The drawing packages make use of PGF/TikZ for their output.
Localisation support needs to be installed separately. See datatool-regions and datatool-english.
The bundle supersedes and replaces the author’s csvtools bundle.
| Package | datatool |
| Version | 3.4.1 2025-04-25 |
| Copyright | 2007–2025 Nicola Talbot |
| Maintainer | Nicola Talbot |