KDE Frequently Asked Questions
KDE Frequently Asked Questions
Next

KDE Frequently Asked Questions

The KDE Team

Conversion to British English: Malcolm Hunter
Revision 3.2 (2003-09-16)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

This is a compilation of the most frequently asked questions about the K Desktop Environment. Please report any bugs, inconsistencies or omissions you find in this FAQ to . Please do not mail your questions to this list. Post them to the KDE mailing lists and newsgroups instead. They are monitored for this FAQ.


Chapter 1. About this FAQ
About this FAQ
Prev
Next

Chapter 1. About this FAQ

1.1. What can I do to help out with this FAQ?
1.2. How do I become a FAQ maintainer?
1.1.

What can I do to help out with this FAQ?

First, send us any errors that you may find. Also, any suggestions that you might have, are appreciated. Better yet, send us everything that you think is unclear, and if possible, send us what you think would be a clearer solution. Our email address is .

Second, send us your solutions of those frequently-asked questions which are still not in this FAQ. We will put them in as soon as possible.

Last but not least, please make full use of this FAQ. Read this FAQ (and other relevant documentation) well before asking questions on the various KDE mailing lists or newsgroups.

Note

You might also want to consider becoming a FAQ maintainer. Please refer to Q: 1.2 for more details.

1.2.

How do I become a FAQ maintainer?

Actually, it is very easy to become an FAQ maintainer, and we are always in need of fresh blood. :-) Just send us an email at .

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 2. Introduction
Introduction
Prev
Next

Chapter 2. Introduction

2.1. What is KDE?
2.2. On which platforms can I expect KDE to work?
2.3. Is KDE a window manager?
2.4. Is KDE a CDE, Windows 95 or Mac OS clone?
2.5. Is KDE free software?
2.1.

What is KDE?

KDE is the K Desktop Environment. It is a project initiated by Matthias Ettrich in 1996. The aim of the KDE project is to connect the power of the UNIX® operating systems with the comfort of a modern user interface.

In short, KDE will bring UNIX® to the desktop!

If you want further information about KDE, have a look at What is KDE?

2.2.

On which platforms can I expect KDE to work?

KDE is a Desktop Environment for all flavours of UNIX®. While it is true that most KDE developers use Linux®, KDE runs smoothly on a wide range of systems. You may, however, need to tweak the source code a bit to get KDE to compile on a not-so-popular variant of UNIX®, or if you are not using the GNU development tools, in particular the gcc compiler.

For an almost complete list of systems KDE is running on, please refer to this list of systems for KDE

2.3.

Is KDE a window manager?

No, KDE is not a window manager. While KDE includes a very sophisticated window manager (KWin), KDE is much more than that. It is a full-blown Integrated Desktop Environment.

KDE provides a complete desktop environment, including a web browser, a file manager, a window manager, a help system, a configuration system, uncountable tools and utilities, and an ever increasing number of applications, including but not limited to mail and news clients, drawing programs, a PostScript® and a DVI viewer and so forth.

2.4.

Is KDE a CDE, Windows® 95 or Mac® OS clone?

No, KDE is not a clone. Specifically KDE is not a CDE or Windows® clone. While the KDE developers have and will continue to glean the best features from all existing desktop environments, KDE is a truly unique environment that has and will continue to go its own way.

2.5.

Is KDE free software?

Yes, KDE is free software according to the GNU General Public Licence. All KDE libraries are available under the LGPL making commercial software development for the KDE desktop possible, but all KDE applications are licensed under the GPL.

KDE uses the Qt™ C++ crossplatform toolkit, which is also released (since version 2.2) under the GPL.

It is absolutely legal to make KDE and Qt™ available on CD-ROM free of charge. No runtime fees of any kind are incurred.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 3. Getting KDE
Getting KDE
Prev
Next

Chapter 3. Getting KDE

3.1. Where do I get KDE?
3.2. Are there Linux distributions that include KDE?
3.3. What is the current version?
3.4. Where do I find KDE snapshots?
3.5. Where do I get Qt?
3.6. What is Qt, by the way?
3.1.

Where do I get KDE?

The main distribution site for KDE is ftp.kde.org. However, this site is often under heavy load, so you might prefer to use download.kde.org which automatically redirects you to the mirror nearest to you. You can also have a look at the list of KDE mirror sites.

3.2.

Are there Linux® distributions that include KDE?

Yes, major Linux® distributions already ship KDE. As building a distribution takes some time, they might not always contain the latest version, but for a start or to avoid downloading from the Internet, they do provide a good starting point.

You can find an up-to-date list of distributions that ship with KDE here.

3.3.

What is the current version?

Currently, the latest stable version is 3.2

The KDE 3.2 Info Page contains a lot of information specific to this release.

3.4.

Where do I find KDE snapshots?

You can get the latest snapshots from ftp://ftp.kde.org/pub/kde/unstable/snapshots. You might also want to consider setting up your own CVS client in order to maintain the latest snapshot at all times. Please refer to Anonymous CVS and KDE for further information.

3.5.

Where do I get Qt™?

Qt™ is a product of the Norwegian company Trolltech. You can always get the latest Qt™ version from their FTP server.

And with most up-to-date Linux® distributions, Qt™ is already included. Please see Q: 4.3 for the version of Qt™ you need.

3.6.

What is Qt™, by the way?

Qt™ is a C++-based class library to build user interfaces. It also includes many utility classes like string classes and classes to handle input and output. It provides most of the widgets you will see in a KDE application: menus, buttons, sliders, etc.. Qt™ is a cross-platform library that allows you to write code that will compile on UNIX® systems as well as Windows® and embedded devices. You can learn more about Qt™ at http://www.trolltech.com.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 4. Installation instructions
Installation instructions
Prev
Next

Chapter 4. Installation instructions

These are the generic installation instructions for the K Desktop Environment. Please complement your reading with the READMEs and INSTALLs that come along with the package. Please read them carefully and try to help yourself out if anything goes wrong. If you need further assistance, consider joining the KDE mailing lists (see our web site instructions for joining the KDE mailing lists) or newsgroups.

