***************************IMPORTANT NOTICE****************************
This version of C5.0 is distributed under the licence agreement in
http://www.rulequest.com/eula.html.  Use of C5.0 or of its documentation
signifies your willingness to be bound by this agreement.
***********************************************************************


The C5.0 System
---------------

The C5.0 directory "bin" contains

    *  a decision tree and ruleset generator ("c5.0")
    *  a decision tree and ruleset interpreter ("predict")
    *  a csh script ("xval") for multiple cross-validations
    *  an ancillary program ("report") used by xval

The Linux version also includes

    *  a graphical user interface ("gui")
    *  an associated file ("gui.exe.so") used by gui

The graphical user interface requires Wine (http://winehq.org); Wine is
included in most recent Linux distributions.  Before using gui, please
run C5.0 from the command-line interface to install your Licence ID (see
Installation below).

In directory "Doc" you will find a html file "tutorial.html" that
describes and illustrates the use of the C5.0 system.

Installation
------------

Installation of C5.0 requires a valid Licence ID.  This is a string of
hexadecimal digits containing spaces and terminated by a hash sign (#)
and may look something like this:

    7c1e 0e0e 9f23 4be2#

The first time that you run C5.0, make sure that you are in the bin
directory that contains the c5.0 file.   You will be prompted to enter
your Licence ID and, after it is checked, the c5.0 file will be
overwritten.  You will not be required to enter your Licence ID on
subsequent uses of the overwritten file, but you will need to do so if
you attempt to run a copy of the original file or if you obtain an
updated version.

Don't forget to save a backup copy of the .tgz file that was used to
install C5.0.  You may need this file if you wish to transfer C5.0 to a
different computer.

Examples
--------

The directory "Data" contains a few sample datasets.  More datasets are
available from

    *  the UCI KDD Archive (http://kdd.ics.uci.edu/)
    *  the UCI Machine Learning Repository
       (http://mlearn.ics.uci.edu/MLRepository.html)
    *  the KDnuggets datasets index (http://kdnuggets.com/datasets/)

Problems
--------

If you discover any bugs in the system, please email quinlan@rulequest.com.
