TDE core libraries
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Slávek Banko 15dfd152df Rebrand version string to final 3.5.13.2 release 5 years ago
admin @ 6613b274c8 Reset submodule main/tdelibs/admin to latest HEAD 6 years ago
arts Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
cmake @ 9773bff74a Reset submodule main/tdelibs/cmake to latest HEAD 6 years ago
dcop Fix DCOP standard TQt object marshaling This partially resolves Bug 1510 (cherry picked from commit 7e397d203c) 6 years ago
dnssd Second part of prior commit 7 years ago
doc Update final HTML install path so all modules are consistent. (cherry picked from commit 979b0c9a1c) 6 years ago
interfaces Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
kab Fix references to user profile directory. (cherry picked from commit e256298e9d) 6 years ago
kabc Fix references to user profile directory. (cherry picked from commit e256298e9d) 6 years ago
kate Fix Kate syntax highlighting stall This resolves Bug 1279 (cherry picked from commit 86cf9b5863) 6 years ago
kcert Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
kcmshell Finished remaining porting to new TQt API 8 years ago
kconf_update Fix references to user profile directory. (cherry picked from commit e256298e9d) 6 years ago
kdecore Rebrand version string to final 3.5.13.2 release 5 years ago
kded Fix "KDE4 is running" message. This resolves bug report 1200. (cherry picked from commit 3dfc6fd192) 6 years ago
kdefx Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
kdeprint Add source code module name to stdout/stderr messages to improve readability. (cherry picked from commit e15521d96b) 6 years ago
kdesu Restore tdesu dialog "Keep password" check box default to disabled/unchecked. (cherry picked from commit 87363770ea) 6 years ago
kdeui Fix invalid toolbar data structure size declarations This cleans up a slew of Valgrind memcheck warnings (cherry picked from commit b1c819c323) 5 years ago
kdewidgets Rename old tq methods that no longer need a unique name (cherry picked from commit 984c25aa69) 6 years ago
kdoctools Rebranding of Krita as Chalk (cherry picked from commit 9e0a5e727a) 6 years ago
kglib [kdelibs/kglib] added cmake support 8 years ago
khtml Fix possible DOS in konqueror (CVE-2009-2537) (cherry picked from commit 89cfde63b8) 5 years ago
kimgio Fix openexr include flags (cherry picked from commit 9b523bbf41) 6 years ago
kinit Do not block on read of tdeinit socket and thereby rely on forcible tdeinit_shutdown termination during logout This partially resolves Bug 760 (cherry picked from commit a9e5bed292) 6 years ago
kio Fix security issue when displaying certificate informations (CVE-2011-3365) (cherry picked from commit a67a48107f) 5 years ago
kioslave Fix security issue when displaying certificate informations (CVE-2011-3365) (cherry picked from commit a67a48107f) 5 years ago
kjs Add source code module name to stdout/stderr messages to improve readability. (cherry picked from commit e15521d96b) 6 years ago
kmdi Fix inadvertent tq changes. (cherry picked from commit 40712e0646) 6 years ago
knewstuff Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
kparts Rename obsolete tq methods to standard names (cherry picked from commit 1180237ab3) 6 years ago
krandr Fix saving display config when Gamma is not supported by xrandr This resolves Bug 1506 (cherry picked from commit 90c0f26c7c) 6 years ago
kresources Fix references to user profile directory. (cherry picked from commit e256298e9d) 6 years ago
krsync Fix a number of tdelibs build warnings (cherry picked from commit 77f4891c22) 6 years ago
kspell2 Fix FTBFS - incomplete build kspell2 This closes Bug 657 (cherry picked from commit 3e284fadb9) 6 years ago
kstyles Fix inadvertent tqt changes. (cherry picked from commit d581c97c81) 6 years ago
kunittest Rename old tq methods that no longer need a unique name (cherry picked from commit 984c25aa69) 6 years ago
kutils Rename a few stragglers (cherry picked from commit 22e7adf3ed) 6 years ago
kwallet Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
libkmid Fix a number of tdelibs build warnings (cherry picked from commit 77f4891c22) 6 years ago
libkscreensaver Fix KRootBacking failure when no window is displayed This partially resolves Bug 811 (cherry picked from commit 2771be6210) 6 years ago
libltdl @ c61e5d357a Cleanup output clutter (cherry picked from commit 987dc667f2) 6 years ago
licenses Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
mimetypes Add OpenOffice flat XML mimetypes to kdelibs 7 years ago
networkstatus Rename old tq methods that no longer need a unique name (cherry picked from commit 984c25aa69) 6 years ago
pics Add go.png images to crystalsvg icon set to fix Standard ksplash theme. (cherry picked from commit 67886cbdd2) 6 years ago
win Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
.gitmodules Add common directories Add empty directories 6 years ago
AUTHORS Update mailing list in kdelibs AUTHORS file 8 years ago
CMakeLists.txt Add XZ tdeioslave Based on KDE GIT commit bbe9e8f5 (cherry picked from commit 7f328ba699) 6 years ago
COMPILING Convert remaining references to kde3 (e.g. in paths) to trinity 7 years ago
COMPILING.html Convert remaining references to kde3 (e.g. in paths) to trinity 7 years ago
COPYING Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
COPYING-DOCS Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
COPYING.BSD Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
COPYING.LIB Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
DEBUG Freshen up the kdelibs DEBUG file 8 years ago
INSTALL Enhance kdelibs INSTALL file 8 years ago
KDE2PORTING.html Fix inadvertent tq changes. (cherry picked from commit 00a35c030e) 6 years ago
KDE3PORTING.html Remove additional unneeded tq method conversions (cherry picked from commit a51cd9949c) 6 years ago
LAST_ENTERPRISE_SYNC Merge commit 1170303 from the Enterprise branch 8 years ago
Mainpage.dox Fix project links 8 years ago
Makefile.am.in Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
Makefile.cvs Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
NAMING Convert remaining references to kde3 (e.g. in paths) to trinity 7 years ago
README Fix references to user profile directory. (cherry picked from commit e256298e9d) 6 years ago
TODO Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
catalog.xml * Large set of SuSE patches to fix bugs and add functionality 8 years ago
common_texts.cpp Convert remainder of kdelibs to use currently defined tqt object name defs This might fix the kio ssl problem 8 years ago
config.h.cmake Add XZ tdeioslave Based on KDE GIT commit bbe9e8f5 (cherry picked from commit 7f328ba699) 6 years ago
configure.in.bot Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
configure.in.in Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
configure.in.mid Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
kde.pot Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago
kdelibs.lsm kdelibs update to Trinity v3.5.11 9 years ago
qt-messages.pot Revert automated changes Sorry guys, they are just not ready for prime time Work will continue as always 8 years ago

