From 4aed2c8219774f5d797760606b8489a92ddc5163 Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/faq/Makefile.am | 4 + doc/faq/TODO | 35 +++ doc/faq/about.docbook | 72 +++++ doc/faq/configkde.docbook | 250 ++++++++++++++++ doc/faq/contrib.docbook | 164 ++++++++++ doc/faq/desktop.docbook | 97 ++++++ doc/faq/filemng.docbook | 207 +++++++++++++ doc/faq/getkde.docbook | 79 +++++ doc/faq/index.docbook | 136 +++++++++ doc/faq/install.docbook | 726 +++++++++++++++++++++++++++++++++++++++++++++ doc/faq/intro.docbook | 93 ++++++ doc/faq/kdeapps.docbook | 158 ++++++++++ doc/faq/misc.docbook | 219 ++++++++++++++ doc/faq/moreinfo.docbook | 154 ++++++++++ doc/faq/nonkdeapps.docbook | 106 +++++++ doc/faq/notrelated.docbook | 232 +++++++++++++++ doc/faq/panel.docbook | 193 ++++++++++++ doc/faq/qt.docbook | 76 +++++ doc/faq/questions.docbook | 160 ++++++++++ doc/faq/sound.docbook | 55 ++++ doc/faq/tips.docbook | 137 +++++++++ doc/faq/webbrowse.docbook | 222 ++++++++++++++ doc/faq/winmng.docbook | 134 +++++++++ 23 files changed, 3709 insertions(+) create mode 100644 doc/faq/Makefile.am create mode 100644 doc/faq/TODO create mode 100644 doc/faq/about.docbook create mode 100644 doc/faq/configkde.docbook create mode 100644 doc/faq/contrib.docbook create mode 100644 doc/faq/desktop.docbook create mode 100644 doc/faq/filemng.docbook create mode 100644 doc/faq/getkde.docbook create mode 100644 doc/faq/index.docbook create mode 100644 doc/faq/install.docbook create mode 100644 doc/faq/intro.docbook create mode 100644 doc/faq/kdeapps.docbook create mode 100644 doc/faq/misc.docbook create mode 100644 doc/faq/moreinfo.docbook create mode 100644 doc/faq/nonkdeapps.docbook create mode 100644 doc/faq/notrelated.docbook create mode 100644 doc/faq/panel.docbook create mode 100644 doc/faq/qt.docbook create mode 100644 doc/faq/questions.docbook create mode 100644 doc/faq/sound.docbook create mode 100644 doc/faq/tips.docbook create mode 100644 doc/faq/webbrowse.docbook create mode 100644 doc/faq/winmng.docbook (limited to 'doc/faq') diff --git a/doc/faq/Makefile.am b/doc/faq/Makefile.am new file mode 100644 index 000000000..9c7a6607a --- /dev/null +++ b/doc/faq/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = khelpcenter/faq + diff --git a/doc/faq/TODO b/doc/faq/TODO new file mode 100644 index 000000000..42a37ca29 --- /dev/null +++ b/doc/faq/TODO @@ -0,0 +1,35 @@ +TODO: + +- Cull any questions that are specific to KDE =< 3.4 +- Look into reorganising sections to make finding things much easier. + + + +I'm keeping this in here for the amusement factor. Every time I look at it I rememeber that while I'm not a very good FAQ maintainer, physos wasn't much better ;) + +Last modified by physos 2002-12-27 + +Before 3.2 release +_________________________________________________ + +- Split up the monolith docbook (done) +- Get rid of 1.1.2 stuff (confusion) +- check if things are still working + * compile tutorials for the various OS's + * workarounds still needed? + * workarounds still working? + * answers are still valid? + * easier solutions? +- complete revision ? +- New structure ? +- Find maintiners for single parts +- what needs to be added ? + +[22:15:47] 1: move the faq (and other kdebase docs) up to kdebase/doc/ +so that docs.kde.org will pick them up and generate them +[22:16:05] then remove the copies on www.kde.org, put in redirects to the new +location, and have one, autogenerated and searchable copy all the time +[22:16:17] sounds nice +[22:16:24] will look into it + + diff --git a/doc/faq/about.docbook b/doc/faq/about.docbook new file mode 100644 index 000000000..89c7b6033 --- /dev/null +++ b/doc/faq/about.docbook @@ -0,0 +1,72 @@ + + + +About this <acronym>FAQ</acronym> + + + + +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. The email address of the current maintainer is jhall@kde.org. + + +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. + + You might also want to consider becoming a +FAQ maintainer. Please refer to for more details. + + + + + + +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 kde-doc-english@kde.org. + + + + + + + + diff --git a/doc/faq/configkde.docbook b/doc/faq/configkde.docbook new file mode 100644 index 000000000..f0cb4d2be --- /dev/null +++ b/doc/faq/configkde.docbook @@ -0,0 +1,250 @@ + + +Configuring &kde; + + + + +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 Center +Fire up the &kde; Control Center 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. +Using the &kde; Control Center 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. + + + + + + + +Is there any keyboard switcher for international keyboards for +&kde;? + + + +Yes, you can configure it using the &kde; Control Center +Regional & Accessibility +Keyboard Layout + configuration page. + + + + + + +How do I replace the standard text login screen with the +&kde; login screen? + + +Your distribution/&UNIX; flavor may have its own setup tools to +change this (⪚ 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 +&RedHat; 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. +The location of &kdm; may differ on your +system. +For changes to take effect immediately, type init +5 (for &RedHat; systems) at the shell prompt. +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. + + + + + + +I would like to click the &LMB; anywhere on the +desktop and have the K menu displayed. + + +Open the &kde; Control Center and +choose Desktop +Behavior. You +can now choose the behavior of mouse clicks on the desktop. To have +the K menu open from a single &LMB; click, change +the entry labeled Left button to say +Application Menu. + + + + + +Where do I find information regarding &kde; themes? + + +Go to http://kde.themes.org/ or http://www.kde-look.org. + + + + + +How do I change &MIME; Types? + + +If you are using &konqueror;, do this instead: first, open a +&konqueror; window and choose +SettingsConfigure +Konqueror, then File Associations. Find the type you want to change +(⪚ text/english or +image/gif), and set the application preference order +to whatever you want. + + + + + +&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. + + + + + +How do I use &TrueType; fonts in &kde;? + + + +You need to install &TrueType; font support into your &X-Window; 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. + + + + + + +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. + + + + +How do I run a program at &kde; startup? + +There are many ways to do that. If what you want to do +is to run some scripts that would set some environment variables (for +example, to start gpg-agent, ssh-agent and others), you can put +these scripts into $KDEHOME/env/ and make sure their names end in +.sh. $KDEHOME is +usually a folder named .kde +(note the period at the beginning) in your home +folder. If you want scripts to be executed for all &kde; users, you can +put them under $KDEDIR/env/, where $KDEDIR is the prefix &kde; was +installed to (you can find this out using the command +kde-config --prefix). +If you wish to start a program after &kde; has started, you may want to use the +Autostart folder. To add +entries to the Autostart folder: + +Open &konqueror;. + +Select GoAutostart + from the menubar. + +Right-click in the window view area and select Create NewFileLink to +Application + + +Click on the Application tab in +the window that appears and enter the name of the command to run in +the Command text box. + + + + + + + + + +How can I allow more than one user to be logged in a at a time? Can &kde; do fast user switching? + + + +To enable more than one user to log in at one time on the same +computer (sometimes referred to as fast user switching) you +need to tell the program that logs you in that it can use more than one +session (or, in &X-Window; terms, display) at a time. + +In &kde;, this program is called &kdm; which stands for &kde; +Display Manager. If you are not using &kdm; as your login screen +then you will need to consult the documentation for the software you are using on how to +accomplish multiple sessions. + +By default, this will be configured at installation time automatically +if &kdm; supports virtual terminals on your system (currently Linux only). +If it was not configured automatically, consult the &kdm; manual, section +Specifying permanent &X-Server;s. +After modifying kdmrc, you will have to let &kdm; know about it; just +invoke killall -HUP kdm. + + + + diff --git a/doc/faq/contrib.docbook b/doc/faq/contrib.docbook new file mode 100644 index 000000000..807050ba7 --- /dev/null +++ b/doc/faq/contrib.docbook @@ -0,0 +1,164 @@ + + + + +Contributing + + + + +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 +kde-pr@kde.org. This will get you in touch +with the &kde; public relations volunteers. +Program new &kde; applications. Please refer to 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. + + + + + +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 +HelpReport +Bug... from the menu bar of the application +with the bug. This will open a small dialog box with a link +to the bug tracking system. Please make sure to follow the +instructions of the bug reporting wizard. + + + + + +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, ⪚ 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. +Please read How to +subscribe/unsubscribe to these lists carefully. Everything +said there applies to the development list as +well. + + + + + +How do I get access to &kde; SVN? + + +The &kde; project uses SVN to develop the +core parts of the software. Usually, when you have changed one of the +parts (⪚ 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, there are instructions here on how to get write access to the SVN repository: +http://developer.kde.org/documentation/other/developer-faq.html#q1.8. But be aware that more users will slow +down SVN access for all developers, so we want to +keep the number of people with direct SVN access +reasonably small. But feel free to ask! + + + + + +Can I have read-only access to the SVN repository? + + +Yes. Instructions on how to get anonymous, read-only SVN access are here: +http://developer.kde.org/source/anonsvn.html + + + + + + +Are there any SVN mirror sites for &kde;? + + +No, there are currently no anonymous SVN mirror sites for &kde;. If you're interested in setting one up, please contact sysadmin@kde.org + + + + + + +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. + + + + + + diff --git a/doc/faq/desktop.docbook b/doc/faq/desktop.docbook new file mode 100644 index 000000000..da3de1608 --- /dev/null +++ b/doc/faq/desktop.docbook @@ -0,0 +1,97 @@ + + + +The desktop + + + + +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 &RMB; on the desktop and choose Create NewFile +Link to Application... and fill in the configuration for the application you want to link to. + + + + + + + +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 &RMB; on the desktop and then choosing Create NewLink to Device and then selecting the device of the type you wish to control from the desktop. Fill in the settings for the device in the dialog that appears and click OK. You can use the resulting desktop icon to mount/unmount the device from the desktop. + + + + + + + + +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. + + + + + +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 if your system is configured correctly. Check your &X-Server; settings support the use of a scrollwheel if it is not working. + + + + + +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 xterm. +Note that the 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 for more magic +available with &kstart; (and there is an abundance). + + + + + + +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. + + + + diff --git a/doc/faq/filemng.docbook b/doc/faq/filemng.docbook new file mode 100644 index 000000000..bfe6d1e98 --- /dev/null +++ b/doc/faq/filemng.docbook @@ -0,0 +1,207 @@ + + + +The File Manager + +&kde;'s file manager is &konqueror;. The +&konqueror; home page is located at http://www.konqueror.org where a +&konqueror; specific FAQ can be found. + + + + + + +How can I change the appearance of a folder in +&konqueror;? + + +Right-click the folder, select Properties, +click on the large icon in the dialog which appears, and choose another +icon. To change the icon displayed for entries in the +K Menu, use the Menu Editor, +located at SettingsMenu +Editor. + + + + + + +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. + + + + + + +How do I specify the startup folder for &konqueror;? + + + +Using the &RMB;, 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. + + + + + + +How do I rename files? + + +Simply right click on the file and select +Rename or press the keyboard shortcut F2 with a file selected. + + + + + +Where did the delete entry from my right-click context menu go? + + +In &kde; 3.4 the delete context menu entries that bypass the +trashcan are no longer displayed by default. To enable them, go to +SettingsConfigure +&konqueror; and select +Behaviour in the iconbar to the left. Tick the checkbox +Show 'Delete' context menu entries which bypass the +trashcan. + + + + + +How do I configure the programs that &konqueror; uses to +open different types of files? + +In order to configure file associations, you should go to the +&kcontrolcenter; and choose the item File +Associations under the category KDE +Components. + +Suppose the default PDF viewer is now &kghostview; and +you would prefer to use KPDF as a viewer. You +would simply type pdf in the search box at the top of +the dialog, choose pdf in the +application group and move +KPDF up. In the Embedding +tab you can also choose which component other applications will use to +display files (for example, when viewing files in &konqueror; or using +&ark;'s embedded viewer). + + + + + +When I try to click on a folder in &konqueror;, I get the +message: There appears to be a configuration error. You have +associated Konqueror with inode/directory, but it cannot handle this file +type. + + +You need to make sure that the embedding settings for inode/directory +are correct: + +In &konqueror;, go to +SettingsConfigure +Konqueror and then to the File +Associations page. Open +inode->directory in the tree view. Click on +the +Embedding tab. Make sure that Left Click +Action is set to Show file in embedded +viewer, and by default Icon View (konq_iconview) +is at the top +of Services Preference Order. + + + + + + What are and + 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 +. 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 . 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 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 localized, 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. + + + + + +How do I make &konqueror; start up without a menu bar? +I can't save a view profile when the menu bar is invisible! + + +The easiest way to do this is to edit &konqueror;'s +configuration file manually. Add the following lines to +~/.kde/share/config/konquerorrc: + +[KonqMainWindow] +MenuBar=Disabled + + + +On restarting &konqueror;, the menubar should be hidden. + + + + + + + + diff --git a/doc/faq/getkde.docbook b/doc/faq/getkde.docbook new file mode 100644 index 000000000..ceabb2561 --- /dev/null +++ b/doc/faq/getkde.docbook @@ -0,0 +1,79 @@ + + + +Getting &kde; + + + + +Where do I get &kde;? + + + +The easiest way to get &kde; is to install a &Linux; distribution or another UNIX-like OS that ships with &kde;. +You can find an up-to-date list of distributions that ship +with &kde; here. For alternative methods of +trying &kde; that do not require you to be running &Linux;, please see +Try &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. + + + + + +What is the current version? + + + +Currently, the latest stable version is 3.5.5 + +The &kde; 3.5.5 Info +Page contains a lot of information specific to this +release. + + + + + +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 SVN client in order to +maintain the latest snapshot at all times. Please refer to Anonymous SVN and &kde; for further +information. + + + + + + + +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 for the version +of &Qt; you need. + + + + + + diff --git a/doc/faq/index.docbook b/doc/faq/index.docbook new file mode 100644 index 000000000..f114e3993 --- /dev/null +++ b/doc/faq/index.docbook @@ -0,0 +1,136 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + +&kde; Frequently Asked Questions + + + +The &kde; Team + + + + + + +1997 +1998 +1999 +2000 +2001 +2003 +2004 +2005 +The &kde; Team + + +&FDLNotice; + +2005-01-19 +3.4 + + 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 +kde-doc-english@kde.org. 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;. + + +KDE +FAQ +question +answer + + + +&faq-about; +&faq-intro; +&faq-getkde; +&faq-install; +&faq-panel; +&faq-desktop; +&faq-winmng; +&faq-filemng; +&faq-webbrowse; +&faq-configkde; +&faq-kdeapps; +&faq-sound; +&faq-nonkdeapps; +&faq-tips; +&faq-misc; +&faq-qt; +&faq-moreinfo; +&faq-questions; +&faq-contrib; + + +Credits and License + +The current &FAQ; maintainers are: + + +J Hall +jes.hall@kdemail.net + + +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; +maintainers, Rainer Endres and Mr. Lee Wee Tiong + + + + +&underFDL; + + +&documentation.index; + + + diff --git a/doc/faq/install.docbook b/doc/faq/install.docbook new file mode 100644 index 000000000..6ab33ef78 --- /dev/null +++ b/doc/faq/install.docbook @@ -0,0 +1,726 @@ + + + +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. + + + + + + + +To the would-be converts + + + +So you have heard the rumors. 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 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 . 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! + + + + + + +What kind of hardware do I need to run &kde; ? + + +To run &kde; it is recommended that you have at least a pentium II processor, 64MB of memory and 500MB of free disk space for a basic installation. While &kde; may run on slower configurations than this, performance can be severely impaired. Generally, if your computer runs an &X-Server; already with other desktop environments or window managers it's probably fast enough to run &kde;. + + + + + +Available package formats + + + + +You can find several kinds of binary and source packages for +different distributions and operating systems on the &kde-ftp;. 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.4.1 Info +Page. + + + + + + +Prerequisites + + + + + +For &kde; 3.4.1, you need the &Qt; library version 3.3 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. + + + + + + +Description of the base packages + + +The base distribution currently consists of twenty +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 center, 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 instant messaging client &kopete;, the +download manager &kget;, and several other network-related programs. + + + +kdepim + +Optional +Personal information management tools. Contains the email client &kmail;, the newsreader &knode; and other related programs. + + + +kdeadmin + +Optional +System administration programs. + + + +kdeedu + +Optional + +Educational and entertaining applications for &kde;'s younger users. + + + + +kdeaccessibility + +Optional + +KDE accessibility programs such as a screen magnifier and speech synthesizer front end. + + + + +kdetoys + +Optional +Toys! + + + +kdevelop + +Optional +A complete Integrated Development Environment for &kde; and Qt + + + +kdewebdev + +Optional +Web development applications. Contains such applications as &quanta;, an integrated web development environment and other applications useful in web development + + + +kdesdk + +Optional +KDE Software Development Kit. Contains a collection of applications and tools used by KDE Developers. + + + + +&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. + + + + + + +Installation instructions for the different package +formats + + + +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). + +become superuser +run dpkg for +every package you want to install. + + + + +Installation of the RPM packages + + +To install binary <acronym>RPM</acronym>s +become superuser +execute 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 option of +the configure script. + +unpack the packages with tar +change folder to the package folder: cd +packagename +configure the package: ./configure +Some packages (notably kdebase) have special configuration +options that might be applicable to your installation. Type +./configure to see the +available options. +build the package: make +install the package: su (if you aren't already root). If you +already are, just type make +. + + + + + + + + + +Post-installation procedures + + +First of all, please make sure that you have added &kde;'s binary +installation folder (⪚ /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, ⪚ it is called +SHLIB_PATH on &IRIX;. Then set the environment variable +KDEDIR to the base of your &kde; tree, ⪚ /usr/local/kde. + +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. + +Some systems (notably &RedHat; &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. + + + + + + +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. + + + + + +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. + + + + + +Is it possible to install &kde; in my home directory? + + +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: +Source packages +Configure and install the package using configure +; +make; make install to install into /home/me. Replace /home/me with your home directory, generally defined in $HOME +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 /home/me + +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=/home/me +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 + + +<acronym>RPM</acronym> packages +rpm allows you to use the + option to select the folder you want to +install to. For example, executing rpm will install the package +to /home/me. + + +Although &kde; will run from a user folder, there are some +problems with programs that require suid root, ⪚ 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. + + + + + + +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 . + + + + + +&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. + + + + + +&kde; on a laptop? + + +If you can get &X-Window; 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: + + +http://www.linux-laptop.net/ + + +http://www.sanpei.org/Laptop-X/note-list.html + + + + + + + +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: + +change to superuser if you aren't already +mv /opt/kde /usr/local/kde +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. + + + + + +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. + + + + + +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. + + + + + +I upgraded &kde; and it seemed to go fine, but when I start it, +I get a blank gray 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 gray 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 (&ie; 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. + + + + + +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. + + + + + +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. + + + + + +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 +&GIF;s and have the relevant license, recompile &Qt; with &GIF; support. +./configure . + + + + diff --git a/doc/faq/intro.docbook b/doc/faq/intro.docbook new file mode 100644 index 000000000..6f9546791 --- /dev/null +++ b/doc/faq/intro.docbook @@ -0,0 +1,93 @@ + + + +Introduction + + + + +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;? + + + + + +On which platforms can I expect &kde; to work? + + +&kde; is a Desktop Environment for all flavors 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. + + + + + +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. + + + + + +Is &kde; a CDE, &Windows; 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. + + + + + +Is &kde; free software? + + +Yes, &kde; is free software according to the &GNU; General +Public License. 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. + + + + + diff --git a/doc/faq/kdeapps.docbook b/doc/faq/kdeapps.docbook new file mode 100644 index 000000000..95ff1355b --- /dev/null +++ b/doc/faq/kdeapps.docbook @@ -0,0 +1,158 @@ + + + +&kde; applications + + + + +&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 Center. + 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; dialog 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 (⪚ 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 and +(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. + + + + + + + + +&konsole; + + + + + +How do I page-up or page-down? +Use +ShiftPage Up +and ShiftPg +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 &LMB; down and +paste by clicking with the &MMB; (or both buttons if you are using a +2 button mouse with 3 button emulation). + + + + +Why can't &konsole; find the 9x15 and the 2 +console bitmap fonts installed with &kde;? + + +FontConfig must find the three fonts +installed in: $KDEDIR/share/fonts. + If +the &kde; install does not install these fonts in a directory that +already exists (⪚ /usr/share/fonts) then you must add this +directory to the configuration file /etc/fonts/local.conf. This should be +the first line after <fontconfig>. For example: + +<fontconfig> +<dir>/usr/kde3/share/fonts</dir> +</fontconfig> + +After adding the directory, run (as root): +fc-cache -v and check that +it found the directory. + + + + + + + + + +&kmail; + + +&kmail; has its own home page at http://kmail.kde.org where an +FAQ is available. + + + + + diff --git a/doc/faq/misc.docbook b/doc/faq/misc.docbook new file mode 100644 index 000000000..61d2950f3 --- /dev/null +++ b/doc/faq/misc.docbook @@ -0,0 +1,219 @@ + + + +Miscellaneous questions + + + + + + +Does &kde; support transparency and other visual effects provided by the new composite extension to X.org? + + + Yes! An exciting new feature for &kde; 3.4 is support for the new X composite extension. This allows for effects such as translucency and drop shadows for all windows, easily configurable through &kwin;'s configuration dialog. This requires you to be using X.org version 6.8.0 or newer and have: + + +Section "Extensions" +Option "Composite" "Enable" +EndSection + + +In your xorg.conf. If you have an nvidia graphics card and use the nvidia driver you can improve the performance of these effects by also adding the RenderAccel option to the Device section for your graphics card: + + +Section "Device" + Identifier "nvidia-fx5200" + Driver "nvidia" + Option "RenderAccel" "true" + +Once you have configured X.org correctly, transparency and other effects can be enabled through the DesktopWindow Behavior &kcontrolcenter; module, under the Translucency tab. + + + + + + +What about &kde; programs that do not have icons? How do I get +them into the menu? + + +Use &kmenuedit;. To access it use the &RMB; on the +K button and select Menu Editor. + + + + + +Does &kde; have a graphical &FTP; client? + + +Yes, and it is none other than your favorite file +manager, &konqueror;. You can drag and drop remote files into local +folders. + + + + + +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. +Depending on your configuration of the &X-Window;, &Ctrl;&Alt;&Backspace; +might also do the trick by killing the X server, but its use prevents +session management and cannot be recommended. + + + + + +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). + + + + + +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. + + + + + +How do I copy and paste in &kde;? + + +The simplest method is to use your mouse: + +Highlight the text you want to copy by holding down the +&LMB; and dragging across the text. This adds the selected text to the clipboard. +Go to the destination area; depending on your configuration, +you might need to click it using the &LMB; to give it +focus. +Click the &MMB; to paste. If you have a two +button mouse and are emulating a three button mouse, push both buttons +simultaneously. + + +For more information about using the clipboard in &kde; please see the &klipper; hand book, accessed by typing help:/klipper +into the &konqueror; address bar. + + + + + + +How do I convert the default &RedHat; menus into a menu in the +K menu? + + +Click on the K button and select +SystemAppfinder. + + + + + +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;. + + + + + +Does &kde; support dual screen (Xinerama)? + + +Yes, you need to have a multi-headed X server +(⪚ MetroX or XFree86 4.0 and above) and a &kde; >= 2.2.1 + + + + + + +Why does Drag and Drop not work with Xinerama? + + +You should upgrade to XFree86 4.2.0 for this to work properly. + + + + + + +How do I check which version of &kde; I am using? + + +Fire up your &kde; Control +Center. It comes up with an Info Screen including the version of &kde; +The &kde; version is also included in the application's +About dialog. + + + + + + + + +How do I go about creating themes and icons? + + +Go see http://artist.kde.org. +There is also a more informal community of &kde; related artists and +artwork at http://kde-look.org. + + + + + + + +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. + + + + + diff --git a/doc/faq/moreinfo.docbook b/doc/faq/moreinfo.docbook new file mode 100644 index 000000000..9b28db3a2 --- /dev/null +++ b/doc/faq/moreinfo.docbook @@ -0,0 +1,154 @@ + + + +Getting more information + + + + +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. + + + + + +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;. + + + + + +How do I subscribe/unsubscribe to these lists? + + +To subscribe, send an email to list-request, that is: + +kde-request@kde.org +kde-announce-request@kde.org +kde-look-request@kde.org + +The email must contain subscribe +your_email_address in the +subject. +To unsubscribe, send an email to list-request, that is: + +kde-request@kde.org +kde-announce-request@kde.org +kde-look-request@kde.org + +The email must contain unsubscribe +your_email_address in the +subject. +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. + + + + + +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 (⪚ kde +or kde-devel) 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-linux, and kde-devel folders. + + + + + + +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;. + + + + + +Are there any other &kde;-related +&FAQ;s? + + +Yes. Here is a list of them: + +&kde; &FAQ; +&konqueror; +&FAQ; +aRts +sound server documentation + + + + + + + + + + + diff --git a/doc/faq/nonkdeapps.docbook b/doc/faq/nonkdeapps.docbook new file mode 100644 index 000000000..e0e732548 --- /dev/null +++ b/doc/faq/nonkdeapps.docbook @@ -0,0 +1,106 @@ + + + +&kde; with non-&kde; applications + + + + + + + +My non-&kde; applications like &Emacs; and +kterm are running amok with strange +colors! + + +Start the &kde; Control Center and in +Appearance & Themes +Colors uncheck the Apply colors to +non-KDE applications checkbox and click +Apply. + + + + +How can I set my default web browser to be something other +than &konqueror;? + +If you are using &kde; 3.3 or later, open up the &kcontrolcenter; and +navigate to the KDE +ComponentsComponent +Chooser panel. Select Web +Browser from the list on the left, then select Open +http and https URLs in the following browser: and type in the +name of the browser (⪚ mozilla, +firefox, opera, &etc;) +in the textbox. + + + + + +How can I configure the style and fonts of GTK +applications within &kde; ? + + + + +The simplest way to achieve this is to download and compile the +gtk-qt theme engine from +http://www.freedesktop.org/Software/gtk-qt. This theme engine makes +your GTK applications look like your &kde; widget style +by calling functions from &Qt; instead of drawing the styles itself. Once +the theme engine has been installed, there will be a &kcontrolcenter; module +under Appearance & ThemesGTK +Styles and Fonts. + + + + + + +I have been hearing about this gecko kpart or &Qt; Mozilla, how do I +get these? + + + +Good luck! The &Qt; Mozilla code is in Mozilla cvs, and not very stable as +of yet. In order to use it, you'll have to check out Mozilla from cvs +according to these instructions: + +http://www.mozilla.org/cvs.html. Then, configure either the Mozilla +suite or the Firefox browser with the option +--enable-default-toolkit=qt in addition to any other +options you would like to enable. More instructions on building Mozilla can +be found here. + + + + + + + + \ No newline at end of file diff --git a/doc/faq/notrelated.docbook b/doc/faq/notrelated.docbook new file mode 100644 index 000000000..fd66e1a6c --- /dev/null +++ b/doc/faq/notrelated.docbook @@ -0,0 +1,232 @@ + + + +Not really &kde;-related, but frequently asked nevertheless. + + + + +How do I change the screen resolution? + + +Use &Ctrl;&Alt;+ and &Ctrl;&Alt;- to cycle through +the resolutions you have defined in XF86Config (maybe under +/etc/X11; poke around first). +If you prefer to get your hands dirty, you can always edit the file +directly. By placing your favorite resolution at the beginning (or +making it the only one listed), &X-Window; will always start up with that +resolution. +Always make a backup copy of your XF86Config file +before you start editing it. Errors in this file +can render &X-Window; unusable. +These instructions are only valid if you are running +version 3.3.x of the XFree86 server. If you are running XFree86 4.x, +you must consult with the XFree86(TM): +Home Page. + + + + + +How do I change the color depth? + + +There is no way you can do this on the fly. You can either +start &X-Window; using startx where +number can be 8, 16, 24 or 32, depending on +the depth you want. Alternatively, if you are using +xdm/&kdm;, you +need to edit +/etc/X11/xdm/Xservers (may vary) and enter +:0 local /usr/X11R6/bin/X -bpp 16 for 16 bit color +depth. +You can also edit the XF86Config file and add a line +like DefaultColorDepth +number to Section "Screen". +The next time you start X, it will run with the newly-configured color +depth. + + + + + +What can I do if I am using a 2-button mouse? + + +Go buy a 3-button one, or use third button emulation. The third +button is emulated by pressing both the &LMB; and the &RMB; +together. You would need to enable +in your XF86Config file. + + + + + +What is a "sticky" window? + + +In a virtual desktop environment with multiple virtual desktops, a +"sticky" window will stay put on the screen when you switch between +desktops, as if sticking to the glass of the screen. +Xclock is a typical candidate for sticking, +as you need to run only one instance of it, and it always stays with +you. + + + + + +How do I replace the "X" mouse pointer with an arrow? + + +The various types of cursor available in X are defined in +X11/cursorfont.h. You can +change it using xsetroot -cursor_name +name_of_cursor. For example, I +have the following in my .Xclients: + +xsetroot -cursor_name left_ptr + +This will create the common left-angled pointer. To see other +alternatives, type xfd -fn cursor. And of course, +do not forget that man xsetroot is your +friend. + + + + + +How do I extract/install diff files? + + +To generate a context-diff suitable for patching, use +diff -u old-file new-file > +patchfile. To apply the diff to +a file (i.e. "patch the file"), execute +patch < patchfile. + + + + + +How do I get &Linux; to mount the floppy device for use with both +DOS and ext2 formatted floppies? + + +Just specify the filesystem type as auto in +/etc/fstab. Auto detection works fine for DOS and +ext2. + + + + + +How do I start &kde; with the Num Lock on? + + +Have you tried man setleds? In addition, you +might want to edit your +$HOME/.Xmodmap and put the +following lines in: + +! redefines numeric keypad to be used without NumLock +keycode 79 = 7 +keycode 80 = 8 +keycode 81 = 9 + +keycode 83 = 4 +keycode 84 = 5 +keycode 85 = 6 + +keycode 87 = 1 +keycode 88 = 2 +keycode 89 = 3 + +keycode 90 = 0 +keycode 91 = comma +keycode 86 = plus + +! deactivates NumLock key +keycode 77 = + +Other possible alternatives: + +xkeycaps: +right clicking should allow edits. You may +have to do this as root. +man XF86Config and look under +section Keyboard. +Install NumLockX, which is +available from http://dforce.sh.cvut.cz/~seli/en/numlockx. + + + + + + +How do I take window or desktop screenshots? + + +Use &ksnapshot;. + + + + + +Is there a tool to make webpages? + + +Yes, and there are a lot of them out there, including +StarOffice, &Netscape; Composer, and +XEmacs. +There are also many &kde; applications. To find the most current +list, go to kde-apps.org: The +Latest in &kde; Applications and search for web +development. Try as many as possible and choose the one +most suitable to your needs. + + + + + +What do all those acronyms like AFAIK mean? + + + +AAMOF: as a matter of fact +AFAIK: as far as I know +AISE: as I see it +BFN: bye for now +BION: believe it or not +BRB: be right back +BTW: by the way +CMIIW: correct me if I am wrong +FUD: fear, uncertainty, and doubt +FWIW: for what it's worth +FYI: for your information +HTH: hope this helps +IIRC: if I recall correctly +IMHO: in my humble opinion +LOL: laughing out loud +MYOB: mind your own business +PITA: pain in the ass +ROTFL: rolling on the floor laughing +RTFM: read the fine manual +SOP: standard operating procedure +TIA: thanks in advance +YMMV: your mileage may vary + + + + + diff --git a/doc/faq/panel.docbook b/doc/faq/panel.docbook new file mode 100644 index 000000000..5814dc613 --- /dev/null +++ b/doc/faq/panel.docbook @@ -0,0 +1,193 @@ + + + + +The panel + + + + + +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 +MenuAdd to +PanelApplication +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. + + + + + + + +Is it possible to change the K button of +the panel to another picture? + + +The simplest way is to download a new icon theme with a &kmenu; icon +you prefer from +http://www.kde-look.org and +install it using the &kcontrolcenter;. +In order to change only the &kmenu; icon you can overwrite the +kmenu.png image for every size in an icon theme set. +So, for &kde; default icons this would be $KDEDIR/share/icons/default.kde/size/apps/kmenu.png, +where size is one of the sizes included in the +&kde; icon theme. + + + + + + + +After an upgrade my &kmenu; appears to be empty! How can I get my menu back? + + + + +In &kde; 3.2 and later local modifications to the &kmenu; are stored +in +$HOME/.config/menus/applications-kmenuedit.menu +. Try moving this file out of the way and then issuing the +command kbuildsycoca +. This should restore you to the +default system menus. + + + + + +My desktop panel has disappeared. How can I get it +back? + + + + +The panel disappearing is usually due to it crashing. This is +most often caused by loading an applet that has a fatal bug or due to +a bad installation of &kde; and/or the panel. + +The easiest way to get the panel back is to launch the +Run Command window by pressing &Alt;F2 and entering +kicker and then pressing the +OK button. + +If the panel continues to disappear, you may wish to either +remove or edit by hand your +$KDEHOME/share/config/kickerrc +file, where $KDEHOME is usually +~/.kde. If you choose to edit +it by hand, start by removing the applet entry groups. + + + + + +Where did the Icon Zooming option that used to be in &kicker; go? + + +Icon zooming was not actively maintained and had caused severe bugs and usability issues. It was replaced in &kde; 3.4 by the new mouse over effects, which combine esthetics with useful information. + + + + + +How can I start an application minimized to the system +tray? + + +Use ksystraycmd. For example, to start a &konsole; hidden +in the system tray, run ksystraycmd + konsole. For +more information about ksystraycmd, see the section +Advanced Window Management in the &kde; +User Guide. + + + + +How do I use the &Windows; key to open the &kmenu;? + + +Previous versions of &kde; provided a trick to allow you to +use the &Windows; key both as a modifier (so you could have shortcuts +like WinR +), and as a regular key (so that pressing +Win on its own could open the &kmenu;). This feature +was removed for reasons of usability and accessibility, as well as +keeping the code clean. For current versions of &kde;, you have two +options: either use a different shortcut to open the &kmenu; (the +default is &Alt;F1 +), or remap the Win key to be a regular +key, rather than a modifier. + +If you choose to do the second, here's one way: + + +Find the keycode for your Win key +using xev: Run the command +xev in a &konsole;, and +press the Win key. Look in the output of +xev for +keycode n, +where n is the keycode of the +Win key. + + +Use xmodmap to remap the +Win key. An appropriate command is xmodmap + 'keycode +n=Menu'. + + +In the &kcontrolcenter;, go to +Regional & +AccessibilityKeyboard Shortcuts + and set the shortcut for Popup Launch +Menu to the Win key. You should now be +able to popup the &kmenu; by pressing the Win key. + + +One more step is required to save the changes across +settings: Create a file ~/.kde/env/win-key.sh +(create the directory if it doesn't exist), and add the +xmodmap command you used previously to it. The +change should now be applied every time you start &kde;. + + + + + + + + + + diff --git a/doc/faq/qt.docbook b/doc/faq/qt.docbook new file mode 100644 index 000000000..446089edc --- /dev/null +++ b/doc/faq/qt.docbook @@ -0,0 +1,76 @@ + +&Qt; and Licensing questions + + + + + +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. + + + + + +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. + + + + + +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. + + + + + +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. + + + + + +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. + + + + \ No newline at end of file diff --git a/doc/faq/questions.docbook b/doc/faq/questions.docbook new file mode 100644 index 000000000..1f7db6b63 --- /dev/null +++ b/doc/faq/questions.docbook @@ -0,0 +1,160 @@ + + + +Asking Questions + +Chances are, you have been linked to this document from IRC or a +mailing list. You've asked a question, and someone has told you that you +need how to ask more effectively. In order to get an appropriate, clear +answer you need to ask an appropriate, clear question in a manner that's +going to provide an incentive for people to take their time to help you. If +you appear to be rude, lazy or use bad or unclear language then chances are +your question will be ignored + + + + +What do I do before I ask? + +Read the documentation and &FAQ; for the application. There is +a wealth of &kde; documentation availible both in the help center and +online. A lot of time and effort has gone into this documentation, and +quite often the answer to your question is here. The general &kde; userguide +can be found by typing +help:/userguide into your +&konqueror; addressbar. + +Search the web: Usually googling for a specific error message or +searching mailing list archives can come up with a solution for you. + +Try it and see! Look through all the application options, read the +What's this? and tooltips for the ones you're not sure about. If you're +really unsure about an option save your data and then try it. As long as you +use some common sense, you are very unlikely to break anything by clicking +buttons. + +Above all, don't be lazy. If you show the people who you are asking +that you are able to troubleshoot and research in a logical manner, you're +showing them you're a reasonable person who is worth their time to +help. It's your problem and not theirs so the legwork is yours to do. Save +your helpers as much time as you can, they're busy people. + + + +Where do I ask? + +Usually the best place to ask a question is on the +IRC channels and mailing lists devoted to user +questions. Don't post simple questions about using &kde; to the devel +channels and mailing lists, these are for technical discussions. Some good +places are #kde on irc.freenode.net, and the &kde; mailing +lists. + + +How do I ask? + +Try to word your questions in a manner that gives the most +information possible and is polite and courteous. Don't ask to ask, just +ask! + +Q: &kde; sucks, it's being slow + +Is not a question that is likely to get you a useful answer. It does +not give any useful information about troubleshooting the problem, and it +starts out attacking the software in a way that isn't productive. + +Q: Since upgrading &kde; on Slackware &Linux; from version 3.2.3 to +3.3.2 using sources, I have noticed it's being really slow — sometimes +applications take up to 20 seconts to launch. I am using the same user +configuration as I had with the previous version, and I have tried as a new +user. I can't find anything about this on the mailing lists or by a google +search. Could anyone point me to some information that could help? + +This question is polite, contains information to help people +troubleshoot the problem and shows your helpers what avenues you have +already tried. + +Don't assume automatically that the problem is the fault of +&kde;. Proceed as though this is your error, otherwise you will quickly +annoy people if it does indeed turn out to be your problem and not +&kde;. + +Use clear language with correct spelling. Watch out for any +ambiguities and make sure you think about what you say before you write +it. If you are asked for clarification, give it as best you can. &kde; is a +project where many of the users and developers are not native english +speakers and if you don't use correct english, misunderstandings may +ensue. Use the language appropriate to the channel or mailing list you are +in — if you don't, people who might have been able to help you may +ignore your message because it is not in a language they understand. + +Include all information that could be relevant, even if you're not +sure. Have you upgraded other software or hardware on your system, +particularly system libraries or a new kernel? These things could affect how +&kde; performs. Even if you cannot see a link, someone else might. + +Don't paraphrase error messages. Paste in the exact error, and if it's +more than a line or two don't paste them directly into an +IRC channel. Use a paste service like http://www.rafb.net/paste. If you +must type them in by hand, be sure you are 100% accurate. When you provide +faulty information, your helpers cannot help you as easily. + +Follow up on your solution! Tell us if it worked, or if you have +solved it yourself in the meantime. This helps us know for sure if our +solution worked, and helps other users who may be searching mailing list +archives for a solution to the problem themselves. + + + +What do I do when told to look elsewhere? + +When you're told google knows or google +is your friend then chances are, you have not followed the above +advice. You've not done your research, and the solution is probably one the +helper knows very well to be easy to find. When you're linked to a +FAQ or a usermanual don't ever say, No, I don't +want to have to read this I want you to just tell me. This is very +bad manners. If you cannot put in the effort to read the document, what is +the incentive for your helper to put in the time and effort to help you? If +you're told to go use google, take it graciously and do so. + + +Above all, use common courtesy. &kde; users and developers are usually +volunteering their time out of an already very busy schedule, and like to +know that you are appreciating that they are helping you for free. Be +polite, say please and thank you and try to be pleasant and +friendly. + + Does this seem like a lot of trouble to ask a question? If you want +to be able to feel that people owe you an answer or support, then you're +quite welcome to pay for commercial support from companies that support +&kde; on &UNIX; platforms. If you don't want to pay money, then pay the +people who do this for free with your politeness and appreciation :) + + +If you think the answer to your question should be included in the +&kde; &FAQ; please feel free to submit any patches or suggestions to the +&kde; &FAQ; Maintainer, at faq@kde.org + + + + + + diff --git a/doc/faq/sound.docbook b/doc/faq/sound.docbook new file mode 100644 index 000000000..d7db604bc --- /dev/null +++ b/doc/faq/sound.docbook @@ -0,0 +1,55 @@ + +Troubleshooting sound problems + +&kde; uses the &arts; sound system which is complex and powerful, +making it difficult for some users to troubleshoot when things go +wrong. Here are some tips to help you diagnose what it's doing when your +sound misbehaves : + + + + +How can I troubleshoot sound related problems in &kde;? + + + To check that sound is working independently of &arts;, make +sure that artsd isn't running and then try playing sound +through XMMS or another multimedia application +that isn't a part of &kde;. If that application doesn't play sound, then +your general sound setup is probably broken and it's not a &kde; +problem. + +Try playing sound with +artsplay. Try various +formats, ogg, mp3 and wav. Any error messages there might be useful in +pointing you in the right direction. + +Try setting the &arts; output method to OSS. In the +&kcontrolcenter; go to Sound & Multimedia +Sound System. On the +Hardware tab, under Select the audio +device choose Open Sound System. If you are +running alsa this will use the OSS +emulation, which may give better or worse results. + +Running artsd from a terminal will give you a lot of debug output, +some of which might help you to diagnose the problem. Trying this in +conjunction with using artsplay in a second terminal can give a wealth of information. If an artsd instance is already running, exit it with artsshell +terminate + + + + +I've upgraded to the latest version of &kde; keeping my old configuration, and my system sounds don't work anymore! + +Assuming you've installed &arts; correctly and you still have the codecs installed your previous &kde; installation needed, chances are this is a small problem with your knotifyrc. To confirm this, try creating an entirely new user and seeing if system notifications work under the new account. If they do, try moving your $KDEHOME/share/config/knotifyrc out of the way for your original user to see if this solves the problem. + + + + + + + + diff --git a/doc/faq/tips.docbook b/doc/faq/tips.docbook new file mode 100644 index 000000000..d47709095 --- /dev/null +++ b/doc/faq/tips.docbook @@ -0,0 +1,137 @@ + + + +Useful tips + + + + +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 Center if you are using &kde; +2. Simply start the &kde; Help Center by clicking on the icon (the blue +book with the yellow key) on the toolbar. Once the &kde; Help Center 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. + + + + + +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 Center +allows you to change these mouse bindings. + + + + + +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 Center. + +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. + + + + + + +What if something is so wrong that I can't 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 | more + +By killing the process that has the mousegrab, your desktop will +come to life again. Unfortunately you can't see which process that is, +so you will have to find out through trial and error. To kill a process +use: + + kill pid + +Here pid is the process id of the +process, which is the first number on each line reported by +ps . + +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;. + + + + + + + diff --git a/doc/faq/webbrowse.docbook b/doc/faq/webbrowse.docbook new file mode 100644 index 000000000..b80c7ae1a --- /dev/null +++ b/doc/faq/webbrowse.docbook @@ -0,0 +1,222 @@ + + + +Webbrowsing with &konqueror; +&konqueror; is &kde;'s open source, standards compliant webbrowser. +It's home page is +http://www.konqueror.org where a +&konqueror; specific FAQ can be found. + + + + +Where does the name &konqueror; come from? +It's a word play on the other browsers' names. After the Navigator and the Explorer comes the Conqueror; it's spelled with a K to show that it's part of &kde;. The name change also moves away from kfm (the &kde; file manager, &konqueror;'s predecessor) which represented only file management. + + + +Can I run &konqueror; without running &kde;? +Yes. Just install &Qt;, kdelibs and kdebase, and from your favorite window manager just launch &konqueror;. It should work just fine, but if it doesn't (&kde; developers don't test that case often), report it to http://bugs.kde.org and try running "kdeinit" before running &konqueror;, it usually helps. +This is of course the same for any other &kde; application. + + + + +Why doesn't &konqueror; show the contents of an image's ALT attribute in a tooltip? + +There is no standard that states the ALT attribute should appear as a tooltip. The specification calls for ALT to be displayed in place of the image, as in text-mode only browsers such at lynx or w3m. Abusing the ALT attribute is bad for accessibility. Tooltips are supposed to come from the TITLE attribute and this is implemented in &konqueror; + + + + + +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 +SettingsConfigure +&konqueror;... from the &konqueror; menu and +go to the Proxy tab. + + + + + +How do I import bookmarks from another browser into &konqueror; ? + + +To import bookmarks from another browser into &konqueror; select +BookmarksEdit Bookmarks +and then in the Bookmark Editor select +FileImport. Then select +the browser you would like to import bookmarks from. In the Open dialog, +navigate to the location of the folder or file your bookmarks are +contained in and click Open + + + + + +How can I make &konqueror; only show certain bookmarks in the bookmarks toolbar? +In &konqueror; go to SettingsConfigure &konqueror;.... Then select Web Behaviour from the icon list. Under the Bookmarks heading, place a check in the box next to Show only marked bookmarks in bookmark toolbar. Now in the Bookmark Editor an option to Show in Toolbar appears on clicking with the &RMB; on any bookmark entry or in the Edit menu when the entry is highlighted. Folders can also be shown in the bookmarks toolbar in much the same way. + + + + +How do I fool a site into believing &konqueror; is &Netscape; or +some other browser? + + +In &konqueror;, select +SettingsConfigure +Konqueror... and in the configuration +dialog, select Browser Identification. Default +and site-specific browser identifications can be set from here. + + + + +&konqueror; is taking a really long time to load webpages, what +could cause this? + +Quite often &konqueror; loading webpages slowly is caused by +DNS servers with broken IPV6 +support. Adding the following to /etc/profile or any +other script that is sourced on login should solve this problem: + +export KDE_NO_IPV6=true + +for bourne compatible shells, and for C-style shells: + +setenv KDE_NO_IPV6 true + + + + + + + +How do I configure &konqueror; to run &Java; applets? + + +Choose +SettingsConfigure +&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. + + + + + + +How do I block unrequested popup windows in &konqueror;? + + +&konqueror; has a new 'smart' policy for JavaScript popups. From the +&konqueror; main window, select Settings +Configure &konqueror;... and then +Java & JavaScript. On the +JavaScript tab, under Global JavaScript +Policies set the radio button beside Open new +windows: to Smart. + + + + + + +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/. + + + + + + +Can &konqueror; use user-specified stylesheets, like those in the +Firefox adblock extention? + + +Yes, you can set &konqueror; to use any kind of valid +css stylesheet to filter webcontent or improve accessibility. +From the &konqueror; main window simply click +Settings +Configure &konqueror;... and select +Stylesheets. Set the radio button to +Use user-defined stylesheet and browse to where the +stylesheet you want to use is located. Alternatively, you can select +Use accessibility stylesheet defined in "Customize" +tab and then set your own options. + +An example of css rules that implement ad blocking can be +found at: + +http://www.mozilla.org/support/firefox/adblock. + + + + + +Why does &konqueror; display a plain grey square when I try to view flash animations, even though the flash plugin is installed? + + +Under the latest versions of X.org, having the composite extension loaded can cause problems with the flash plugin. Try disabling the composite extension and see if normal flash operation is restored. + + + + + +Why can't &konqueror; render &GIF; images? + + +It is because you did not enable &GIF; support in &Qt;. Please see + for more details. + + + + +When I try to open a web page with &konqueror;, I get the +message: There appears to be a configuration error. You have +associated Konqueror with text/html, but it cannot handle this file +type. + + +You need to make sure that the embedding settings for the text/html +MIME type are correct: + +In &konqueror;, go to +SettingsConfigure +&konqueror;... and then to the File +Associations page. Open +text->html in the tree view. Click on the +Embedding tab. Make sure that Left Click +Action is set to Show file in embedded +viewer, and that KHTML (khtml) is at the top +of Services Preference Order. + + + + + + + + + diff --git a/doc/faq/winmng.docbook b/doc/faq/winmng.docbook new file mode 100644 index 000000000..f32384754 --- /dev/null +++ b/doc/faq/winmng.docbook @@ -0,0 +1,134 @@ + + + + + +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 Center) for usage information. + + + + +Are there keyboard shortcuts for &kwin; operations? + + +Yes. Please refer to "The K Window Manager Handbook" for the +list of shortcuts available. + + + + + +Can I define my own set of keyboard shortcuts? + + +Yes. Launch the +&kde; Control Center and select +Regional & AccessibilityKeyboard Shortcuts to +configure window manager bindings like maximizing windows, &etc;. + + + + + + +When I "iconify" a window, it disappears. Where does it +go? + + +With many &X-Window; &GUI;s, the minimize 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 gray. + + +If you click the &MMB; on the root window (&ie;, +the background of the desktop), &kwin; will give you a list +of all available tasks. + + + + + + + +How do I maximize windows only vertically or horizontally? + + +Provided your window is not already maximized, clicking on the +maximize button with the &LMB;/&MMB;/&RMB; will +maximize fully/vertically/horizontally respectively. + + + + + +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. + + + + + + + +How can I start an application with special window options, like +maximized/minimized/to stay on top? + + +Use the kstart command. As an example, to +open &kcalc; with the Stay on Top option, use: +% kstart + +For maximized windows, use the +option, for minimized windows, use . You can +see a full list of kstart options with +kstart +. + +If you're using kstart to start +applications at &kde; startup, you should use the + option. See the &kde; User Guide, section +Advanced Window Management for more information about +this feature. + + + + + + + + + -- cgit v1.2.3