In this file:

* About kdelibs
* Licensing information
* Common Mistakes
* Debugging
* Upgrading
* More Info

About kdelibs
-------------

This is the version 2.0 (almost) release of the KDE libraries.  Among this
collection are eleven (11) libraries that are central to the development
and execution of a KDE program, internationalization files for these
libraries, misc HTML documentation, and regression tests.  These libraries
are:

* kdecore
    This is the core collection of KDE stuff.  Non GUI classes reside here.

* kdeui
    The main collection of misc. user interface classes (widgets).

* kimgio
    An all purpose extension to the qimgio class that supports some obscure
    image formats.

* kfile
    This library contains the KFileDialog in all its glory.  A reasonably
    source compatable replacement to QFileDialog.

* kspell
    KSpell and related classes are a frontend to ispell for use within a
    GUI app.  kedit uses them already.

* kab
    The address book library.  See the README for more information.

* khtml
    The next generation HTML rendering widget designed for Konqueror
    (kfm's successor).  This supports HTML 4, CSS, and a variety of other web
    related standards.

* kio
    Classes that fetch and decode URLs are contained here.  Previously
    this functionality was contained in kfmlib, but among other
    improvments and redesigns, kio does not require KFM to operate.
    This library also contains "Ksycoca", the system configure cache
    containing services, applications, servicetypes and mimetypes.

* kparts
    KDE component model. Stay tuned.

* kstyles
    Widget styles.

Licensing
---------

The libraries themselves have been covered (since Saturday, June 21st, 1997)
by the GNU Library General Public License (LGPL).  Any other programs (such as
the examples) are covered by the GNU General Public License (GPL).  All the
gory details for the LGPL reside in COPYING.LIB, and for the GPL reside in 
COPYING.

Various parts are also covered under a BSD style license, detailed in
COPYING.BSD.  Currently, code covered under such license is copyrighted by
Theo de Raadt.

Common Mistakes
---------------

If configure claims Qt cannot be found, have a look at http://www.troll.no
to get a copy of Qt, version 2.1.0 or newer.

Debugging
---------

You can use --enable-debug with the configure script, if you want to have
debug code in your KDE libs.  If you have the space and can stand code that's
somewhat slower, this is worth it.  The extra information really
helps debugging and thus bugfixing.

Upgrading
---------

If you have an older kdebase installed, just copy all your .k*rc files
from $HOME to $HOME/.kde/share/config. In the other case, default values
are used for most apps.

More Info
---------

If you get odd error such as:

as: Error: /var/tmp/ccK1Cfxa.s, line 2827: Truncating token:
__t4pair2Zt18__rb_tree_iterator3Zt4pair2ZCt12basic_string3ZcZt18string_char_trai
ts1ZcZt24__default_alloc_template2b0i0Zt12basic_string3ZcZt18string_char_traits1
ZcZt24__default_alloc_template2b0i0ZRt4pair2ZCt12basic_string3ZcZt18string_char_
traits1ZcZt24__default_alloc_template2b0i0Zt12basic_string3ZcZt18string_char_tra
its1ZcZt24__default_alloc_template2b0i0ZPt4pair2ZCt12basic_string3ZcZt18string_c
har_traits1ZcZt24__default_alloc_template2b0i0Zt12basic_string3ZcZt18string_char
_traits1ZcZt24__default_alloc_template2b0i0ZbRCt18__rb_tree_iterator3Zt4pair2ZCt
12basic_string3ZcZt18string_char_traits1ZcZt24__default_alloc_template2b0i0Zt12b
asic_string3ZcZt18string_char_traits1ZcZt24__default_alloc_template2b0i0ZRt4pair
2ZCt12basic_string3ZcZt18string_char_traits1ZcZt24__default_alloc_template2b0i0Z
t12basic_string3ZcZt18string_char_traits1ZcZt24__default_alloc_template2b0i0ZPt4
pair2ZCt12basic_string3ZcZt18string_char_traits1ZcZt24__default_alloc_template2b
0i0Zt12basic_string3ZcZt18strin!
g_char_traits1ZcZt24__default_al

and you're using egcs, try re-compiling all your C++ libs with -fsquangle,
and then recompiling whatever you were working on with -fsquangle.  It
should help, and more information about this is available on the egcs FAQ
available at http://egcs.cygnus.com

Please direct any bug reports to me (kalle@kde.org). General KDE
discussions should go to the KDE mailing list (kde@kde.org).

Cow!
