datatool new version

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

5 files changed, 185 insertions, 133 deletions

diff --git a/Master/texmf-dist/doc/latex/datatool/CHANGES b/Master/texmf-dist/doc/latex/datatool/CHANGES
new file mode 100644
index 00000000000..4b9d5b36183
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datatool/CHANGES
@@ -0,0 +1,80 @@
+v2.0 (2009/02/27):
+ datatool.sty:
+
+ * Rewritten database internal representation to make the code
+   faster (thanks to Morten H\o gholm for the suggestion)
+ * added etex as a required package
+ * Database columns can now have an associated header (in addition
+   to the key)
+ * added \DTLdisplaydb and \DTLdisplaylongdb
+ * added \DTLremoverow
+ * \DTLloaddb, \DTLloadrawdb:
+     - removed unnecessary checks to determine if database 
+       exists when adding entries.
+     - added optional argument
+     - can now also load files without header row
+ * \DTLsumforkeys, \DTLmeanforkeys, \DTLvarianceforkeys,
+   \DTLsdforkeys, \DTLminforkeys and \DTLmaxforkeys now have a 
+   second optional argument
+ * added \DTLsumcolumn, \DTLmeanforcolumn, \DTLvarianceforcolumn,
+   \DTLsdforcolumn, \DTLminforcolumn and \DTLmaxforcolumn
+ * added \dtlforeachkey
+ * added \dtlforint and \dtlgforint
+ * added \dtlforcolumn and \dtlforcolumnidx
+ * added \DTLcolumncount
+ * added starred versions of:
+   - \DTLifdbempty
+   - \DTLnewrow
+ * added \DTLifhaskey
+ * added \DTLgetcolumnindex
+ * added \DTLunsettype, \DTLstringtype, \DTLinttype, \DTLrealtype
+   and \DTLcurrencytype
+ * added \DTLgetdatatype 
+ * removed \@dtl@setidtype
+ * removed \@dtl@setkeys
+ * removed \@dtl@getidtype
+ * removed \@dtl@ifrowcontains
+ * removed \dtl@getentryvalue
+ * removed \dtl@getentryid
+ * added \dtlgetentryfromcurrentrow
+ * added \dtlforcolumnindex
+
+ dataplot.sty
+ * fixed bug causing ! Argument of \pgfmath@afterquick has an extra }
+   error
+
+ databar.sty
+ * added \DTLeverybarhook
+
+v1.01 (2007/08/17) :
+ * Added databib package.
+
+ * datatool.sty:
+
+   - Fixed bug in datatool caused when certain commands occur
+     in database entries or when the data type is tested.
+   - Fixed bug in \DTLsubstituteall (caused problems when certain
+   - commands occurred in string)
+   - Added \DTLsplitstring
+   - Added \DTLifSubString and \DTLisSubString
+   - Added \DTLifStartsWith and \DTLisPrefix
+   - Added case insensitive string tests
+   - \DTLinitials and \DTLstoreinitials now work with ~ and \space
+   - \DTLinitials and \DTLstoreinitials now use \DTLinitialhyphen
+   - Added \dtlcompare (no longer using compare.tex)
+   - Added \DTLgetvalueforkey
+   - Added \DTLgetrowforkey
+   - Added optional argument to \DTLsort
+   - Fixed bug causing expansion in \DTLsort
+   - Fixed bug in \DTLsdforall and \DTLvarianceforall
+   - Removed extraneous spaces in \DTLaddall, \DTLminall, 
+     \DTLmaxall, \DTLmeanforall, \DTLsdforall and \DTLvarianceforall
+   - Fixed bug in \DTLiflastrow
+   - Fixed bug in \DTLremovecurrentrow
+
+ * Manual:
+   - added code that produces fig "Student Marks (with average scores".
+   - fixed typos in examples "Editing Database Rows" & "Mail Merging"
+   - added section on null values
+
+v1.0 (2007/07/23) : Initial Release
diff --git a/Master/texmf-dist/doc/latex/datatool/README b/Master/texmf-dist/doc/latex/datatool/README
index 581ed50375f..ad9f718294a 100644
--- a/Master/texmf-dist/doc/latex/datatool/README
+++ b/Master/texmf-dist/doc/latex/datatool/README
@@ -1,101 +1,105 @@
-LaTeX Bundle : datatool v1.01 (datatool.sty, datapie.sty, dataplot.sty, databar.sty, databib.sty)
-
-Last Modified : 17 Aug 2007
-
-Author        : Nicola Talbot
-
-datatool.sty:
-
- Databases can be created using LaTeX commands or loaded
- from external ASCII files, such as comma or tab separated
- variable files.
-
- Databases can be sorted numerically or alphabetically
- (descending or ascending.)
-
- Repetitive operations can be performed on each row of
- data in a database (such as mail merging.) Conditions
- can be imposed to exclude rows.
-
- Commands are provided to determine if an argument is
- an integer, a real number, currency or a string.
- (Scientific notation is currently not supported.)
-
- Locale dependent number settings are supported 
- (such as a comma as a decimal character and full stop as 
- a number group character.)
-
- Commands are provided to convert between locale dependent
- numbers/currency and the standard decimal format required 
- by the fp package enabling fixed point arithmetic to be 
- performed on elements of the database.
-
- Strings can be tested to determine if they are all upper
- or all lower case.
-
- Names can be converted to initials using \DTLinitials.
-
-datapie.sty:
-
- A database defined by datatool.sty can be converted into a 
- pie chart.
-
- Segments can be separated from the rest of the chart to make
- them stand out.
-
- Colour/grey scale options.
-
- Predefined segment colours can be changed.
-
- Hooks provided to annotate chart.
-
-dataplot.sty:
-
- A database defined by datatool.sty may be plotted as a 2D
- scatter or line plot
-
- Settings provided to govern the appearance of the chart.
- (e.g. show/hide axes, legend, grid, major/minor tick marks.)
-
- Hooks provided to add extra information to the plot
-
-databar.sty:
-
- A database defined by datatool.sty can be converted into a 
- bar chart.
-
- Colour/grey scale options.
-
- Predefined bar colours can be changed.
-
- Horizontal or vertical formats provided.
-
- Hooks provided to annotate chart.
-
-databib.sty:
-
- Provides commands to convert a BibTeX database into a datatool
- database.
-
-*The datatool bundle replaces the csvtools bundle which is now obsolete.*
-
-The datatool.sty package requires the following packages/files:
-
-xkeyval
-xfor
-fp
-substr
-
-The datapie.sty, dataplot.sty and databar.sty packages requires 
-the tikz/pgf package.
-
-*Remember to refresh TeX's database*
-
-The package and documentation source code is also supplied as a
-dtx and ins file located in texmf/source.
-
-This material is subject to the LaTeX Project Public License. 
-See  http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the details of that license.
-
-http://theoval.cmp.uea.ac.uk/~nlct/
-
+LaTeX Bundle : datatool v2.0 (datatool.sty, datapie.sty, dataplot.sty, databar.sty, databib.sty)

