From de3f0b6a3f872b5de7a6efb9d84a368e5c059f61 Mon Sep 17 00:00:00 2001 From: "Dr. Clea F. Rees" Date: Sun, 1 Mar 2009 20:35:54 +0000 Subject: datatool new version git-svn-id: svn://tug.org/texlive/trunk@12277 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/datatool/CHANGES | 80 ++++++++ Master/texmf-dist/doc/latex/datatool/README | 206 +++++++++++---------- Master/texmf-dist/doc/latex/datatool/datatool.pdf | Bin 0 -> 1455516 bytes Master/texmf-dist/doc/latex/datatool/doc/CHANGES | 32 ---- .../texmf-dist/doc/latex/datatool/doc/datatool.pdf | Bin 1180800 -> 0 bytes 5 files changed, 185 insertions(+), 133 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/datatool/CHANGES create mode 100644 Master/texmf-dist/doc/latex/datatool/datatool.pdf delete mode 100644 Master/texmf-dist/doc/latex/datatool/doc/CHANGES delete mode 100644 Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf (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 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/datatool/datatool.pdf differ 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 Binary files a/Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf and /dev/null differ -- cgit v1.2.3