[relnotes] [Fedora Project Wiki] Update of "Docs/Beats/BackwardsCompatibility/KDE3" by KevinKofler

[fedorawiki-noreply at fedoraproject.org]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Fedora Project Wiki" for change notification.

The following page has been changed by KevinKofler:
http://fedoraproject.org/wiki/Docs/Beats/BackwardsCompatibility/KDE3

The comment on the change is:
Write page about the KDE 3 backwards compatibility support.

New page:
=== KDE 3 Development Platform / Libraries ===

The primary version of KDE in Fedora 9 is KDE 4.0. KDE 3 is no longer offered as a full desktop environment. However, to make it possible to run and build the many existing KDE 3 applications, the following KDE 3.5 library packages are provided:
 * `kdelibs3`, `kdelibs3-devel`: KDE 3 libraries
 * `kdebase3`, `kdebase3-devel`: KDE 3 core files required by some applications
In addition, while the main purpose of the `kdegames3` package is to include the games which are not ported to KDE 4 yet, it also contains a KDE 3 version of `libkdegames` which is required by some third-party KDE 3 games.

Moreover, the KDE 4 `kdebase-runtime` package, which provides `khelpcenter`, also sets up `khelpcenter` as a service for KDE 3 applications, so help in KDE 3 applications works. (The KDE 3 version of `khelpcenter` is no longer provided, the KDE 4 version is used instead.)

These packages are designed to:
 * comply with the Filesystem Hierarchy Standard (FHS), and
 * be completely safe to install in parallel with KDE 4, including the `-devel` packages.

In order to achieve this, Fedora KDE SIG members made 2 changes to the KDE 4 `kdelibs-devel` packages:
 * The library symlinks are installed to `/usr/lib/kde4/devel` or `/usr/lib64/kde4/devel` depending on system architecture.
 * The `kconfig_compiler` and `makekdewidgets` tools have been renamed `kconfig_compiler4` and `makekdewidgets4`, respectively.
These changes should be completely transparent to the vast majority of KDE 4 applications that use `cmake` to build, since `FindKDE4Internal.cmake` has been patched to
match these changes. The changes were made to the KDE 4 `kdelibs-devel` rather than to `kdelibs3-devel` because KDE 4 stores these locations in a central place, whereas KDE 3 applications usually contain hardcoded copies of the library search paths and executable names.

Note that `kdebase3` does '''not''' include the following:
 * a complete KDE 3 desktop (workspace) which could be used instead of KDE 4: in particular, KDE 3 versions of KWin, KDesktop, Kicker, KSplash and KControl are '''not''' included,
 * the KDE 3 versions of `kdebase` applications such as Konqueror and KWrite, which are redundant with the KDE 4 versions and would conflict with them,
 * the `libkdecorations` library required for KWin 3 window decorations, as those window decorations cannot be used in the KDE 4 version of KWin,
 * the `libkickermain` library required by some Kicker applets, as there is no Kicker in Fedora 9 and thus Kicker applets cannot be used.

Please note that, as with any backwards-compatibility library, developing new software against the legacy API is discouraged!