summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/datatool
diff options
context:
space:
mode:
authorDr. Clea F. Rees <cfrees@imapmail.org>2009-03-01 20:35:54 +0000
committerDr. Clea F. Rees <cfrees@imapmail.org>2009-03-01 20:35:54 +0000
commitde3f0b6a3f872b5de7a6efb9d84a368e5c059f61 (patch)
tree65b5e1f7f1f5716388d91f55e222a1221a882df4 /Master/texmf-dist/doc/latex/datatool
parent98b2e0029dce671be04c9bd02fa94109e0c67ad1 (diff)
datatool new version
git-svn-id: svn://tug.org/texlive/trunk@12277 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/datatool')
-rw-r--r--Master/texmf-dist/doc/latex/datatool/CHANGES80
-rw-r--r--Master/texmf-dist/doc/latex/datatool/README206
-rw-r--r--Master/texmf-dist/doc/latex/datatool/datatool.pdfbin0 -> 1455516 bytes
-rw-r--r--Master/texmf-dist/doc/latex/datatool/doc/CHANGES32
-rw-r--r--Master/texmf-dist/doc/latex/datatool/doc/datatool.pdfbin1180800 -> 0 bytes
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
Binary files 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
--- a/Master/texmf-dist/doc/latex/datatool/doc/datatool.pdf
+++ /dev/null
Binary files differ