Application  : datatooltk version 1.4 2015-01-23

Author       : Nicola L. C. Talbot
               www.dickimaw-books.com

Home Page    : http://www.dickimaw-books.com/apps/datatooltk/

Bug Reports  : http://www.dickimaw-books.com/bug-report.html

License      : GPLv3+ <http://gnu.org/licenses/gpl.html>

Requirements : Java Runtime Environment 1.7 (Java 7)
               Perl (optional)
               TeX
               datatool and (optionally) probsoln LaTeX packages.

DESCRIPTION
===========

A Java GUI that can be used to create datatool.sty databases in
datatool's internal format, which can be quickly imported into a
LaTeX document using \input (or datatool's \DTLloadbtex). It can
also be used in batch mode to import data from SQL, CSV, XLS, ODS or
probsoln datasets. Tools are available to sort or shuffle the
database.

INSTALL
=======

1. Ensure you have Java 7 installed (java.com/getjava).

2. Download and run datatooltk-installer.jar (either
double-click on the jar file or run 
"java -jar datatooltk-installer.jar" from a terminal).

If you want to use the datatooltk plugins you need to ensure
you have Perl installed. An up-to-date TeX distribution is also
required if you want to import data from a probsoln dataset.

Third Party Libraries
=====================

datatooltk depends on the following third party libraries whose jar
files are placed in the application's lib directory by the
installer:

 - Java Help (https://javahelp.java.net/) GPL
 - Open CSV (http://opencsv.sourceforge.net/) Apache 2.0 license
 - MySQL connector (http://dev.mysql.com/downloads/connector/j/) GPL
 - The Java Look and Feel Graphics Repository
   (http://www.oracle.com/technetwork/java/index-138612.html)
   JLFGR License
 - Apache POI (http://poi.apache.org) Apache 2.0 license
 - jOpenDocument (http://www.jopendocument.org/) GPL


Compiling PDF Documentation
===========================

Requirements: TeX, arara, Perl.

Either:

make -C src/doc datatooltk-en-GB.pdf

Or:

1. cd to the src/doc directory.

2. Run the createdatatooltkdocs Perl script to create the .tex file
   Either:

   createdatatooltkdocs en GB

   Or:

   createdatatooltkdocs en US

3. Run arara on the resulting .tex file. For example:

   arara datatooltk-en-GB

   Alternative run pdflatex, makeindex and makeglossaries as
   per the arara directives at the start of the .tex file

