TDE base libraries and programs
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 74b1fc6576 Cleanup output clutter 6 years ago
admin @ 307fab5fda Reset submodule main/tdebase/admin to latest HEAD 6 years ago
applnk Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
cmake @ ba27b9f232 Reset submodule main/tdebase/cmake to latest HEAD 6 years ago
doc Rename kderc -> tderc in support of bug report 1447. 6 years ago
drkonqi Rename additional header files to avoid conflicts with KDE4 6 years ago
kappfinder Rename additional header files to avoid conflicts with KDE4 6 years ago
kate Rename additional header files to avoid conflicts with KDE4 6 years ago
kcheckpass Fix a number of issues related to the media kioslave 6 years ago
kcminit Rename common header files for consistency with class renaming 6 years ago
kcontrol Cleanup output clutter 6 years ago
kdcop Rename additional header files to avoid conflicts with KDE4 6 years ago
kdebugdialog Rename additional header files to avoid conflicts with KDE4 6 years ago
kdeeject Fix nominal kdeeject problems. 6 years ago
kdepasswd Rename additional header files to avoid conflicts with KDE4 6 years ago
kdesktop Cleanup output clutter 6 years ago
kdialog Rename additional header files to avoid conflicts with KDE4 6 years ago
kfind Rename additional header files to avoid conflicts with KDE4 6 years ago
khelpcenter Update files and references in support of bug report 1446. 6 years ago
khotkeys Add warning messages on hot key command execution failure 6 years ago
kicker Fix sporadic Kicker crash in popup menu handler 6 years ago
klipper Rename additional header files to avoid conflicts with KDE4 6 years ago
kmenuedit Honor application suid requests even if they are directed at KDE 6 years ago
knetattach Rename additional header files to avoid conflicts with KDE4 6 years ago
konqueror Update desktop files in support of bug report 1463. 6 years ago
konsole Update desktop files in support of bug report 1463. 6 years ago
kpager Rename additional header files to avoid conflicts with KDE4 6 years ago
kpersonalizer Rename kderc -> tderc in support of bug report 1447. 6 years ago
kreadconfig Rename additional header files to avoid conflicts with KDE4 6 years ago
krootbacking Cleanup output clutter 6 years ago
ksmserver Add cmake configure option to support ksmserver shutdown debugging timing markers. 6 years ago
ksplashml Rename additional header files to avoid conflicts with KDE4 6 years ago
kstart Rename additional header files to avoid conflicts with KDE4 6 years ago
ksysguard Add destructor to ReniceDlg in order to work around armel FTBFS 6 years ago
ksystraycmd Rename additional header files to avoid conflicts with KDE4 6 years ago
ktip Rename additional header files to avoid conflicts with KDE4 6 years ago
kxkb Add preliminary support to improve kcontrol keyboard repeat speed setting. 6 years ago
l10n Rename additional header files to avoid conflicts with KDE4 6 years ago
libkonq Fix desktop refresh destroying media device information and menus 6 years ago
nsplugins Rename additional header files to avoid conflicts with KDE4 6 years ago
pics Add missing Games for Kids icons. 7 years ago
tdeinit Rename additional header files to avoid conflicts with KDE4 6 years ago
tdeioslave Update files and references in support of bug report 1446. 6 years ago
tdeprint Rename KABC namespace 6 years ago
tdescreensaver Rename additional header files to avoid conflicts with KDE4 6 years ago
tdesu Remove unnecessary Ignore button from the tdesu dialog. 6 years ago
tdm Cleanup output clutter 6 years ago
tdmlib Cleanup output clutter 6 years ago
tqt3integration Cleanup output clutter 6 years ago
tsak Do not load virtual keyboards in tsak 6 years ago
twin Cleanup output clutter 6 years ago
.gitmodules Added common directories 7 years ago
AUTHORS Additional renaming of kde to tde 7 years ago
CMakeLists.txt Add cmake configure option to support ksmserver shutdown debugging timing markers. 6 years ago
COPYING Very minor update to COPYING file 6 years ago
COPYING-DOCS Undo undesired top level automated changes 8 years ago
ConfigureChecks.cmake Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
INSTALL Enhance kdebase INSTALL file 8 years ago
Mainpage.dox Rename startkde to starttde 7 years ago
Makefile.am.in Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
Makefile.cvs Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
README Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
README.pam Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
config.h.cmake Add cmake configure option to support ksmserver shutdown debugging timing markers. 6 years ago
configure.in.bot Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
configure.in.in Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
kde.pamd Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
migratekde3 Update migratekde3 script for latest renaming changes. 6 years ago
mkpamserv Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 9 years ago
r14-xdg-update Rename kderc -> tderc in support of bug report 1447. 6 years ago
starttde Update starttde: Fix XDG_DATA_DIRS variable 6 years ago
tdebase.lsm Update lsm files. 7 years ago
tdescreensaver.pamd Rename a number of libraries and executables to avoid conflicts with KDE4 6 years ago
trinity Second part of previous commit 8 years ago

