 _______ _____   _____      _     _
|__   __|_   _| / ____|    | |   | |
   | |    | |  | |     __ _| |__ | | ___  ___
   | |    | |  | |    / _` | '_ \| |/ _ \/ __|
   | |   _| |_ | |___| (_| | |_) | |  __/\__ \
   |_|  |_____(_)_____\__,_|_.__/|_|\___||___/

This library is part of the TILP framework by Romain Liévin et al.

See the AUTHORS file for more detailed authorship information.

-------------------------------------------------------------------------------
Requirements
-------------------------------------------------------------------------------

OS:
  - any *nix with a reasonably modern C compiler (a current GCC or Clang will
    definitely work)
    See the CONFIG file for device permission issues and how to solve them.
  or
  - Microsoft Windows, MSVC or MSYS+MinGW required for compiling from source

Libraries:
  - GLib 2 (required)
  - libusb 0.1 or libusb 1.0 on *nix, or libusb-win32 (optional, required to use
    USB cables)

Tools for building from source:
  - autoreconf (required)
  - make (required)
  - tfdocgen (optional, required to build API docs)

-------------------------------------------------------------------------------
Compilation
-------------------------------------------------------------------------------

Untar the libticables2 archive, change directory to the libticables2 directory.

Type "autoreconf -i -f" to generate the autotools files.

Type "./configure" (add --prefix option to install to a non-default location).
Add --enable-libusb10 if you want to build against the libusb 1.0 backend,
which will become default in the future.

Type "make" and then "make install". "make install" requires root privileges
to install to the default, system-wide location.

NOTE: some cable handlers can be disabled using #define NO_CABLE_XXX.

NOTE: building libticables against the libusb 1.0 compatibility layer for
libusb 0.1 does *not* work, because some features required by libticables are
not supported by this compatibility layer. You need to build either against
libusb 0.1 proper, or use the libusb 1.0 backend.

NOTE: on *nix, see the CONFIG file for device permission issues and how to
solve them.

-------------------------------------------------------------------------------
Availability
-------------------------------------------------------------------------------

  http://lpg.ticalc.org/prj_tilp

-------------------------------------------------------------------------------
Copyright
-------------------------------------------------------------------------------

Copyright (C) 1999-2011 the TiLP team <tilp-users@lists.sf.net>
See AUTHORS for detailed authorship information.

This library 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.

(A special exception applies when linking the library into TilEm, see the
COPYING file for details.)

This library 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 library (in the COPYING file); if not, see <http://www.gnu.org/licenses/>.

-------------------------------------------------------------------------------

Texas Instruments and TI are trademarks of Texas Instruments Incorporated.
For more informations: <http://education.ti.com/educationportal/sites/US/nonProductSingle/global_trademarks.html>
This document has been written independently of Texas Instruments.

Please report any bugs, questions, etc. on the SourceForge infrastructure
(http://sourceforge.net/tilp). Please indicate your platform, your calculator
type and ROM version.

The TiLP team <tilp-users@lists.sf.net>