4.1. To the would-be converts
4.2. Available package formats
4.3. Prerequisites
4.4. Description of the base packages
4.5. Installation instructions for the different package formats
4.6. Post-installation procedures
4.7. Should I remove old version xyz before installing a new one?
4.8. How do I start KDE?
4.9. Is it possible to install KDE in a user folder?
4.10. startkde fails with can not connect to X server. What is wrong?
4.11. KDE on AIX?
4.12. KDE on a laptop?
4.13. I have a neomagic chipset in my laptop. Is there anything special I should do to run KDE?
4.14. I do not like the default KDE folder after installation. How do I move it without breaking anything?
4.15. What files can I delete from my KDE install folder? Can all the *.h, *.c and *.o files be safely removed?
4.16. Will I lose my current settings when I upgrade KDE?
4.17. I upgraded KDE and it seemed to go fine, but when I start it, I get a blank grey screen, and nothing happens. There are errors in the console about DCOPserver. What's going on?
4.18. Compiling kdebase gives me a bin/sh: msgfmt: command not found error!
4.19. How do I uninstall KDE applications compiled from source?
4.20. What is up with GIF support?
4.21. How do I install KDE themes?
4.1.

To the would-be converts

So you have heard the rumours. Or you have seen the screenshots. And you are dying to get hold of KDE. But you know next to nothing about this whole “alternative OS” business. Don't worry! You only need to do some (well, maybe not some) reading, that's all!

KDE does not run on any version of Microsoft® Windows® or OS/2 (yet). To run KDE, you need to have a UNIX® system. Please refer to Q: 2.2 for more details.

Decide on a platform and set it up for your system. This FAQ can not help you with this, since KDE runs on many UNIX® platforms.

Finally, you are ready to commence the KDE installation. Please start reading from the next section. To get KDE, please refer to Q: 3.1. Last but not least, if you encounter any problems while installing KDE, please do not hesitate to make use of the KDE mailing lists and newsgroups. But do bear this in mind: no question is too silly to ask, but some are too silly to answer, especially when they are already answered in this FAQ.

Good luck and have fun!

4.2.

Available package formats

You can find several kinds of binary and source packages for different distributions and operating systems on the ftp://ftp.kde.org/pub/kde/. The binary packages are not made by the KDE Team, but by the distributors themselves, or some dedicated individuals. Please refer to KDE Package Policy Explained for information about the KDE Package Policy. The only “official” release is the source tar.bz2 packages. Please refer to the READMEs and INSTALLs in the several binaries folders. For a list of the available packages for a release, refer to the relevant info page. For the latest release this is the KDE 3.2 Info Page.

4.3.

Prerequisites

For KDE 3.2, you need the Qt™ library version 3.2 or greater. Please make sure you download the correct Qt™. You will also need the header files, if you want to compile KDE yourself. They are all available, at no cost, from http://www.trolltech.com/download. In addition, there are optional libraries that might improve KDE if installed on your system. An example is OpenSSL which will enable Konqueror to browse web pages securely and is needed in a version >=0.9.6. These should be provided by your distributor; if not, ask for an update.

4.4.

Description of the base packages

The base distribution currently consists of eleven packages. Some are required, while others are optional. Each package is available in each of the aforementioned package formats.

kdelibs

Required

This package contains shared libraries that are needed by all KDE applications.

kdebase

Required

This package contains the base applications that form the core of the K Desktop Environment like the window manager, the terminal emulator, the control centre, the file manager, and the panel.

aRts

Required

The aRts sound server. A powerful, network transparent sound server.

kdeaddons

Optional

Various plugins for Kate, Kicker, KNewsTicker, Konqueror and Noatun

kdeartwork

Optional

Additional wallpapers, themes, styles, sounds ...

kdebindings

Optional

Various bindings for other languages, including Java™, Perl, Python, ...

kdegames

Optional

Various games like KMahjongg, KSnake, KAsteroids, and KPatience.

kdegraphics

Optional

Various graphics-related programs like PostScript® previewer, DVI previewer, and a drawing program.

kdeutils

Optional

Various desktop tools like a calculator, an editor and other nifty stuff.

kdemultimedia

Optional

Multimedia applications like a CD player and a mixer.

kdenetwork

Optional

Network applications. Currently contains the mail program KMail, the news reader KNode, and several other network-related programs.

kdeadmin

Optional

System administration programs.

kdeedu

Educational and entertaining applications for KDE's younger users.

kdetoys

Optional

Toys!

kdevelop

Optional

A complete Integrated Development Environment for KDE and Qt

aRts and then kdelibs should be installed before everything else, and kdeaddons last. The other packages can be installed in any arbitrary order.

Most package management tools will let you put all these packages in one folder and install them all at once, figuring out the dependencies as they go.

4.5.

Installation instructions for the different package formats

Important

Please do not forget to read the README and INSTALL files if they are available.

Installation of the Debian packages

The Debian packages install in accordance with the upcoming FHS (File Hierarchy Standard).

  1. become superuser

  2. run dpkg -i packagename.deb for every package you want to install.

Installation of the RPM packages

Procedure 4.2. To install binary RPMs

  1. become superuser

  2. execute rpm -ivh packagename.rpm

Installation of the source .tar.bz2 files

Since there are always changes and updates to the way KDE is compiled, please refer to Download and Install from Source for the most up to date installation instructions for the source packages.

The general approach should work in most cases though.