README

In this file:

* About kdelibs
* Licensing
* Common Mistakes
* Upgrading
* Compile Problems
* More Info


About kdelibs
-------------
This is version 3.5.13 of the Trinity Desktop Environment [TDE] libraries.

This package includes libraries that are central to the development and
execution of a KDE program, as well as internationalization files for these
libraries, misc HTML documentation, theme modules, and regression tests.
Here is an alphabetical list:

* arts
ARTS (analog realtime synthesizer) is a environment of small modules
that one can plug together to process multimedia data. This directory
contains KDE wrapper and KDE user interface elements for ARTS.

* dcop
The desktop communication program allows even shell scripts to
communicate with KDE applications. It's also the base for KParts.

* interfaces
kparts interface for text editors, mediaplayer and scripting.

* kab
OBSOLETE, see kabc: Used to be the address book library, but now only
used to convert kab-Addressbooks into kabc format.

* kabc
The address book library.

* kate
KPart for 'kate', the KDE advanced text editor.

* kcert
Personal certification manager.

* kconf_update
Auto-Updater for config files.

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

* kded
The KDE daemon checks for newly installed software, update files
or hostname changes and takes according actions.

* kdefx
Library with pixmap effects.

* kdeprint
The very versatile printing subsystem of KDE.

* kdesu
Library for password entering and handling

