------------------------------------------------------------
                          Xclasses
                    a X11 layout library
------------------------------------------------------------

This a pre-release of Xclasses, not all functionality added.

Currently there is only a german documentation (pdf) with all now supported
classes and functions.


What is Xclasses?

Xclasses is a C++ layout library for the X Window System. All objects (called
gadgets) are font sensitiv, i.e. their size changes with the size of the used
screen font and the size of the window. All this is done by Xclasses itself!

All objects (gadgets) have the same base class (class gadget) so there are all
used the same. Gadgets are put together in groups (class group also bases on
gadget) which manage the correct size of all gadgets (and/or groups!) inside.


Why use Xclasses?

Xclasses is completely written in C++ so it is really object orientated! But
C-Users may use it because most C compilers support C++ and for using Xclasses
you neddn't to know much about C++.

Xclasses is easy to use, no pointer or handles to manage or remember - simply
classes (for C users: like structs with functions added). If you don't want to
do some special things (like writing a multiplayer arcade game or a new window
manager) you don't even need to know anything about X-Windows functions and how
it works - Xclasses has its own classes for all of this that put many complex X
functions to some easy functions together.

Xclasses makes easy font and context sensitiv GUIs. And you don't need much
time to develop a GUI!


How to install.

To install the compiled library start "./build install".

This copies the library to /usr/local/lib/ and the includes to
/usr/local/include/. A global config file for all Xclasses programs is
installed in /usr/lib/X11/Xclasses/.

Each time you want to compile a Xclasses program you should execute
the "setenvxc" script like this ". ./setenvxc" in ksh or bash or
but its source into your profile.

Now you can compile the example programs in the example dir, enter

./build examples

in the Xclasses top directory (where you found this README).

If you got the sources and want to compile them yourself use the "build"
script:

./build config    will ask some config questions
./build make      will make the library

or

./build all       build config & make


Uninstall if you don't like it or it doesn't work.

Well, if it really doesn't work, please, send me a mail! Uninstall: simple
remove the installed files: /usr/local/lib/libXclasses.*
/usr/local/include/Xclasses/ /usr/X11/lib/X11/Xclasses/


Support, Mailing list

WWW: http://www.js-home.org/Xclasses/ (newest releases,
PDF doc, HTML doc, german - Pre-Compiles Libs for IRIX and AIX)

EMail: schmitzj@js-home.org

Mailinglist (first use this before writing to me) Xclasses@fsai.fh-trier.de

To subscribe or unsubscribe or get infos write to

majordomo@js-home.org

place whatever you want in the subject and write the command

HELP

in the message body. So this mail will look like this:

To: majordomo@js-home.org Subject: something Body: HELP

Some minutes (or some more) later you will get a reply with the commands to
subscribe a list or get a list with all lists you can subscribe to.

Send

SUBSCRIBE xclasses

to subscribe to the Xclasses mailing list.


Writing own classes that you whould like to be added to the Xclasses.

Test is, send it (source code, doc file in tar-gzipped) to me via EMail.


js/20010624 ($Revision: 1.2 $)