+

+Last Modified : 27 February 2009

+

+Author        : Nicola Talbot

+

+datatool.sty:

+

+ Databases can be created using LaTeX commands or loaded

+ from external ASCII files, such as comma or tab separated

+ variable files.

+

+ Databases can be sorted numerically or alphabetically

+ (descending or ascending.)

+

+ Repetitive operations can be performed on each row of

+ data in a database (such as mail merging.) Conditions

+ can be imposed to exclude rows.

+

+ Commands are provided to determine if an argument is

+ an integer, a real number, currency or a string.

+ (Scientific notation is currently not supported.)

+

+ Locale dependent number settings are supported 

+ (such as a comma as a decimal character and full stop as 

+ a number group character.)

+

+ Commands are provided to convert between locale dependent

+ numbers/currency and the standard decimal format required 

+ by the fp package enabling fixed point arithmetic to be 

+ performed on elements of the database.

+

+ Strings can be tested to determine if they are all upper

+ or all lower case.

+

+ Names can be converted to initials using \DTLinitials.

+

+datapie.sty:

+

+ A database defined by datatool.sty can be converted into a 

+ pie chart.

+

+ Segments can be separated from the rest of the chart to make

+ them stand out.

+

+ Colour/grey scale options.

+

+ Predefined segment colours can be changed.