README

In this file:

* About tdebase
* Thank you
* Common Mistakes
* Configuring
* Debugging
* Upgrading
* Removal/Uninstallation
* More Info


About tdebase
-------------
tdebase is the second mandatory package (besides tdelibs) for the Trinity Desktop
Environment. Here we have various applications and infrastructure files and
libraries. Here is an overview of the directories:

* applnk
Files to create the icons for the TDE menu button

* debian
Needed to create a Debian package.

* doc
XML formatted documentation files for the apps

* drkonqi
If ever an app crashes (heaven forbid!) then Dr.Konqi will be so kind
and make a stack trace. This is a great help for the developers to fix
the bug.

* kappfinder
Searches for non-TDE applications, e.g. Acrobat Reader (tm) and installs
those apps under the K start button.

* kate
A fast and advanced text editor, extensible with nice plugins.

* kcheckpass
Small program to enter and check passwords, to be used by other
programs.

* kcontrol
The TDE Control Center allows you to tweak the KDE settings.

* kdcop
GUI app to browse for DCOP interfaces, can also execute them.

* kdebugdialog
Allows you to specify which debug messages you want to see.

* tdeprint
The TDE printing system.

* kdesktop
You guessed it: the desktop above the panel.

* tdesu
A graphical front end to "su".

* kdialog
Allows to display menu boxes from shell scripts.

* tdm
Replacement for XDM, for those people that like graphical logins.

