===============
cuetools README
===============

:Author: Svend Sorensen
:Contact: sorensen@users.berlios.de
:Website: http://cuetools.berlios.de

.. contents::

Description
-----------

cuetools is a set of utilities for working with Cue Sheet (cue) and Table of
Contents (toc) files.

It includes:

cueconvert
	convert between the cue and toc formats

cuebreakpoints
	print the breakpoints from a cue or toc file

cueprint
	print disc and track infomation for a cue or toc file


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

Building requires GNU Make.  Run ``make install`` to install cuetools into the
default location of /usr/local.  The Makefiles also support both the prefix and
DESTDIR variables.

Bugs/Todo
---------

* (cue/toc) Line numbers in error messages are off sometimes.
* (cue/toc) Strings cannot be quoted with single quotes.
* (toc) Binary CD-TEXT data is parsed, but not saved.
* (toc) Only a single data file is supported.
* (cue) CDTEXTFILE (a CDRWIN extension) is not recognized.
* (cue) track_mode does not match cdrtools and CDRWIN docs.

License
-------

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

For license terms, see the file ``COPYING`` in this distribution.

See Also
--------

* Cdrdao website - http://cdrdao.sourceforge.net
* cdrdao(1) man page - description of toc file format
* shntool website - http://www.etree.org/shnutils/shntool/