The source .tar.bz2 package installs into /usr/local/kde by default. You can override this setting by using the --prefix option of the configure script.

  1. unpack the packages with tar jxvf packagename.tar.bz2

  2. change folder to the package folder: cd packagename

  3. configure the package: ./configure

    Note

    Some packages (notably kdebase) have special configuration options that might be applicable to your installation. Type ./configure --help to see the available options.

  4. build the package: make

  5. install the package: su -c "make install" (if you aren't already root). If you already are, just type make install.

4.6.

Post-installation procedures

First of all, please make sure that you have added KDE's binary installation folder (e.g. /usr/local/kde/bin) to your PATH and KDE's library installation folder to your LD_LIBRARY_PATH (only necessary on systems that do not support rpath; on Linux® ELF, it should work without). This environment variable may be called differently on some systems, e.g. it is called SHLIB_PATH on IRIX®. Then set the environment variable KDEDIR to the base of your KDE tree, e.g. /usr/local/kde.

Caution

Please bear in mind that it is unwise to set LD_LIBRARY_PATH blindly. In the vast majority of cases it is unnecessary and can do more harm than good. There is a web page written by Dave Barr explaining the evils of LD_LIBRARY_PATH and it can be found at http://www.cis.ohio-state.edu/~barr/ldpath.html.

Even though you can use most of the KDE applications simply by calling them, you can only benefit fully from KDE's advanced features if you use the KDE window manager and its helper programs.

In order to make it easy for you, we have provided a simple script called startkde which gets installed in $KDEDIR/bin and is therefore in your path.

Edit the file .xinitrc in your home folder (make a backup copy first!), remove everything that looks like calling a window manager, and insert startkde instead. Restart the X-Server. If you use kdm/xdm, you will have to edit the file .xsession instead of .xinitrc. And if there is no .xinitrc or .xsession in your home folder, simply create a new one with just one line containing startkde.

Note

Some systems (notably Red Hat® Linux®) use .Xclients instead.

This should present you with a new shining KDE desktop. You can now start to explore the wonderful world of KDE. In case you want to read some documentation first, there is a highly recommended Quick Start guide available. Furthermore, every application has an online help that is available via the help menu.

4.7.

Should I remove old version xyz before installing a new one?

In principle, this is not necessary. RPM and Debian packages should take care of all dependencies.

If you compile the source code yourself, you should take more care. Instructions for running two different versions of KDE on the same system are given at http://developer.kde.org/build/kde2-and-kde3.html. However, please note that running two different versions of KDE from source can lead to problems if you are not careful.

4.8.

How do I start KDE?

The most comfortable method to start KDE is to use the startkde script. Simply put the line startkde at the end of your .xsession file (or your .xinitrc or .Xclients file if you are not using kdm or xdm). Please also remove the lines that start your previous window manager. If there is no .xsession, .xinitrc, or .Xclients in your home folder, simply create a new one that contains just one line: startkde.

4.9.

Is it possible to install KDE in a user folder?

Yes, you can install KDE in any folder you want. What you have to do depends on the kind of packages you want to install:

Procedure 4.4. Source packages

  1. Configure and install the package using configure --prefix=/users/myhome/kde; make; make install to install into /users/myhome/kde.

  2. Add the following to your init files. Please note that if it is not necessary for you to set LD_LIBRARY_PATH, it is better to leave it out.

    For csh or tcsh:

    setenv KDEDIR /users/myhome/kde
    
    if ( $?LD_LIBRARY_PATH ) then
       setenv LD_LIBRARY_PATH $KDEDIR/lib:$LD_LIBRARY_PATH
    else
       setenv LD_LIBRARY_PATH $KDEDIR/lib
    endif
    
    if ( ! $?LIBRARY_PATH ) then
       setenv LIBRARY_PATH $LD_LIBRARY_PATH
    endif  
    

    For bash:

    KDEDIR=/users/myhome/kde
    PATH=$KDEDIR/bin:$PATH
    LD_LIBRARY_PATH=$KDEDIR/lib:$LD_LIBRARY_PATH
    LIBRARY_PATH=$LD_LIBRARY_PATH
    export KDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH
    

Procedure 4.5. RPM packages

  • rpm allows you to use the --prefix option to select the folder you want to install to. For example, executing rpm -i --prefix=/users/myhome/kde package.rpm will install the package to /users/myhome/kde.

Note

Although KDE will run from a user folder, there are some problems with programs that require suid root, e.g. the programs in the kdeadmin package. But since they are not meant to be run by users in the first place, this is nothing to worry about.

However, on systems using shadow passwords, the screensavers have to be suid root to enable password access for unlocking the screen, so this option will not work.

4.10.

startkde fails with can not connect to X server. What is wrong?

You probably tried to start the X server with startkde. The X server is started with startx. startkde is the script that should be run from your .xinitrc, .xsession, or .Xclients to activate the window manager and the necessary server daemons for KDE. See also Q: 4.8.

4.11.

KDE on AIX®?

IBM now officially support KDE on AIX®. You can find details at http://www.ibm.com/servers/aix/products/aixos/linux/index.html. There is also some older information at http://space.twc.de/~stefan/kde/aix.html.

4.12.

KDE on a laptop?

If you can get X Window System® to run on your laptop, you should not have any problem getting KDE to run on it. In addition, you might find the following links helpful:

4.13.

I have a neomagic chipset in my laptop. Is there anything special I should do to run KDE?

On some laptops using the 2160 chipset (MagicGraph 128XD) the following options in XF86Config are needed to avoid a lock-up of the graphic engine:

Option "XaaNoScanlineImageWriteRect"
           Option "XaaNoScanlineCPUToScreenColorExpandFill"

If you have experienced desktop hangs while using KDE please try this option.

4.14.

I do not like the default KDE folder after installation. How do I move it without breaking anything?

Assuming the default is /opt/kde and you want to move it to /usr/local/kde, here's what you have to do:

  1. change to superuser if you aren't already

  2. mv /opt/kde /usr/local/kde

  3. ln -s /usr/local/kde /opt/kde

This will put all your KDE files in /usr/local/kde but everything is still accessible from /opt/kde.

4.15.

What files can I delete from my KDE install folder? Can all the *.h, *.c and *.o files be safely removed?

There should not be any need to keep the .c and .o files, but you might want to keep the .h files, as they are used by includes if you ever want to compile your own KDE programs. But if you wish to add patches to the source programs as they become available (rather than downloading everything again), then they should stay.

4.16.

Will I lose my current settings when I upgrade KDE?

No. In most cases KDE will be able to transport your settings intact. You may need to reenter passwords in some applications (such as KMail or KNode) but most other settings will be safe.

There were mixed reports of results between some previous versions of KDE. To be safe, you may like to back up your entire KDE configuration.

Settings are kept in the $HOME/.kde or $HOME/.kde2 subfolder in your home folder. Copy your old .kde/.kde2 folder to a backup location, install KDE 3.2, and then copy back any necessary mail and news settings. That said, most people can make a direct upgrade, without removing the old .kde folder, without a hitch.

You can override the use of $HOME/.kde by setting the $KDEHOME variable.

4.17.

I upgraded KDE and it seemed to go fine, but when I start it, I get a blank grey screen, and nothing happens. There are errors in the console about DCOPserver. What's going on?

KDE uses several temporary files during its operation. These are usually to be found in the following locations:

  • ~/.DCOPserver-* (there are usually two of these; one is a symlink to the other)

  • ~/.kde/socket-hostname

  • ~/.kde/tmp-hostname which is normally a symlink to the next file:

  • /tmp/tmp-kde-USER

  • ~/.kde/socket-hostname which is also normally a symlink to:

  • /tmp/ksocket-USER

If the symlinks get broken, usually because a cron or shutdown script is emptying out the /tmp folder, then strange things will happen. These files, and the symlinks, will all be created automatically at the start of KDE so you can safely remove them while KDE is not running.

If you are only getting a grey screen when you start KDE, or if you get an error message telling you to Check your installation, then shut down X and delete all the files listed above, then try to restart X.

Normally (i.e. when not upgrading between KDE versions) it's quite safe to leave these files intact, and you may shave a few seconds off your KDE startup time by doing so.

4.18.

Compiling kdebase gives me a bin/sh: msgfmt: command not found error!

You need the GNU msgfmt which is part of the GNU i18n package gettext. You should be able to download it from any GNU mirror.

4.19.

How do I uninstall KDE applications compiled from source?

You can uninstall your programs by typing make uninstall in the folder where you did make install. If you have already deleted that folder, then there is only one way, and it is not good: go to $KDEDIR/bin and start deleting files one by one.

If you expect to find yourself in this situation, you might want to consider a program such as GNU stow, found at http://www.gnu.org/software/stow/stow.html.

4.20.

What is up with GIF support?

This has to do with issues with Unisys' LZW patent. GIF support is turned off from Qt™ 1.44 onwards by default. When you want to use GIFs and have the relevant license, recompile Qt™ with GIF support. ./configure -gif.

4.21.

How do I install KDE themes?

Theme support in KDE has been discontinued with this version. However, there are many opportunities to personalise and add eye candy to KDE Look at, for example, Appearance & Themes in KControl.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 5. The panel
The panel
Prev
Next

Chapter 5. The panel

5.1. How do I add applications to the KDE panel (Kicker)?
5.1.

How do I add applications to the KDE panel (Kicker)?

There are several ways to add an application to the panel, of which the easiest is to right-click on the panel, and from the context menu which appears, select Panel Menu->Add->Application Button and then the application for which you want to add a link.

For more ways of adding buttons to the panel, refer to the Kicker Handbook.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 6. The desktop
The desktop
Prev
Next

Chapter 6. The desktop

6.1. How do I add an application to the desktop?
6.2. How do I mount/unmount a device from the desktop?
6.3. Where are the icons kept?
6.4. How do I use the mouse scroll wheel in KDE?
6.5. Why can't I get system sound to work, like for opening windows?
6.6. How do I launch applications in a particular desktop?
6.7. Where do I save my files if I want them to appear directly on the desktop?
6.1.

How do I add an application to the desktop?

Just choose the desired application from the K menu and drag and drop it to the Desktop.

For applications not listed in the K menu, use the right mouse button on the desktop and choose Create New->File->Link to Application... and fill in the configuration for the application you want to link to.

6.2.

How do I mount/unmount a device from the desktop?

First, make sure you are allowed to mount/umount the relevant device as a user.

Then you can add any device via right mouse button on the desktop and then choosing Create New.

6.3.

Where are the icons kept?

The icons can be found only in $KDEDIRS/share/icons or $HOME/.kde/share/icons or $HOME/.kde2/share/icons. To use icons stored in other locations, you must either copy them into one of the above-mentioned fixed KDE locations or make symlinks.

6.4.

How do I use the mouse scroll wheel in KDE?

Mouse wheel support comes with Qt™ 2.0 and above, so KDE based on that will automatically support the use of the mouse scroll wheel.

6.5.

Why can't I get system sound to work, like for opening windows?

System sound currently does not work on non-FreeBSD and non-Linux® systems. This is being worked on. If you use FreeBSD or Linux®, you have found a bug, so please report it.

6.6.

How do I launch applications in a particular desktop?

KDE comes with a program called kstart. To start an xterm on the second desktop and then activate it use: kstart --desktop 2 --activate --window "xterm" xterm.

Note that the --window option is important. It takes an argument which is a regular expression matching the title of the window to apply the settings to.

Please read kstart --help-all for more magic available with kstart (and there is an abundance).

6.7.

Where do I save my files if I want them to appear directly on the desktop?

$HOME/Desktop. You might need to refresh your desktop after you have saved your files.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 7. The window manager
The window manager
Prev
Next

Chapter 7. The window manager

The default window manager provided by KDE is the K Window Manager (KWin). Please read “The K Window Manager Handbook” (which should be accessible from the KDE Help Centre) for usage information.

7.1. Are there keyboard shortcuts for KWin operations?
7.2. Can I define my own set of keyboard shortcuts?
7.3. When I "iconify" a window, it disappears. Where does it go?
7.4. How do I maximise windows only vertically or horizontally?
7.5. What is shading a window?
7.1.

Are there keyboard shortcuts for KWin operations?

Yes. Please refer to "The K Window Manager Handbook" for the list of shortcuts available.

7.2.

Can I define my own set of keyboard shortcuts?

Yes. Launch the KDE Control Centre and select Regional & Accessibility->Keyboard Shortcuts to configure window manager bindings like maximising windows, etc..

7.3.

When I "iconify" a window, it disappears. Where does it go?

With many X Window System® GUIs, the minimise button (a little dot) will erase the window that the program is running in and create, instead, an icon on the desktop. KDE does not do this. Instead, when a window is iconified it is simply hidden (but the program is still running).

There are a few ways to access “disappeared” windows:

  • If you are running the taskbar part of Kicker, you can choose to have a list of tasks displayed on your desktop. Iconified tasks will have their names displayed in grey.

  • If you click the middle mouse button on the root window (i.e., the background of the desktop), KWin will give you a list of all available tasks.

7.4.

How do I maximise windows only vertically or horizontally?

Provided your window is not already maximised, clicking on the maximise button with the left mouse button/middle mouse button/right mouse button will maximise fully/vertically/horizontally respectively.

7.5.

What is “shading” a window?

By “shading” a window we mean “rolling up” the window leaving just the title bar visible. You can do this by double clicking on the window title bar.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 8. The File Manager and Web Browser
The File Manager and Web Browser
Prev
Next

Chapter 8. The File Manager and Web Browser

The file manager and web browser of KDE is Konqueror. The Konqueror home page is located at http://www.konqueror.org where a Konqueror specific FAQ can be found.

8.1. How do I use Konqueror as a web browser with a proxy?
8.2. How can I change the appearance of a folder in Konqueror?
8.3. How can I do non-anonymous FTP transfers with Konqueror?
8.4. What are %i and %m in the Execute line?
8.5. How do I specify the startup folder for Konqueror?
8.6. How do I import Netscape bookmarks?
8.7. How do I fool a site into believing Konqueror is Netscape or some other browser?
8.8. How do I configure Konqueror to run Java applets?
8.9. What is this new Smart policy for JavaScript web popups?
8.10. Why doesn't my banking site work with Konqueror? It pops up a new window with the login screen in other browsers, but not in Konqueror.
8.11. Why can't Konqueror render GIF images?
8.12. How do I rename files?
8.1.

How do I use Konqueror as a web browser with a proxy?

Konqueror can be used with HTTP and FTP proxies. To set up the proxy server in Konqueror, just select Settings->Configure Konqueror... from the Konqueror menu and go to the Proxy tab.

8.2.

How can I change the appearance of a folder in Konqueror?

Right-click the folder, select Properties, click on the large icon in the dialogue which appears and choose another icon.

To change the icon displayed for entries in the K Menu, use the Menu Editor, located at Settings->Menu Editor.

8.3.

How can I do non-anonymous FTP transfers with Konqueror?

Normally, if you enter a URL like ftp://ftp.somehost.com, Konqueror will attempt an anonymous login to the FTP server. If you want to login as a particular user, enter a URL like ftp://username@ftp.somehost.com instead. Konqueror will ask for your password and connect to the server.

8.4.

What are %i and %m in the Execute line?

They are used by all KDE applications (since they are implemented in KApplication and all good KDE programs create a KApplication object before they even look at the command line arguments).

A standard line for a KDE application looks like this: foo ... %i %m -caption \"%c\". Pretty confusing, but it has been designed in that way so that it can integrate legacy, non-KDE applications as smoothly as possible. Konqueror, when executing the line above, will extend the command to foo -icon something.png -miniicon something_mini.png -caption \"The Foo\". Both the icon and the mini-icon as well as "The Foo" are properties defined in the .desktop file. If the icons are not defined, they simply default to the executable name foo.

This way a user can change these things in KMenuEdit for his or her applications. The -caption option is important, because no user will accept that the menu item Editor starts something called kedit-0.9pl4-build47. Instead, he expects a window called Editor. Furthermore these names are localised, i.e. an American user launches CD-Player and gets a window called CD-Player while a German user launches CD-Spieler and gets a window called CD-Spieler.

8.5.

How do I specify the startup folder for Konqueror?

Using the right mouse button, click on the Home icon and choose Properties. Under the Application tab you will probably find something like kfmclient openProfile filemanagement; just append file:/whereever/you/want with the folder you would like Konqueror to start in.

8.6.

How do I import Netscape® bookmarks?

There is no need to import anything at all. Netscape® bookmarks are automatically available under the Bookmarks menu in Konqueror with no configuration on your part necessary. The Bookmark Editor is able to convert Netscape® bookmarks to the format used by Konqueror, if you want this.

8.7.

How do I fool a site into believing Konqueror is Netscape® or some other browser?

In Konqueror, select Settings->Configure Konqueror... and in the configuration dialogue, select Browser Identification. Default and site-specific browser identifications can be set from here.

8.8.

How do I configure Konqueror to run Java™ applets?

Choose Settings->Configure Konqueror... from Konqueror's menubar and then select Java & Javascript. Set the Path to Java executable correctly. If it doesn't work, please check the Konqueror + Java HOWTO.

8.9.

What is this new Smart policy for JavaScript web popups?

This new policy attempts to block intrusive JavaScript popup windows. If the user does not click on a button or submit a form to trigger the popup, then the popup is not permitted. Some sites will open a second new window from within the first and in that case, the second window will not show.

8.10.

Why doesn't my banking site work with Konqueror? It pops up a new window with the login screen in other browsers, but not in Konqueror.

Make sure you have Javascript enabled, and the default JavaScript web popups policy set to Ask or Allow. The Smart policy is not always sufficient for some banks. Many banks also require Java™ support. You can find more help on enabling this at http://www.konqueror.org/.

8.11.

Why can't Konqueror render GIF images?

It is because you did not enable GIF support in Qt™. Please see Q: 4.20 for more details.

8.12.

How do I rename files?

Simply right click on the file and select Rename or click once on an already selected file. The default keyboard shortcut to rename a file is F2.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 9. Configuring KDE
Configuring KDE
Prev
Next

Chapter 9. Configuring KDE

9.1. How do I set the language used by KDE?
9.2. Is there any keyboard switcher for international keyboards for KDE?
9.3. How do I replace the standard text login screen with the KDE login screen?
9.4. I would like to click the left mouse button anywhere on the desktop and have the K menu displayed.
9.5. Where do I find information regarding KDE themes?
9.6. How do I change MIME Types?
9.7. KDE (kdm) does not read my .bash_profile!
9.8. How do I use TrueType fonts in KDE?
9.9. Is it possible to enter, show and work with the Euro Symbol in KDE?
9.1.

How do I set the language used by KDE?

There are two ways to set the language KDE uses in the messages it will display:

Using the KDE Control Centre

Fire up the KDE Control Centre and select Regional & Accessibility followed by Country/Region & Language. You can select your language and location here. If KDE cannot find a translation in the first language chosen, it will fall back on the default language. This is usually (American) English by default.

Note

Using the KDE Control Centre is the preferred way of choosing languages in KDE.

Using the LANG environment variable

The second method uses the standard locale setting on your system. To change the language, simply set the environment variable LANG accordingly. For example, if your shell is bash, execute export LANG=de to set German as the language used.

9.2.

Is there any keyboard switcher for international keyboards for KDE?

Yes, you can configure it using the KDE Control Centre Regional & Accessibility Keyboard Layout configuration page.

9.3.

How do I replace the standard text login screen with the KDE login screen?

Note

Your distribution/UNIX® flavour may have its own setup tools to change this (e.g. YaST on SuSE® Linux®). This will be the safest way to enable the KDE login screen. However, if for some reason you do not wish to use these tools, the following instructions may be useful.

First, you need to change to the “xdm runlevel” (runlevel 5 on Red Hat® and SuSE® systems) by editing your /etc/inittab file. In the file, you should have a line saying id:3:initdefault:. Change it to id:5:initdefault:. Now, at the end of the file, comment out the following line: x:5:respawn:/usr/bin/X11/xdm -nodaemon and replace it with x:5:respawn:/opt/kde/bin/kdm -nodaemon.

Note

The location of kdm may differ on your system.

For changes to take effect immediately, type init 5 (for Red Hat® systems) at the shell prompt.

Caution

It is risky to initiate a graphical login without checking beforehand whether it works. If it fails to work, you would be in for a hard time getting back....

For FreeBSD, you should edit the file /etc/ttys and change one of the lines that look like

ttyv8   "/usr/X11R6/bin/xdm -nodaemon"  xterm   off secure
to instead say ttyv8 "/usr/local/bin/kdm -nodaemon" xterm off secure.

9.4.

I would like to click the left mouse button anywhere on the desktop and have the K menu displayed.

Open the KDE Control Centre and choose Desktop->Behaviour. You can now choose the behaviour of mouse clicks on the desktop. To have the K menu open from a single left mouse button click, change the entry labelled Left button to say Application Menu.

9.5.

Where do I find information regarding KDE themes?

Go to http://kde.themes.org/ or http://www.kde-look.org.

9.6.

How do I change MIME Types?

If you are using Konqueror, do this instead: first, open a Konqueror window and choose Settings->Configure Konqueror, then File Associations. Find the type you want to change (e.g. text/english or image/gif), and set the application preference order to whatever you want.

9.7.

KDE (kdm) does not read my .bash_profile!

The login managersxdm and kdm do not run a login shell, so .profile, .bash_profile, etc. are not sourced. When the user logs in, xdm runs Xstartup as root and then Xsession as user. So the normal practice is to add statements in Xsession to source the user profile. Please edit your Xsession and .xsession files.

9.8.

How do I use TrueType® fonts in KDE?

You need to install TrueType® font support into your X Window System® configuration. Please take a look at x.themes.org for the fonts, and xfsft: TrueType® Font Support For X11 or X-TrueType® Server Project Home Page for the font servers.

If you have a bunch of TrueType® fonts from Microsoft® Windows®, edit the XF86Config file to get the fonts from the font folder. Then just tell KDE to use these new fonts with the font administrator utility.

9.9.

Is it possible to enter, show and work with the Euro Symbol in KDE?

Yes and no. For details, look here: http://www.koffice.org/kword/euro.php.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 10. KDE applications
KDE applications
Prev
Next

Chapter 10. KDE applications

10.1. KPPP
10.2. Konsole
10.3. KMail
10.1.

KPPP

Many KDE users report problems using KPPP. But before you complain about KPPP, make sure you have already checked the following:

  • Can you dialup to your ISP without using KPPP? If you cannot, then perhaps KPPP is not the culprit after all.

  • Have you gone through the KPPP documentation at least three times and followed its instructions and trouble-shooting suggestions?

The KPPP documentation can be accessed through the KDE Help Centre. Last, but not least, the KPPP homepage is at http://ktown.kde.org/~kppp/.

Now, if you still encounter problems, here's what might help you solve them:

How do I change the MTU setting in KPPP?

Open up the KPPP dialogue box and select Setup. Choose an existing account and click Edit, or New to create a new dialup account. Select the Dial tab and click Arguments. Type what you want to change in the Argument textbox (e.g. mtu 296) and click Add. When you are satisfied, click Close.

To check whether the options “took”, do one of the following:

  • In a terminal window, run /sbin/ifconfig ppp0 and look at the reported MTU in the output. It should match your request.

  • Add debug and kdebug (each on a separate line) to your /etc/ppp/options file and restart your PPP session. You will find debugging messages in /var/log/messages, including MRU and MTU settings.

If you want, the MRU and MTU settings can be added to the options file, one complete setting per line, no quotes or dashes.

KPPP connects at a slower speed than normal.

The following might do the trick:

  • Try executing setserial spd_hi.

  • The default MTU value is 1500, which maybe too large for a dialup connection. Try changing it to a smaller value like 296 or 576.

  • Check in your $HOME/.kde/share/config for the kppprc. Ensure the correct modem speed is actually defined there.

10.2.

Konsole

How do I page-up or page-down?

Use Shift+Page Up and Shift+Pg Dn.

How do I perform a simple “copy” from Konsole to anything else?

When I do a ls, first I select with the mouse the desired text, press Ctrl+C, then I make the target application active, point the mouse to the relevant part and press Ctrl+V. Alternatively, highlight the text by dragging with the left mouse button down and paste by clicking with the middle mouse button (or both buttons if you are using a 2 button mouse with 3 button emulation).

10.3.

KMail

KMail has its own home page at http://kmail.kde.org where an FAQ is available.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 11. KDE with non-KDE applications
KDE with non-KDE applications
Prev
Next

Chapter 11. KDE with non-KDE applications

11.1. My non-KDE applications like Emacs and kterm are running amok with strange colours!
11.1.

My non-KDE applications like Emacs and kterm are running amok with strange colours!

Start the KDE Control Centre and in Appearance & ThemesColours uncheck the Apply colours to non-KDE applications checkbox and click Apply.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 12. Useful tips
Useful tips
Prev
Next

Chapter 12. Useful tips

12.1. Reading documentation in KDE
12.2. Move or resize windows quickly
12.3. Killing windows in KDE
12.4. What if something is so wrong that I ca not even get the skull & crossbones cursor? How do I get out of a total lockup?
12.1.

Reading documentation in KDE

Pop up the Run Command window (Alt+F2 by default) and type:

  • man:command for man pages. It even unpacks on the fly if the man pages are gzipped.

  • info:command for info pages.

  • help:kdeappname for KDE application help pages.

You can also enter any of these in the Location text box in Konqueror.

Or you can use the KDE Help Centre if you are using KDE 2. Simply start the KDE Help Centre by clicking on the icon (the blue book with the yellow key) on the toolbar. Once the KDE Help Centre has loaded, the window on the left will contain an entry called Unix manual pages. Click once on this entry, and you can browse through all the installed manual pages on your system.

12.2.

Move or resize windows quickly

To move a window, use Alt+left mouse button. Alt+right mouse button will resize the window. Last but not least, Alt+middle mouse button raises/lowers the window. The KDE Control Centre allows you to change these mouse bindings.

12.3.

Killing windows in KDE

There is a standard keybinding (Ctrl+Alt+Esc) that gives you a skull & crossbones cursor. Click that cursor on a window to kill it. The keybindings are viewable/changeable from the KDE Control Centre.

Caution

Using this option kills the program forcibly. Data may be lost, and some processes related to the program may remain active. Use only as a last resort.

12.4.

What if something is so wrong that I ca not even get the skull & crossbones cursor? How do I get out of a total lockup?

These kind of locks tend to occur when an application locks up while it has a so called “mouse/keyboard grab”. When that happens you can try to select a virtual text console with Ctrl+Alt+F1 and login. With the following command you will get a list of all running processes:

        ps -aux | more

By killing the process that has the mousegrab, your desktop will come to life again. Unfortunately you ca not see which process that is, so you will have to find out through trial and error. To kill a process use:

        kill -9 pid

Here pid is the process id of the process, which is the first number on each line reported by ps -aux.

You can switch back to the desktop with Ctrl+Alt+F7 (or F8 through F9 depending on your operating system) to see if things work again. When you press Alt+Tab you should get a response from the window manager. If not, you need to get back to the text console and try to kill another process.

Good candidates to kill are: the application you were working with, Kicker, Klipper and KDesktop.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 13. Miscellaneous questions
Miscellaneous questions
Prev
Next

Chapter 13. Miscellaneous questions

13.1. Why does KDE use Qt?
13.2. Why does KDE not use gtk, xforms, xlib, whatever?
13.3. But Qt isn't free, is it?
13.4. Does KDE have terminal emulators with transparent background?
13.5. How do I create icons for non-KDE applications that I can put in the K menu? Where do these icons go?
13.6. What about KDE programs that do not have icons? How do I get them into the menu?
13.7. Does KDE have a graphical FTP client?
13.8. How do I exit KDE?
13.9. Is there a program that checks for new mails at my ISP if and only if I am online?
13.10. Is it really necessary to upgrade to the latest version?
13.11. How do I copy and paste in KDE?
13.12. How do I convert the default Red Hat menus into a menu in the K menu?
13.13. What is CVS?
13.14. Does KDE support dual screen (Xinerama)?
13.15. Why does Drag and Drop not work with Xinerama?
13.16. How do I check which version of KDE I am using?
13.17. Can I write commercial software for KDE?
13.18. How do I go about creating themes and icons?
13.19. Is KLyX dead?
13.20. How can I get to know about development updates?
13.1.

Why does KDE use Qt™?

Qt™ is a very sophisticated toolkit that provides everything that is needed to build a modern user interface. Qt™ is written in C++, thus allowing object-oriented development which ensures efficiency and code reuse in a project the size and scope of KDE. In our opinion there is no better toolkit available for UNIX® systems and that it would have been a grave mistake to try to build KDE on anything but the best.

13.2.

Why does KDE not use gtk, xforms, xlib, whatever?

There are a number of toolkits available. To provide a consistent user interface and to keep used resources such as memory to a minimum, KDE can use only one of them. Qt™ was selected for the reasons mentioned above.

13.3.

But Qt™ isn't free, is it?

It is! As of September 4, 2000, version 2.2 of the Qt™ libraries were licensed under the GPL, thereby fulfiling all aspects of “free software”.

13.4.

Does KDE have terminal emulators with transparent background?

Yes and no. Konsole has the ability to simulate transparency by redrawing the background of the window inside the Konsole window. This gives the illusion of transparency, but if you place Konsole on top of another window, the transparency is lost. Eterm should work fine under KDE if you desire more complete transparency.

13.5.

How do I create icons for non-KDE applications that I can put in the K menu? Where do these icons go?

Create them using your favourite image manipulator, for example, GIMP, or the KDE Icon Editor and put them in $KDEDIR/share/icons(/mini) or $HOME/.kde/share/icons(/mini).

13.6.

What about KDE programs that do not have icons? How do I get them into the menu?

Use KMenuEdit. To access it use the right mouse button on the K button and select Menu Editor.

13.7.

Does KDE have a graphical FTP client?

Yes, and it is none other than your favourite file manager, Konqueror. You can drag and drop remote files into local folders.

13.8.

How do I exit KDE?

Simply click on the K button and select Logout. In addition, if you right click on an empty area of the desktop, you will be presented with a menu containing logout as one of the options.

Note

Depending on your configuration of the X Window System®, Ctrl+Alt+Backspace might also do the trick by killing the X server, but its use prevents session management and cannot be recommended.

13.9.

Is there a program that checks for new mails at my ISP if and only if I am online?

KOrn will do the job. If you are not connected, it will just sit there (idling).

13.10.

Is it really necessary to upgrade to the latest version?

We recommend to always use the latest stable release. If you don't, it will probably be difficult to get answers to your questions. If you have a problem with an old version, the answer will probably be “Please upgrade and try again”. Note that new versions also sometimes fix security problems.

13.11.

How do I copy and paste in KDE?

The simplest method is to use your mouse:

  1. Highlight the text you want to copy by holding down the left mouse button and dragging across the text.

  2. Go to the destination area; depending on your configuration, you might need to click it using the left mouse button to give it focus.

  3. Click the middle mouse button to paste. If you have a two button mouse and are emulating a three button mouse, push both buttons simultaneously.

13.12.

How do I convert the default Red Hat® menus into a menu in the K menu?

Click on the K button and select System->Appfinder.

13.13.

What is CVS?

It stands for Concurrent Versions System. It is a version control system and is based on RCS (Revision Control System), but offers more functionality. It is used to maintain source code under development. It will keep multiple versions of things (handy if you broke something and have to back up and get a clean old version), and allows people remote access over the Net to pick up the latest source code and even to check in new files if they have permission. It is also open source (you pay for support if you want it), and since it is free it is the system of choice for people writing more free products, such as KDE.

13.14.

Does KDE support dual screen (Xinerama)?

Yes, you need to have a multi-headed X server (e.g. MetroX or XFree86 4.0 and above) and a KDE >= 2.2.1

13.15.

Why does Drag and Drop not work with Xinerama?

You should upgrade to XFree86 4.2.0 for this to work properly.

13.16.

How do I check which version of KDE I am using?

Fire up your KDE Control Centre. It comes up with an Info Screen including the version of KDE The KDE version is also included in the application's About dialogue.

13.17.

Can I write commercial software for KDE?

You can use the KDE libraries to write “commercial and closed source” as well as “commercial and open source” software. If you write open source software you can use the Qt™ free edition. But if you write closed source software you may not use the Qt™ free edition; you need to obtain the Qt™ professional edition from Troll Tech.

If you want more information, please contact Troll Tech directly.

13.18.

How do I go about creating themes and icons?

Go see http://artist.kde.org.

13.19.

Is KLyX dead?

Yes. But future versions of LyX will be GUI independent. Check the progress of the various GUI frontends here.

13.20.

How can I get to know about development updates?

You might want to subscribe to the various KDE mailing lists available, especially kde-cvs, which lists all commits done to the KDE CVS repository. Check http://lists.kde.org if you want to read without subscribing.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 14. Getting more information
Getting more information
Prev
Next

Chapter 14. Getting more information

14.1. Where is the KDE homepage?
14.2. Is there a KDE mailing list?
14.3. How do I subscribe/unsubscribe to these lists?
14.4. Is there a mailing list archive?
14.5. Is there a newsgroup about KDE?
14.6. Are there any other KDE-related FAQs?
14.1.

Where is the KDE homepage?

The KDE homepage is located at http://www.kde.org. If you prefer a local mirror, there are several to choose from. For a current list of web site mirrors sorted by location, please visit http://www.kde.org/mirrors/web.php.

14.2.

Is there a KDE mailing list?

There are several KDE mailing lists. Each focuses on a different aspect of KDE. Some are for developers, so they are not discussed in detail. Some of the more important lists that users might be interested in are:

kde

This is the main KDE mailing list for general discussions.

kde-announce

This list is used to announce new versions of KDE as well as new tools and applications.

kde-look

This is the list that deals with questions about look and feel, and general user interface considerations.

For the complete list of mailing lists available, please refer to http://www.kde.org/mailinglists/.

Please note that it is not a good idea to ask questions which are already answered in this FAQ.

14.3.

How do I subscribe/unsubscribe to these lists?

To subscribe, send an email to list-request, that is:

The email must contain subscribe your_email_address in the subject.

To unsubscribe, send an email to list-request, that is:

The email must contain unsubscribe your_email_address in the subject.

Important

Never send subscribe/unsubscribe request to the mailing lists directly! Use the list-request instead.

There is also a complete list of all KDE-related mailing lists, and a web interface for subscribing and unsubscribing located at http://master.kde.org/mailman/listinfo.

14.4.

Is there a mailing list archive?

Yes, there is a searchable mailing list archive hosted by Progressive Computer Concepts. The URL is http://lists.kde.org. There you will see a folder listing of the mailing lists. Note that you can only do a subject/author search at this level. You probably will not find what you want doing this kind of search.

To do a body search, you have to enter one of the mailing lists. Just click on the folder you want to search (e.g.kde” or “kde-user”) and then the pull-down menu by the search box will default to “Body” searches. To be thorough, you should probably search the “kde”, “kde-user”, and “kde-devel” folders.

14.5.

Is there a newsgroup about KDE?

Yes, there is! It is at comp.windows.x.kde. In addition, there is also a German newsgroup at de.alt.comp.kde. Please note that it is not a good idea to ask questions which are already answered in this FAQ.

14.6.

Are there any other KDE-related FAQs?

Yes. Here is a list of them:

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 15. Contributing
Contributing
Prev
Next

Chapter 15. Contributing

15.1. How can I contribute to KDE?
15.2. How do I submit a bug report?
15.3. I want to program for KDE. What should I do first?
15.4. How do I get access to the CVS?
15.5. I am just curious. Can I have read-only access to the CVS?
15.6. Are there any cvs mirror sites for KDE?
15.7. How do I go about translating KDE programs into my native language?
15.1.

How can I contribute to KDE?

KDE is a free software project that lives from voluntary contributions. Everybody is encouraged to contribute to KDE. Not only programmers are welcome. There are many ways in which you can help to improve KDE:

  • Test the software.

  • Send in bug reports. For more information on this, see How do I submit a bug report?.

  • Write documentation or help files. You can get some information by visiting the KDE Editorial Team Home Page.

  • Translate programs, documentation, and help files. For more information on this, you should visit The KDE Translators' and Documenters' Web Site.

  • Draw nice icons or compose sound effects. You can visit the KDE artists page to find out more.

  • Write articles and books about KDE. If you want to help spread the word about KDE, simply send an email to . This will get you in touch with the KDE public relations volunteers.

  • Program new KDE applications. Please refer to Q: 15.3 for more information.

  • Of course, sponsors are also welcome. :-)