+

+ Hooks provided to annotate chart.

+

+dataplot.sty:

+

+ A database defined by datatool.sty may be plotted as a 2D

+ scatter or line plot

+

+ Settings provided to govern the appearance of the chart.

+ (e.g. show/hide axes, legend, grid, major/minor tick marks.)

+

+ Hooks provided to add extra information to the plot

+

+databar.sty:

+

+ A database defined by datatool.sty can be converted into a 

+ bar chart.

+

+ Colour/grey scale options.

+

+ Predefined bar colours can be changed.

+

+ Horizontal or vertical formats provided.

+

+ Hooks provided to annotate chart.

+

+databib.sty:

+

+ Provides commands to convert a BibTeX database into a datatool

+ database.

+

+*The datatool bundle replaces the csvtools bundle which is now obsolete.*

+

+REQUIRED PACKAGES:

+

+The datatool.sty package requires the following packages/files:

+

+xkeyval

+ifthen

+xfor

+fp

+substr

+etex

+

+The datapie.sty, dataplot.sty and databar.sty packages 

+additionally require the tikz/pgf bundle.

+

+*Remember to refresh TeX's database*

+

+The package and documentation source code is also supplied as a

+dtx and ins file located in texmf/source.

+

+This material is subject to the LaTeX Project Public License. 

+See  http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the details of that license.

+

+http://theoval.cmp.uea.ac.uk/~nlct/

+

diff --git a/Master/texmf-dist/doc/latex/datatool/datatool.pdf b/Master/texmf-dist/doc/latex/datatool/datatool.pdf
new file mode 100644
index 00000000000..d45aac71de9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/datatool/datatool.pdf
diff --git a/Master/texmf-dist/doc/latex/datatool/doc/CHANGES b/Master/texmf-dist/doc/latex/datatool/doc/CHANGES
deleted file mode 100644
index a898c349e78..00000000000
--- a/Master/texmf-dist/doc/latex/datatool/doc/CHANGES
+++ /dev/null
@@ -1,32 +0,0 @@
-v1.01 (2007/08/17) :
- * Added databib package.
-
- * datatool.sty:
-
-   - Fixed bug in datatool caused when certain commands occur
-     in database entries or when the data type is tested.
-   - Fixed bug in \DTLsubstituteall (caused problems when certain
-   - commands occurred in string)
-   - Added \DTLsplitstring
-   - Added \DTLifSubString and \DTLisSubString
-   - Added \DTLifStartsWith and \DTLisPrefix
-   - Added case insensitive string tests
-   - \DTLinitials and \DTLstoreinitials now work with ~ and \space
-   - \DTLinitials and \DTLstoreinitials now use \DTLinitialhyphen
-   - Added \dtlcompare (no longer using compare.tex)
-   - Added \DTLgetvalueforkey
-   - Added \DTLgetrowforkey
-   - Added optional argument to \DTLsort
-   - Fixed bug causing expansion in \DTLsort
-   - Fixed bug in \DTLsdforall and \DTLvarianceforall
-   - Removed extraneous spaces in \DTLaddall, \DTLminall, 
-     \DTLmaxall, \DTLmeanforall, \DTLsdforall and \DTLvarianceforall
-   - Fixed bug in \DTLiflastrow
-   - Fixed bug in \DTLremovecurrentrow
-
- * Manual:
-   - added code that produces fig "Student Marks (with average scores".
-   - fixed typos in examples "Editing Database Rows" & "Mail Merging"
-   - added section on null values
-
-v1.0 (2007/07/23) : Initial Release
diff --git a/Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf b/Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf
deleted file mode 100644
index eb622488c8e..00000000000
--- a/Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf
+++ /dev/null