* kdeui
The main collection of misc. user interface classes (widgets).
KSpell and related classes are a frontend to ispell for use within a
GUI app.

* kdewidgets
For developers: KDE's custom widgets for Qt Designer.

* kdoctools
Contains mostly stuff convert XML docbook files via XSLT into
human readable stuff.

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

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

* kinit
Process launcher, used for fast KDE startup

* kio
Classes that fetch and decode URLs are contained here. This library also
contains "ksycoca", the system configure cache containing services,
applications, servicetypes and mimetypes.

* kioslave
I/O subprocesses to handle files, ftp, http, gzip and bzip2 streams.

* kjs
Implementation of ECMAScript (aka JavaScript).

* kparts
KDE component model.

* kstyles
The theme engine lies within. It handles nearly anything relating to
customizing the appearance of widgets.

* kwallet
Client and backend to store values in encrypted files.

* libkmid
MIDI file handling and midi mapper (manages output of midi files to
various devices).

* libkscreensaver
Library for making KDE screensavers.

* libltdl
System independed dlopen() handler.

* licenses
Contains texts of all used licenses.

* mimetypes
Database of mime types.

* pics
Database of icons.


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.

When in doubt, check the individual file, they should all have license
headings and other identifying marks.


Common Mistakes
---------------
If configure claims Qt cannot be found, look at http://www.trolltech.com
to get a copy of Qt, version 3.3.0 or newer. If you have peeked there
already, grab the SVN module qt-copy from anonsvn.kde.org, or a snapshot
thereof. Alternatively the svn module qt-copy from svn.kde.org can also be
used.


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.

On the other hand, --disable-debug removes all debug messages, leading
to a faster and cleaner desktop.

See also the file DEBUG.


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


Compile Problems
----------------
Often, KDE compile failures are not KDE's faults but the one of the
compiler or the distribution used. For that reason, please have a look at
http://developer.kde.org/build/compilationfaq.html for known issues in certain OS
environments before reporting bugs or going mad :).

gcc 3.0/3.0.1 is not yet able to compile all of KDE without errors, mostly
due to bugs in this version of the compiler. Some older version of gcc 2.96
also have problems compiling KDE due to compiler bugs. Even though
compilation may not report errors with these compiler, the usage of these
compilers may cause crashes when using the resulting executables.

If you are running a FreeBSD system, you will need to make sure that LIBS
is set to "-Wl,-export-dynamic". The easiest way to do this is to prefix
configure with it, i.e.: LIBS="-Wl,-export-dynamic" ./configure. Thanks to
Will Andrews <will@FreeBSD.org> and Arun Sharma <adsharma@sharmas.dhs.org>
for identifying what needed to be done, and how to do it, and such.

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


How to report
-------------
Reporting bugs is an art. Why? Because bug reports can help and hinder.

They hinder if the developers are just buried in an avalanche of bug reports.
They spend hours figuring out which bug reports are valid and which aren't,
which bug reports are due to bugs or due to installation problems.

They can be of tremendous help to notify developers on problems in areas that
they normally don't have access (e.g. KDE on AIX) to.

So, here are some tips on bug reporting:

* make sure your bug is due to KDE ... and not due to a packaging problem of
your Linux distributor. For example, most "I can not install the XYZ.rpm"
problem are due to packaging issues. Refer with such questions to your
Linux Distributor and his appropriate mailing list or bug reporting tool.

* The chance is high that your bug has already been dealt with ... so look
if there is a newer version of kdelibs available. Reporting bugs for
older, deprecated versions usually don't get that much attention :-)

* Also the chance is high that another one experienced your problem. The
bug report wizard at http://bugs.kde.org will help you to find out if your
problem has already been reported.

* The best bug report for a project based on voluntary work is of course one
that comes with a patch that solves the problem. :-)


More info
---------
http://www.kde.org is a good starting point for info on KDE. If you are a
developer, you may also point your browser to http://developer.kde.org.
There is a plethora of mailing lists available, you can gain an overview
quickly by looking at http://lists.kde.org.