There are several places to look for more information if you want to get involved in the development. The first step is to subscribe to some of the mailing lists. You will soon see something that can be improved or added.

15.2.

How do I submit a bug report?

There is a bug tracking system available at http://bugs.kde.org. The system features a wizard to submit new bug reports and a list of all known bugs.

The easiest way to submit a bug is to select Help->Report Bug... from the menu bar of the application with the bug. This will open a small dialogue box with a link to the bug tracking system. Please make sure to follow the instructions of the bug reporting wizard.

15.3.

I want to program for KDE. What should I do first?

Everybody is encouraged to develop software for KDE. What you should do first depends strongly on your experience, e.g. whether you have already learned C++ or have experience with the Qt™ toolkit and so on.

To get into KDE programming, you will need some basic tools: automake, autoconf, and egcs. You should look to http://developer.kde.org/ for more tips.

Another excellent resource for learning KDE programming is the Qt™ online tutorials. These are installed along with Qt™. To view them, open $QTDIR/doc/html/index.html in Konqueror and bookmark it. The tutorials can be found under "Using Qt". The source code for each lesson can be found in the $QTDIR/tutorial directory.

There is, however, one thing that everybody interested in programming for KDE should do: subscribe to the developers mailing list. To subscribe, you have to send an email to kde-devel-request@kde.org with the subject subscribe your_email_address.

