	$Id: README,v 1.7 2001/02/05 20:14:58 lethal Exp $

This is the distribution of libfbx, a library of extensions to the
linux framebuffer subsystem.

* What is libfbx

	libfbx is (as outlined above) a library of extensions to the
	linux framebuffer subsystem. It provides a number of drawing
	primitives, and very basic text drawing. It has no input
	routines (as those don't belong in a drawing library).
	
	It's purpose is to provide a low-level access layer for the
	creation of higher-level libraries and applications, such
	as a windowing system, embedded graphics software, or other
	graphical applications that need or want to be independant
	of X11.

* What is libfbx-gui

	libfbx-gui is a library of graphical extensions to libfbx.
	It will offer such things as a complete widget set, mouse
	support, a message handler, and so forth, upon completion.

* What architectures does libfbx and libfbx-gui run on

	At present, libfbx has been tested and works on the following
	platforms:

		- x86
		- StrongARM
		- SPARC

	If you get it running on a different architecture, please let
	us know so we can add it to the list.

* Where can I get libfbx and libfbx-gui

	libfbx-gui is part of libfbx and therefore is also part of
	the libfbx distribution. Current releases can be found on
	our ftp at:

		ftp://ftp.u4x.org/pub/u4x/projects/libfbx/

	For news and additional information, the project webpage is
	located at:

		http://developer.u4x.org/libfbx/

* Licensing

	libfbx and libfbx-gui are both released under the terms of
	version 2.1 of the GNU Lesser General Public License (GNU
	LGPL). A copy of the license can be found in the COPYING
	file or at http://www.gnu.org/copyleft/lesser.html.
	
* What you will need

	While libfbx and libfbx-gui do not currently require the
	existance of any third party libraries, it is a good idea to
	install libtimer and libkbd as well (libfbx in the future
	likely will require these to be existant). They can be found
	here:
	
		http://developer.u4x.org/libkbd/
		http://developer.u4x.org/libtimer/

* Mailing lists

	u4x-developer@lists.sourceforge.net

	To subscribe, send mail to:
	
		u4x-developer-request@lists.sourceforge.net

	and in the body of the message put the word "subscribe".

	As an alternate option, you can also subscribe through a web
	interface located at:

		http://lists.sourceforge.net/mailman/listinfo/u4x-developer/
	
	list archives can be found here:

		http://lists.sourceforge.net/archives/u4x-developer/
	
	Additional mailing lists and information can be found at our
	website (http://www.u4x.org).

* Layout

	libfbx is split into the following directory structure

		libfbx/        -- general sources and headers
		libfbx/gui     -- gui sources
		libfbx/arch    -- architecture specific optimizations
		libfbx/drivers -- hardware specific optimizations
		docs/          -- project documentation
		tests/         -- test programs

For any additional information send an email to a primary developer
listed in the AUTHORS file.