* kfind
File find utility (standalone and in Konqueror's file manager).

* khelpcenter
Used to to read all great documentation about KDE, unix man pages,
info pages etc.

* khotkeys
Intercepts keys and can call applications.

* kicker
The panel at the botton with the K start button and the taskbar etc.

* tdeioslave
Infrastructure that helps make every application internet enabled
e.g. to directly save a file to ftp://place.org/dir/file.txt

* klipper
Taskbar applet that enhances and extenses the X clipboard.

* kmenuedit
Edit for the menu below the K start button.

* konqueror
The file manager and web browser you get easily used to.

* konsole
A shell program similar to xterm.

* kpager
Applet to show the contents of the virtual desktops.

* kpersonalizer
The customization wizard you get when you first start KDE.

* kreadconfig
A tool for shell scripts to get info from KDE's config files.

* krichtexteditor
A embeddable rich text editor and a wrapper application for it.

* tdescreensaver
The KDE screensaver environment and some basic screensavers. More
of them are in the tdeartwork package.

* ksmserver
The KDE session manager (saves program status on login, restarts
those program at the next login).

* kdepasswd
A KDE frontend for passwd. Also contains the "Password & User Information" KCM.

* ksplashml
The screen displayed while KDE starts.

* kstart
Launches applications with special window properties such as iconified,
etc.

* ksysguard
Task manager and system monitor, can work with remote systems.

* ksystraycmd
Allows to run any application in the system tray.

* ktip
Gives you tips how to use KDE.

* twin
The KDE window manager (moves, resizes and decorates windows).

* kxkb
A keyboard map tool.

* l10n
l-10letters-n: localization. Mostly country flags.

* libkonq
Some libraries needed by Konqueror.

* nsplugins
Together with OSF/Motif or Lesstif allows you to use Netscape (tm)
plugins in Konqueror.

* pics
Various icons and wallpapers.


Thanks!
-------
Thank you Steven M. Scotten and Kuno Raffi (weave) for creating artwork
specifically for the K Desktop Environment. Your efforts are much
appreciated.

Mr. Scotten has created: blue_angle_swirl, bluecheck, bluegreencrisscross,
bluegreensilver, candystripe_chainlink, charcoal_sunset, fadedpaint,
garden_lattice, ghost_lightning, glassywarpcheck, gold_crinkle, greenish,
heavens_hex, latte, lime_vibration, liquid_canvas, northbeach,
orange_stacks, purple_swirl, string_theory, sunday_brunch,
toothofthehoundthatbitcha, vegetative_fog, wavetron, woodcheck


Common Mistakes
---------------
IMPORTANT: most applications need TDEDIR as the directory where KDE is
installed. Please set this in your login file.

If XPM support wasn't configured, it may be that configure has no idea where
your XPM libraries are. If so, set XPM_INCLUDE and XPM_LDFLAGS to the paths
where configure should look for XPM. But if you haven't installed XPM or it
didn't come with your system, that's no problem. You will only miss a few
screensavers. The same thing applies with OPENGL support. Here you have to
set GL_INCLUDE and GL_LDFLAGS.

If configure claims Qt cannot be found, have a look at
ftp://ftp.trolltech.com and download the latest Qt 3.3.x release.

Be advised, if you're using FreeBSD, then please do not use the Qt port that
comes along with it.

Configuring
-----------
tdebase's configure script supports all the standard GNU autoconf options
(you can have the various options listed for you by specifying the --help
switch), plus the following options are also supported. Note: the *non*
default variation is listed, so if you see --enable-debug, the default is
--disable debug.

`--x-includes=DIR'
use X include files in DIR

`--x-libraries=DIR'
use X library files in DIR

`--enable-debug'
creates debugging code [default=no]

`--enable-strict'
Add strict[er] compiler options (may not work!) to the CFLAGS and
CXXFLAGS. This is GNU CC specific for the time being.

`--with-gnu-ld'
assume the C compiler uses GNU ld [default=no]

`--disable-libtool-lock'
force libtool not to do file locking

`--disable-nls'
do not use Native Language Support (i18n)

`--with-qt-dir'
where the root of qt is installed

`--with-qt-includes=DIR'
look for the Qt header files in DIR

`--with-qt-libraries=DIR'
look for the Qt library in DIR

`--with-extra-includes=DIR'
look for include files in DIR in addition to any other
`standard' paths

`--with-extra-libs=DIR'
look for [extra] libraries in DIR too

`--disable-path-check'
don't try to make sure that tdebase is installed into the same
base KDE directory as the rest of KDE

`--with-install-root=DIR'
the root to install to [default=/] (i.e. make / == DIR, so /usr
becomes DIR/usr)

`--disable-rpath'
do not use the rpath feature of ld

`--with-xdmdir=DIR'
use xdm (and config files) from DIR if the xdm config dir can't be
found automaticly

`--with-pam[=ARG]'
enable support for PAM: ARG=[yes|no|service name]

`--with-shadow'
if you want to check for and use shadow password support if it's present

`--without-gl'
disable any software which depends on OpenGL

`--without-xpm'
disable color pixmap XPM tests

`--with-xinerama'
enable Xinerama support

Please check ./configure --help for a more current list of options and what
they do.


Debugging
---------
You can use --enable-debug with the configure script, if you want to have
debug code in your KDE apps and libs. If you experience problems and want to
report problems to the KDE Bugs database, it is recommended to recompile
with this switch enabled to make the backtraces more verbose (and thus
giving the developer more information about the cause of the bug).


Removal/Uninstallation
----------------------
You can use 'make uninstall' if you want to remove the kde from the dirs.
This feature has not been tested completely, and is depreciated. On a system
where TDEDIR is specific to KDE (i.e. not /usr), rm -rf $TDEDIR does it as
well.


More Info
---------
If your system does not have XPM installed, and you cannot locate a package
of it, you may obtain it from ftp://avahi.inria.fr/pub/xpm, or you may find
it in ftp://ftp.freebsd.org/pub/FreeBSD/distfiles

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 your system supports PAM (Plugable Authentication Modules), please see
the README.pam file in this directory for more information about using KDE
with PAM.

Have a look at the individual subdirectories, if you would like to find out
more about a specific application included in tdebase.

More FAQs on http://www.kde.org/info/faq.html

If you have problems compiling and installing this package, please check the
kde-devel@kde.org mailing list archive (see http://lists.kde.org) to see if
somebody had a similiar problem already. If not, try posting a message to
the list with detailed information about the compile problem.

General KDE discussions should go to the KDE mailing list (kde@kde.org).