Important

Please read How to subscribe/unsubscribe to these lists carefully. Everything said there applies to the development list as well.

15.4.

How do I get access to the CVS?

The KDE project uses CVS to develop the core parts of the software. Usually, when you have changed one of the parts (e.g. fixed a bug), and you want to commit this change, the best way is to create a patch against a current snapshot and send this patch to the developer/maintainer of the respective program.

If you are doing this more or less regularly, you can ask Stephan Kulow, for direct access to the CVS server. But be aware that more users will slow down CVS access for all developers, so we want to keep the number of people with direct CVS access reasonably small. But feel free to ask!

15.5.

I am just curious. Can I have read-only access to the CVS?

Yes. It is possible to get read-only access to the CVS repository with cvsup or cvs utility. You can find more information about how to set up cvsup for the KDE repository from How to use cvsup to get KDE.

In addition, anonymous CVS service is also available. To find out more about how to set up and use anonymous CVS, please see here.

15.6.

Are there any cvs mirror sites for KDE?

Yes. The main KDE server is normally very busy. Please take a look at http://developer.kde.org/source/cvsupmirrors.html and http://developer.kde.org/source/anoncvs.html for the list of available mirrors.

Once you have selected a new cvsup server, simply replace

 
*default host=cvs.kde.org
with
 
*default host=cvsup.your.new.host
in your cvsup script.

The instructions to change the anoncvs server can be found on http://developer.kde.org/source/anoncvs.html, too.

15.7.

How do I go about translating KDE programs into my native language?

Look at the The KDE Translators' and Documenters' Web Site to see whether your program is already translated (most are). Otherwise you will find information there on how to do it yourself.

Prev
Next
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Chapter 16. Credits and Licence
Credits and Licence
Prev

Chapter 16. Credits and Licence

The current FAQ maintainers are:

  • Rainer Endres

Many of the answers in this FAQ are taken from the various KDE mailing lists and newsgroups. Here is a big thank you to all of you who have contributed answers that eventually appear in this FAQ.

Special thanks go to the former FAQ maintainer, who has written most of the stuff in here, and did a tremendous job: Mr. Lee Wee Tiong

Conversion to British English: Malcolm Hunter

This documentation is licensed under the terms of the GNU Free Documentation License.

Prev
Home


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Next
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team