LibGII README
=============

LibGII (General Input Interface) is intended to be to input what our LibGGI
(General Graphics Interface) library is to graphics.

The goal of LibGII is to provide a single easy to use, but yet powerful,
API for all possible input sources. However we are not there yet. The
API is far from set in stone yet, and is likely to change.

The main purpose of this LibGII release is to accompany our LibGGI
release, but you're still very welcome to use LibGII as a standalone
library for your non-LibGGI applications. Also you might be interrested in
the mhub utility found in the demos directory. mhub is a mouse event repeater
and converter. See mhub(1) and the files doc/env.txt and doc/input.txt for
more info.


Requirements
============

* Most likely GNU Make.
* Linux for linux-kbd inputlib (but not for linux-mouse, despite the name...)
* VGL library if using display-vgl target.
* X Window System for x/xwin inputlibs.
* other libraries for other targets, such as aalib and SVGAlib.


How to install and use
======================

See the files INSTALL and INSTALL.autoconf for installation instructions.

Demos are found in the programs/demos sub directory.  They are built
automatically.

LibGII's and some of the targets' behaviour can be modified with environment
variables, please see the file doc/env.txt for a list of those.

There is a description of some of the more common inputlibs in doc/inputs.txt.


The GGI mailing lists
=====================

There are several mailing lists available for discussion of GGI-related
topics. Please see http://www.ggi-project.org/contact.html for more info.


GGI resources
=============

Web site: http://www.ggi-project.org/
FTP site: ftp://ftp.ggi-project.org/pub/ggi
