diff options
author | Slávek Banko <slavek.banko@axis.cz> | 2020-11-17 19:52:37 +0100 |
---|---|---|
committer | Slávek Banko <slavek.banko@axis.cz> | 2020-11-17 19:52:37 +0100 |
commit | 1b6c123de102f0152d296fba8771d348329ba95c (patch) | |
tree | 0f2bb5c5e91f1a6abdd0e585c36c8307b930fc71 /doc/khelpcenter/faq | |
parent | 9b5b19a9b4baaba6199b9d3797df6b8fc8f76606 (diff) | |
download | tdebase-1b6c123de102f0152d296fba8771d348329ba95c.tar.gz tdebase-1b6c123de102f0152d296fba8771d348329ba95c.zip |
Move the khelpcenter guides to the directory level in which they are installed.
Signed-off-by: Slávek Banko <slavek.banko@axis.cz>
Diffstat (limited to 'doc/khelpcenter/faq')
24 files changed, 3638 insertions, 0 deletions
diff --git a/doc/khelpcenter/faq/CMakeLists.txt b/doc/khelpcenter/faq/CMakeLists.txt new file mode 100644 index 000000000..606220074 --- /dev/null +++ b/doc/khelpcenter/faq/CMakeLists.txt @@ -0,0 +1,12 @@ +################################################# +# +# (C) 2010-2011 Serghei Amelian +# serghei (DOT) amelian (AT) gmail.com +# +# Improvements and feedback are welcome +# +# This file is released under GPL >= 2 +# +################################################# + +tde_create_handbook( DESTINATION khelpcenter/faq ) diff --git a/doc/khelpcenter/faq/Makefile.am b/doc/khelpcenter/faq/Makefile.am new file mode 100644 index 000000000..9c7a6607a --- /dev/null +++ b/doc/khelpcenter/faq/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = khelpcenter/faq + diff --git a/doc/khelpcenter/faq/TODO b/doc/khelpcenter/faq/TODO new file mode 100644 index 000000000..a91707552 --- /dev/null +++ b/doc/khelpcenter/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] <lauri> 1: move the faq (and other tdebase docs) up to tdebase/doc/<subdir> +so that docs.kde.org will pick them up and generate them +[22:16:05] <lauri> 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] <physos> sounds nice +[22:16:24] <physos> will look into it + + diff --git a/doc/khelpcenter/faq/about.docbook b/doc/khelpcenter/faq/about.docbook new file mode 100644 index 000000000..76967f78a --- /dev/null +++ b/doc/khelpcenter/faq/about.docbook @@ -0,0 +1,47 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="about"> +<title>About this <acronym>FAQ</acronym></title> + +<qandaset> +<qandaentry> +<question> +<para>What can I do to help with this <acronym>FAQ</acronym>?</para> +</question> + +<answer> + +<para>Notify us about any errors you find. Suggestions you have are +appreciated. Send us everything that you think is unclear. When possible send us what +you think would be a clearer solution.</para> + +<para>Send us your solutions of those frequently-asked +questions which are still not in this <acronym>FAQ</acronym>. We will +add them as soon as practical.</para> + +<para>Please make full use of this <acronym>FAQ</acronym>. +Read this <acronym>FAQ</acronym> (and other +relevant documentation) well before asking questions on the various +&tde; mailing lists or newsgroups.</para> + +</answer> +</qandaentry> + +<qandaentry> +<question id="FAQ-maintainer-HOWTO"> +<para>How do I become an <acronym>FAQ</acronym> maintainer?</para> +</question> + +<answer> +<para>Becoming an <acronym>FAQ</acronym> maintainer is easy +and we are always grateful for help. :-) Send +us an email at <email>trinity-devel@lists.pearsoncomputing.net</email>. +</para> +</answer> +</qandaentry> +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/configtde.docbook b/doc/khelpcenter/faq/configtde.docbook new file mode 100644 index 000000000..dd5c45686 --- /dev/null +++ b/doc/khelpcenter/faq/configtde.docbook @@ -0,0 +1,243 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd"> +--> +<chapter id="configure"> +<title>Configuring &tde;</title> + +<qandaset> +<qandaentry> +<question> +<para>How do I set the language used by &tde;?</para> +</question> +<answer> +<para>First ensure the appropriate tde-i18n language package is installed.</para> +<para>Thereafter there are two ways to set the language &tde; uses in the +messages it will display:</para> +<variablelist> +<varlistentry><term>Using the <application>&tde; Control Center</application></term> +<listitem><para>Open the <application>&tde; Control Center</application> and select +<guimenu>Regional & Accessibility</guimenu> then +<guimenuitem>Country/Region & Language</guimenuitem>. You can select your language and location +here. If &tde; cannot find a translation in the first language +chosen, it will fall back on the default language. This is usually +(American) English by default.</para> +<note><para>Using the <application>&tde; Control Center</application> is the preferred way of choosing +languages in &tde;.</para></note></listitem> +</varlistentry> +<varlistentry><term>Using the <envar>LANG</envar> environment variable</term> +<listitem><para>The second method uses the standard locale setting on +your system. To change the language, simply set the environment +variable <envar>LANG</envar> accordingly. For example, if your shell +is <application>bash</application>, execute +<userinput><command>export</command> <envar>LANG</envar>=de</userinput> +to set German as the language used.</para></listitem> +</varlistentry> +</variablelist> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is there any keyboard switcher for international keyboards for +&tde;?</para> +</question> +<answer> +<para> +Yes, configure the switcher using the <application>&tde; Control Center</application> +<menuchoice><guimenu>Regional & Accessibility</guimenu><guimenuitem> +Keyboard Layout</guimenuitem></menuchoice> configuration page. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I replace the standard text login screen with the +&tde; login screen?</para> +</question> +<answer> +<note><para>Your &UNIX; distribution might have its own setup tools to +change this (⪚ <application>YaST</application> on &SuSE; &Linux;). This will +be the safest way to enable the &tde; login screen. However, if for some reason +you do not wish to use these tools, the following instructions might be useful.</para></note> +<para>First, ychange to the <quote>xdm runlevel</quote> (runlevel 5 on +&RedHat; and &SuSE; systems) by editing your +<filename>/etc/inittab</filename> file. In the file, there should be +a line saying <userinput>id:3:initdefault:</userinput>. Change it to +<userinput>id:5:initdefault:</userinput>. At the end of the file, +comment out the following line: +<literal>x:5:respawn:/usr/bin/X11/xdm -nodaemon</literal> and +replace it with +<userinput>x:5:respawn:<replaceable>/opt/trinity/</replaceable>bin/tdm +-nodaemon</userinput>. +<note><para>The location of &tdm; might differ on your +system.</para></note></para> +<para>For changes to take effect immediately, type <command>init +5</command> (for &RedHat; systems) at the shell prompt. +<caution><para>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.</para></caution></para> +</answer> +<answer> +<para> +For FreeBSD, you should edit the file <filename>/etc/ttys</filename> +and change one of the lines that look like +<programlisting>ttyv8 "/usr/X11R6/bin/xdm -nodaemon" xterm off secure</programlisting> +to instead say <userinput>ttyv8 "/usr/local/bin/tdm -nodaemon" xterm +off secure</userinput>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>I would like to click the &LMB; anywhere on the +desktop and have the <guimenu>TDE</guimenu> menu displayed.</para> +</question> +<answer> +<para>Use the &RMB; to select the desktop. From the popup menu, select +<guisubmenu>Configure Desktop</guisubmenu>. From the icon list +select the Behavior icon. Choose the behavior of mouse clicks on the desktop. To have +the <guimenu>TDE</guimenu> menu open from a single &LMB; click, change +the entry labeled <guilabel>Left button</guilabel> to say +<guilabel>Application Menu</guilabel>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Where do I find additional &tde; themes?</para> +</question> +<answer> +<para>Go to <ulink url="http://www.kde-look.org">http://www.kde-look.org</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I change &MIME; Types?</para> +</question> +<answer> +<para>When using &konqueror;, open a &konqueror; window and choose +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +Konqueror</guimenuitem></menuchoice>. From the icon list select +<guilabel>File Associations</guilabel>. Find the mime type you want to change +(⪚ <literal>text/english</literal> or +<literal>image/gif</literal>), and set the application preference order +to whatever you want.</para> +<para>The same thing can be accomplished by using the <application>&tde; Control Center +</application>. Select <menuchoice><guimenu>TDE Components</guimenu><guimenuitem>File Associations</guimenuitem></menuchoice>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>&tde; (&tdm;) does not read my <filename>.bash_profile</filename>.</para> +</question> +<answer> +<para>The login managers<application>xdm</application> and &tdm; do +not run a login shell, so <filename>.profile</filename>, +<filename>.bash_profile</filename>, &etc; are not +sourced. When the user logs in, <application>xdm</application> runs +<command>Xstartup</command> as root and then +<command>Xsession</command> as user. The normal practice is to add +statements in <filename>Xsession</filename> to source the user +profile. Please edit your <filename>Xsession</filename> and +<filename>.xsession</filename> files.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I use &TrueType; fonts in &tde;?</para> +</question> +<answer> +<para>Install &TrueType; font support into your &X-Window; configuration. +<!--Please take a look at <ulink +url="http://x.themes.org/">x.themes.org</ulink> for the fonts, and +<ulink url="http://www.dcs.ed.ac.uk/home/jec/programs/xfsft/">xfsft: +&TrueType; Font Support For X11</ulink> or <ulink +url="http://X-TT.dsl.gr.jp/">X-&TrueType; Server Project Home +Page</ulink> for the font servers.--> +</para> +<para>If you have a bunch of &TrueType; fonts from &Microsoft; +&Windows;, edit the <filename>xorg.conf</filename> file to get the +fonts from the font folder. Then configure &tde; to use these new +fonts with the <filename>Font Administrator</filename> utility.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is it possible to enter, show, and work with the Euro Symbol in +&tde;?</para> +</question> +<answer> +<para>Yes. Open the <application>&tde; Control Center</application> and select +<guimenu>Regional & Accessibility</guimenu>, then +<guimenuitem>Keyboard Layout</guimenuitem>. Select the <guimenuitem>Xkb Options</guimenuitem> +tab and enable the <guilabel>Enable xkb options</guilabel> check box. Choose a compose key. +Enable <guilabel>Adding Eurosign to certain keys</guilabel> and select the desired key.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I run a program at &tde; startup?</para></question> +<answer><para>There are several ways to do that. If you want to +run some scripts that set environment variables (for +example, to start <command>gpg-agent</command>, <command>ssh-agent</command> and others), place the +scripts into <filename class="directory">$<envar>TDEHOME</envar>/env/</filename>. Make sure their names end in +<literal role="extension">.sh</literal>. $<envar>TDEHOME</envar> is +usually a folder named <filename class="directory">.trinity</filename> +(notice the period at the beginning) in your home +folder. If you want scripts to be executed for all &tde; users, you can +put them under <filename class="directory">$<envar>TDEDIR</envar>/env/</filename>, where $<envar>TDEDIR</envar> is the prefix &tde; is installed (you can find this out using the command +<userinput><command>tde-config --prefix</command></userinput>).</para> +<para>If you wish to start a program after &tde; has started, you may want to use the +<filename class="directory">Autostart</filename> folder. To add +entries to the <filename class="directory">Autostart</filename> folder: +<orderedlist> +<listitem><para>Open &konqueror;.</para> +</listitem> +<listitem><para>Select <menuchoice><guimenu>Go</guimenu><guimenuitem>Autostart</guimenuitem> +</menuchoice> from the menubar.</para> +</listitem> +<listitem><para>Right-click in the window view area and select <menuchoice><guisubmenu>Create New</guisubmenu><guisubmenu>File</guisubmenu><guimenuitem>Link to +Application</guimenuitem> +</menuchoice></para> +</listitem> +<listitem><para>Click on the <guilabel>Application</guilabel> tab in +the window that appears and enter the name of the command to run in +the <guilabel>Command</guilabel> text box.</para> +</listitem> +</orderedlist> +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How can I allow more than one user to be logged in a at a time? Can &tde; do <quote>fast user switching</quote>?</para> +</question> +<answer> +<para>Yes, when starting &tde; through the graphical login mode. When starting &tde; +from the command line using <filename>startx</filename>, then toggle to a different console +to login in.</para> +<para>To enable more than one user to log in at one time on the same +computer (sometimes referred to as <quote>fast user switching</quote>) +configure the program that logs you in to allow more than one +session (or, in &X-Window; terms, <quote>display</quote>) at a time.</para> +<para>In &tde;, this program is called &tdm; which stands for <quote>&tde; +Display Manager</quote>. If you are not using &tdm; as your login screen +then you will need to consult the documentation for the software you are using on how to +accomplish multiple sessions.</para> +<para>By default, this will be configured at installation time automatically +if &tdm; supports virtual terminals on your system (currently Linux only). +If it was not configured automatically, consult the &tdm; manual, section +<ulink url="help:/tdm/tdmrc-xservers.html">Specifying permanent &X-Server;s</ulink>. +After modifying tdmrc, you will have to restart &tdm;; just +invoke <command>killall -HUP tdm</command>.</para> +</answer> +</qandaentry> +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/contrib.docbook b/doc/khelpcenter/faq/contrib.docbook new file mode 100644 index 000000000..6bb716f62 --- /dev/null +++ b/doc/khelpcenter/faq/contrib.docbook @@ -0,0 +1,163 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + + +<chapter id="contribute"> +<title>Contributing</title> + +<qandaset> +<qandaentry> +<question> +<para>How can I contribute to &tde;?</para> +</question> +<answer> +<para>&tde; is a free/libre software project that lives from voluntary +contributions. Everybody is encouraged to contribute to &tde;. Not +only programmers are welcome. There are many ways in which you can +help to improve &tde;:</para> +<itemizedlist> +<listitem><para>Test the software.</para></listitem> +<listitem><para>Send in bug reports. For more information, +refer to <link linkend="bug-report">How do I submit a bug +report?</link>.</para></listitem> +<listitem><para>Write or edit documentation and help files.</para></listitem> +<listitem><para>Translate programs, documentation, and help files. +</para></listitem> +<listitem><para>Draw icons, wallpaper, or compose sound effects.</para></listitem> +<listitem><para>Write articles and books about &tde;. If you want to +help spread the word about &tde;, send an email to +<email>trinity-devel@lists.pearsoncomputing.net</email>. This will get you in touch +with the &tde; developers and packagers.</para></listitem> +<listitem><para>Program new &tde; applications. Please refer to <xref +linkend="programming"/> for more information.</para></listitem> +<listitem><para> Of course, sponsors are also +welcome. :-)</para></listitem> +</itemizedlist> +<para>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 <ulink url="http://www.trinitydesktop.org/mailinglist.php">mailing +lists</ulink>. You will soon see something +that can be improved or added.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="bug-report"> +<para>How do I submit a bug report?</para> +</question> +<answer> +<para>There is a bug tracking system available at <ulink +url="http://bugs.trinitydesktop.org/">http://bugs.trinitydesktop.org/</ulink> +and thanks for helping! The system features several query types and a +list of all known bugs.</para> +<para>The easiest way to submit a bug is to select +<menuchoice><guimenu>Help</guimenu><guimenuitem>Report +Bug/Request Enhancement...</guimenuitem></menuchoice> from the menu bar of the application +with the bug. This will open a dialog box with a link +to the bug tracking system. Please follow the +instructions of the bug reporting wizard.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>May I join the development team?</para> +</question> +<answer> +<para>Please! Join our discussion list at +<ulink url="http://www.trinitydesktop.org/mailinglist.php"> +http://www.trinitydesktop.org/mailinglist.php</ulink>. Join +Internet Relay Chat (IRC) sessions at chat.freenode.net, channel: #trinity-desktop</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="programming"> +<para>I want to program for &tde;. What should I do first?</para> +</question> +<answer> +<para>Everybody is encouraged to develop software for &tde;. 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.</para> +<para>To get into &tde; programming, you will need some basic tools: +<application>automake</application>, +<application>autoconf</application>, and +<application>cmake</application>.</para> +<para>An excellent resource for learning &tde; +programming is the &Qt; tutorials. These are installed along with &Qt;. To view them, +open <filename>$<envar>TQTDIR</envar>/doc/html/index.html</filename> in +&konqueror; and bookmark the locatio. The tutorials +can be found under "Using Qt". The source code for each lesson can be found in the <filename +class="directory">$<envar>TQTDIR</envar>/tutorial</filename> +directory.</para> +<para>There is one thing everybody interested in +programming for &tde; should do: please <emphasis>subscribe to the developers +mailing list</emphasis>. To subscribe, you have to send an email to +<ulink +url="mailto:trinity-devel-subscribe@lists.pearsoncomputing.net">trinity-devel-subscribe@lists.pearsoncomputing.net</ulink> +with an empty email. +<important><para>Please read<ulink url="http://www.trinitydesktop.org/mailinglist.php"> +http://www.trinitydesktop.org/mailinglist.php</ulink>. Everything +written there applies to the development list as well.</para></important></para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I get access to &tde; <acronym>GIT</acronym>?</para> +</question> +<answer> +<para>The &tde; project uses <acronym>GIT</acronym> 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.</para> +<para>If you are doing this more or less regularly, then contact the developers +to obtain write access to the <acronym>GIT</acronym> repository: +<ulink url="trinity-devel@lists.pearsoncomputing.net"> +trinity-devel@lists.pearsoncomputing.net</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Can I have read-only access to the <acronym>GIT</acronym> repository?</para> +</question> +<answer> +<para>Yes. Instructions on how to get anonymous, read-only <acronym>GIT</acronym> +access are here: <ulink url="http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT"> +http://www.trinitydesktop.org/wiki/bin/view/Developers/GIT</ulink> +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Are there any <acronym>GIT</acronym> mirror sites for &tde;?</para> +</question> +<answer> +<para>No, currently there are no anonymous <acronym>GIT</acronym> mirror sites for &tde;. +</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>How do I go about translating &tde; programs into my native +language?</para> +</question> +<answer> +<para>Look at the <ulink url="http://i18n.kde.org">The &tde; +Translators' and Documenters' Web Site</ulink> to see whether your +program is already translated (most are). Otherwise you will find +information there on how to do it yourself.</para> +</answer> +</qandaentry>--> +</qandaset> +</chapter> + + diff --git a/doc/khelpcenter/faq/desktop.docbook b/doc/khelpcenter/faq/desktop.docbook new file mode 100644 index 000000000..cd5e8c1c5 --- /dev/null +++ b/doc/khelpcenter/faq/desktop.docbook @@ -0,0 +1,96 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="desktop"> +<title>The desktop</title> + +<qandaset> +<qandaentry> +<question> +<para>How do I add an application to the desktop?</para> +</question> +<answer> + +<para>Just choose the desired application from the <guimenu>TDE</guimenu> menu and drag and drop it to the Desktop. +</para> +<para>For applications not listed in the <guimenu>TDE</guimenu> menu, +use the &RMB; on the desktop and choose <menuchoice><guimenuitem>Create New</guimenuitem><guisubmenu>File</guisubmenu> +<guimenuitem>Link to Application...</guimenuitem></menuchoice> and fill in the configuration for the application you want to link to. +</para> + +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I mount/unmount a device from the desktop?</para> +</question> +<answer> + +<para>First, make sure you are allowed to <command>mount</command>/<command>umount</command> the relevant device as a user. +</para> +<para>Then you can add any device via &RMB; on the desktop and then choosing <menuchoice><guimenu>Create New</guimenu><guimenuitem>Link to Device</guimenuitem></menuchoice> 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 <guilabel>OK</guilabel>. You can use the resulting desktop icon to mount/unmount the device from the desktop. +</para> + +</answer> +</qandaentry> + + +<qandaentry> +<question> +<para>Where are the icons kept?</para> +</question> +<answer> +<para>The icons can be found only in <filename +class="directory">$<envar>TDEDIRS</envar>/share/icons</filename> or <filename +class="directory">$<envar>HOME</envar>/.trinity/share/icons</filename>. To use icons +stored in other locations, you must either copy them into one of the +above-mentioned fixed &tde; locations or make symlinks.</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>How do I use the mouse scroll wheel in &tde;?</para> +</question> +<answer> +<para>Mouse wheel support comes with &Qt; 2.0 and above, so &tde; 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.</para> +</answer> +</qandaentry>--> + +<qandaentry> +<question> +<para>How do I launch applications in a particular desktop?</para> +</question> +<answer> +<para>&tde; comes with a program called &kstart;. +To start an <application>xterm</application> on the second desktop and then activate it use: + +<userinput><command>kstart</command> <option>--desktop +2 --activate --window "xterm" </option>xterm</userinput>.</para> +<para>Note that the <option>--window</option> option is important. It takes an +argument which is a regular expression matching the title of the window to +apply the settings to.</para> +<para>Please read <command>kstart</command> <option>--help-all</option> for more magic +available with &kstart; (and there is an abundance). +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Where do I save my files if I want them to appear directly on +the desktop?</para> +</question> +<answer> +<para><filename +class="directory">$<envar>HOME</envar>/Desktop</filename>. You might +need to refresh your desktop after you have saved your files.</para> +</answer> +</qandaentry> +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/filemng.docbook b/doc/khelpcenter/faq/filemng.docbook new file mode 100644 index 000000000..7620b0f00 --- /dev/null +++ b/doc/khelpcenter/faq/filemng.docbook @@ -0,0 +1,186 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> --> + +<chapter id="filemanager"> +<title>The File Manager</title> + +<para>The default file manager in &tde; is &konqueror;. Please refer to +the <ulink url="help:/konqueror/index.html"> +Konqueror Handbook</ulink> for detailed information.</para> + +<qandaset> + + +<qandaentry> +<question> +<para>How can I change the appearance of a folder in +&konqueror;?</para> +</question> +<answer> +<para>Right-click the folder, select <guimenuitem>Properties</guimenuitem>, +click on the large icon in the dialog which appears, and choose another +icon.</para> <para>To change the icon displayed for entries in the +<guimenu>TDE Menu</guimenu>, use the <application>Menu Editor</application>, +located at <menuchoice><guisubmenu>Settings</guisubmenu><guimenuitem>Menu +Editor</guimenuitem></menuchoice>. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How can I do non-anonymous &FTP; transfers with &konqueror;?</para> +</question> +<answer> +<para>Normally, if you enter a &URL; like +<userinput>ftp://<replaceable>ftp.somehost.com</replaceable></userinput>, +&konqueror; will attempt an anonymous login to the &FTP; server. If you +want to login as a particular user, enter a &URL; like +<userinput>ftp://<replaceable>username@ftp.somehost.com</replaceable></userinput> +instead. &konqueror; will ask for your password and connect to the +server.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I specify the startup folder for &konqueror;?</para> +</question> +<answer> +<para>With the desktop Home icon, using the &RMB;, select the icon and choose +<guimenuitem>Properties</guimenuitem>. Select the +<guilabel>URL</guilabel> tab. Type <filename class="directory">/whereever/you/want</filename> +with the folder you would like &konqueror; to start in.</para> +<para>From within &konqueror; the process is similar. Ensure the Navigation Panel is active +(press <keycap>F9</keycap>). From the Navigation Panel tabs, select the Home icon. +In the Navigation Panel directory, use the &RMB; to select the top level <filename class="directory">Home Folder</filename> and select <guimenuitem>Properties</guimenuitem>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I rename files?</para> +</question> +<answer> +<para>Simply <mousebutton>right</mousebutton> click on the file and select +<guimenuitem>Rename</guimenuitem> or press the keyboard shortcut <keycap>F2</keycap> with a file selected.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Where did the delete entry from my right-click context menu go?</para> +</question> +<answer> +<para>The Delete context menu entry that bypasses the +Trash can is not displayed by default. To enable that menu option, go to +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +&konqueror;</guimenuitem></menuchoice > and select +<guilabel>Behaviour</guilabel> in the iconbar to the left. Enable the checkbox +<guilabel>Show 'Delete' context menu entries which bypass the +trashcan</guilabel>. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I configure the programs that &konqueror; uses to +open different types of files?</para></question> +<answer> +<para>In order to configure file associations, you should go to the +&kcontrolcenter; and choose the item <guimenuitem>File +Associations</guimenuitem> under the category <guimenu>TDE +Components</guimenu>.</para> +<para> +Suppose the default <acronym>PDF</acronym> viewer is now &kghostview; and +you would prefer to use <application>KPDF</application> as a viewer. You +would simply type <userinput>pdf</userinput> in the search box at the top of +the dialog, choose <guimenuitem>pdf</guimenuitem> in the +<guimenu>application</guimenu> group and move +<application>KPDF</application> up. In the <guilabel>Embedding</guilabel> +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). +</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>When I try to click on a folder in &konqueror;, I get the +message: <quote>There appears to be a configuration error. You have +associated Konqueror with inode/directory, but it cannot handle this file +type.</quote></para> +</question> +<answer> +<para>Make sure the embedding settings for inode/directory +are correct: +<orderedlist> +<listitem><para>In &konqueror;, go to +<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure +Konqueror</guimenuitem></menuchoice> and then to the <guilabel>File +Associations</guilabel> page.</para></listitem> <listitem><para>Open +inode->directory in the tree view.</para></listitem> <listitem><para>Click on +the +<guilabel>Embedding</guilabel> tab. Make sure that <guilabel>Left Click +Action</guilabel> is set to <guilabel>Show file in embedded +viewer</guilabel>, and by default <guilabel>Icon View (konq_iconview)</guilabel> +is at the top +of <guilabel>Services Preference Order.</guilabel></para></listitem> +</orderedlist> +</para> +</answer> +</qandaentry> + +<qandaentry> <question> <para>What are <option>%i</option> and +<option>%m</option> parameters in a file's Properties Command line?</para> +</question> +<answer> +<para>They are used by all &tde; applications (since they are implemented in +<classname>TDEApplication</classname> and all good &tde; programs create a +<classname>TDEApplication</classname> object before they even look at the +command line arguments).</para> <para>A standard line for a &tde; +application looks like this: <userinput><command>foo</command> +<option>... %i %m -caption \"%c\"</option></userinput>. Pretty confusing, +-but it has been designed in that way so that it can integrate legacy, +non-&tde; applications as smoothly as possible. &konqueror;, when executing +the line above, will extend the command to +<userinput><command><replaceable>foo</replaceable></command> <option>-icon +something.png -miniicon something_mini.png -caption \"The +Foo\"</option></userinput>. Both the icon and the mini-icon as well as "The +Foo" are properties defined in the <filename>.desktop</filename> file. If +the icons are not defined, they simply default to the executable name +<replaceable>foo</replaceable>.</para> + +<para>This way a user can change these things in &kmenuedit; for his or her +applications. The <option>-caption</option> option is important, because no +user will accept that the menu item <guimenuitem>Editor</guimenuitem> starts +something called <guilabel>kedit-0.9pl4-build47</guilabel>. Instead, users +expect a window called <guilabel>Editor</guilabel>. Furthermore these +names are localized, &ie; an American English user launches +<guimenuitem>CD-Player</guimenuitem> and gets a window called +<guilabel>CD-Player</guilabel> while a German user launches +<guimenuitem>CD-Spieler</guimenuitem> and gets a window called +<guilabel>CD-Spieler</guilabel>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I make &konqueror; start up without a menu bar? +I can't save a view profile when the menu bar is invisible!</para> +</question> + +<answer><para>The easiest way to do this is to edit &konqueror;'s +configuration file manually. Add the following lines to +<filename>~/.trinity/share/config/konquerorrc</filename>: +<programlisting> +[KonqMainWindow] +MenuBar=Disabled +</programlisting> +</para> +<para>On restarting &konqueror;, the menubar should be hidden.</para> +</answer> +</qandaentry> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/gettde.docbook b/doc/khelpcenter/faq/gettde.docbook new file mode 100644 index 000000000..73911e92d --- /dev/null +++ b/doc/khelpcenter/faq/gettde.docbook @@ -0,0 +1,86 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="getting-tde"> +<title>Getting &tde;</title> + +<qandaset> +<qandaentry> +<question id="where-to-get-tde"> +<para>Where do I get &tde;?</para> +</question> +<answer> +<!-- This needs a rewrite including informations about the latest version (link to the info page?)--> +<para>The easiest way to get &tde; is to install a &Linux; based distribution or another &UNIX; operating system +that includes &tde;. +You can find an up-to-date list of distributions that ship +with &tde; <ulink url="http://www.trinitydesktop.org/">here</ulink>.</para> + +<para>The main distribution site for &tde; is +<ulink url="http://www.trinitydesktop.org/">http://www.trinitydesktop.org/</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What is the current version?</para> +</question> +<answer> +<para>TDE is developed continually. Find the latest stable version number <ulink url="http://www.trinitydesktop.org/releases.php">here</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Binary packages are not available for my distro. What do I do?</para> +</question> +<answer> +<para>That is always a challenging situation. Are there skilled packagers who +might help? If you are skilled in compiling software from sources, source +tarballs are available for each TDE release (http://www.trinitydesktop.org/releases.php). +The development version can also be built from our GIT source tree. Use the forums +or mailing lists to contact packagers to obtain copies of their build scripts +that can be massaged to fit your distro.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Where do I find &tde; snapshots?</para> +</question> +<answer> +<para>Learn more about the latest development snapshots at <ulink +url="http://www.trinitydesktop.org/development.php">http://www.trinitydesktop.org/development.php</ulink>. +You might want to consider setting up your own <acronym>GIT</acronym> account to +maintain the latest snapshot at all times. Please refer to <ulink +url="http://www.trinitydesktop.org/development.php">http://www.trinitydesktop.org/development.php</ulink> for further +information. +</para> + +</answer> +</qandaentry> + +<qandaentry> +<question id="where-to-get-qt"> +<para>Where do I get &Qt;?</para> +</question> +<answer> +<para>&Qt; is a product of the Norwegian company Trolltech. The version +upon which TDE is based no longer is actively maintained by Trolltech. +Maintenance is handled by the TDE developers. Get the latest &Qt; version +from the TDE GIT repository at +<ulink url="http://git.trinitydesktop.org/">http://git.trinitydesktop.org/</ulink>.</para> +<para> +With most &Linux; distributions, this version of &Qt; no longer is +included or maintained and must be obtained from the TDE repositories. Because +this version of &Qt; is now maintained exclusively to support TDE, the version supported +by TDE developers is not backwards compatible with the original version from Trolltech.</para> +</answer> +</qandaentry> + + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/index.docbook b/doc/khelpcenter/faq/index.docbook new file mode 100644 index 000000000..478588411 --- /dev/null +++ b/doc/khelpcenter/faq/index.docbook @@ -0,0 +1,115 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kappname "&tde; Frequently Asked Questions"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE" > <!-- change language only here --> + <!ENTITY faq-about SYSTEM "about.docbook"> + <!ENTITY faq-intro SYSTEM "intro.docbook"> + <!ENTITY faq-gettde SYSTEM "gettde.docbook"> + <!ENTITY faq-install SYSTEM "install.docbook"> + <!ENTITY faq-panel SYSTEM "panel.docbook"> + <!ENTITY faq-desktop SYSTEM "desktop.docbook"> + <!ENTITY faq-winmng SYSTEM "winmng.docbook"> + <!ENTITY faq-filemng SYSTEM "filemng.docbook"> + <!ENTITY faq-webbrowse SYSTEM "webbrowse.docbook"> + <!ENTITY faq-configtde SYSTEM "configtde.docbook"> + <!ENTITY faq-tdeapps SYSTEM "tdeapps.docbook"> + <!ENTITY faq-nontdeapps SYSTEM "nontdeapps.docbook"> + <!ENTITY faq-tips SYSTEM "tips.docbook"> + <!ENTITY faq-misc SYSTEM "misc.docbook"> + <!ENTITY faq-notrelated SYSTEM "notrelated.docbook"> + <!ENTITY faq-moreinfo SYSTEM "moreinfo.docbook"> + <!ENTITY faq-contrib SYSTEM "contrib.docbook"> + <!ENTITY faq-questions SYSTEM "questions.docbook" > + <!ENTITY faq-credits SYSTEM "credits.docbook"> + <!ENTITY faq-sound SYSTEM "sound.docbook"> + <!ENTITY faq-qt SYSTEM "qt.docbook"> + +]> +<!--Time-stamp: "2001-09-03 00:10:00 endres"--> +<book lang="&language;"> + +<bookinfo> +<title>&tde; Frequently Asked Questions</title> + +<authorgroup> +<author>&tde-authors;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + +<copyright> +<year>1997-2005</year> +<holder>The &kde; Team</holder> +</copyright> +<copyright> +<year>&tde-copyright-date;</year> +<holder>&tde-team;</holder> +</copyright> + +<legalnotice>&FDLNotice;</legalnotice> + +<date>&tde-release-date;</date> +<releaseinfo>&tde-release-version;</releaseinfo> + +<abstract> <para>This is a collection of frequently asked +questions about the Trinity Desktop Environment. Please report any bugs, +inconsistencies, or omissions you find in this &FAQ; to +<email>trinity-devel@lists.pearsoncomputing.net</email>. Please post +questions to the &tde; mailing lists. Questions are monitored to help +maintain this &FAQ;.</para> </abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>TDE</keyword> +<keyword>FAQ</keyword> +<keyword>question</keyword> +<keyword>answer</keyword> +</keywordset> +</bookinfo> + +&faq-about; +&faq-intro; +&faq-gettde; +&faq-install; +&faq-panel; +&faq-desktop; +&faq-winmng; +&faq-filemng; +&faq-webbrowse; +&faq-configtde; +&faq-tdeapps; +&faq-sound; +&faq-nontdeapps; +&faq-tips; +&faq-misc; +&faq-qt; +&faq-moreinfo; +&faq-questions; +&faq-contrib; + +<chapter id="credits"> +<title>Credits and License</title> + +<!--<para>The current &FAQ; maintainers are:</para> + +<itemizedlist> +<listitem><para>J Hall +<email>jes.hall@kdemail.net</email></para></listitem> +</itemizedlist>--> + +<para>Many of the answers in this &FAQ; are taken +from various mailing lists and newsgroups. Here is a +<emphasis>big</emphasis> thank you to all of you who have contributed +answers that eventually appear in this &FAQ;.</para> + +<para>Special thanks go to the former &FAQ; +maintainers, Rainer Endres, Mr. Lee Wee Tiong, and J. Hall.</para> + + +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; +</chapter> + +&documentation.index; +</book> diff --git a/doc/khelpcenter/faq/install.docbook b/doc/khelpcenter/faq/install.docbook new file mode 100644 index 000000000..91ebbbb5c --- /dev/null +++ b/doc/khelpcenter/faq/install.docbook @@ -0,0 +1,648 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="install"> +<title>Installation instructions</title> + +<para>These are the generic installation instructions for the Trinity +Desktop Environment. Please complement your reading with the +<filename>README</filename> and <filename>INSTALL</filename> text files that +come along with the package. Please read them carefully and try to +help yourself if anything goes wrong. If you need further +assistance, consider joining the &tde; mailing lists +(see our web site instructions for joining the &tde; +<ulink url="http://www.trinitydesktop.org/mailinglist.php">mailing +lists</ulink>).</para> + + +<qandaset> + + +<qandaentry> +<question> +<para>To the would-be converts</para> +</question> +<answer> + +<para>You have heard rumors about &tde;. Or you have seen screenshots. +You want test &tde;. Yet you know next to nothing +about this whole <quote>alternate operating system</quote> business. Don't worry! +You only need to do some (well, maybe not some) reading, that's all!</para> + +<para>&tde; does not run on any version of &Microsoft; &Windows;. To run +&tde;, you need to have a &UNIX; operating system. Please refer to <xref +linkend="platform"/> for more details.</para> + +<para>Decide on a platform and set it up for your system. This +<acronym>FAQ</acronym> can not help you with this, since &tde; is intended +to run on many &UNIX; platforms.</para> + +<para>To obtain &tde;, please refer to <xref linkend="where-to-get-tde"/>. If +you encounter problems while installing &tde;, please do not +hesitate to make use of the &tde; <link +linkend="mailing-lists">mailing lists</link>. No question is too silly to ask, but +remember to first look for answers in this <acronym>FAQ</acronym>.</para> +<para>Good luck and have fun!</para> + +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What kind of hardware do I need to run &tde; ?</para> +</question> +<answer> +<para>To run &tde; consider at least a Pentium III processor, 512MB of memory, and 500MB of free disk space for a basic installation. A full installation will require about 3GB of hard drive storage space. While &tde; will run on slower hardware, performance likely will require some patience. Generally, if your computer runs other desktop environments then the hardware probably is capable of running &tde;.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Available package formats</para> +</question> +<answer> + + +<para>You can find binary and source packages for +different distributions and operating systems on the +<ulink url="http://www.trinitydesktop.org/installation.php">Trinity web site</ulink>. +The binary packages are made by dedicated members of the &tde; community. +The only <quote>official</quote> release is the source tarball +packages. Please refer to the <filename>README</filename>s and +<filename>INSTALL</filename>s in the several binaries folders. +Find the latest stable release +<ulink url="http://www.trinitydesktop.org/releases.php">here</ulink>.</para> + +</answer> +</qandaentry> + +<qandaentry> +<question id="prerequisites"> +<para>Prerequisites</para> +</question> +<answer> + +<!-- rewrite to make it more general, pointing to the according webpages? --> + +<para>You need the &Qt; library as provided by the &tde; developers. Previous +versions of &Qt; will not work with the latest &tde;. +Please ensure you download the correct &Qt;. You will +also need the header files, if you want to compile &tde; +yourself. They are all available, at no cost, from the <ulink +url="http://www.trinitydesktop.org/">&tde; repository</ulink>. +There are optional libraries that might improve &tde; if +installed on your system. An example is OpenSSL which will enable +&konqueror; to browse web pages securely. These additional packages +should be provided by your distributor.</para> + +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Description of the base packages</para> +</question> +<answer> +<para>The base distribution currently consists of several +packages. Some are required, while others are optional. Each package +is available in each of the aforementioned package formats.</para> + +<variablelist> +<varlistentry> +<term>tqt3</term> +<listitem> +<para>Required</para> +<para>This package contains the foundational widget support needed by all +&tde; applications.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tqtinterface</term> +<listitem> +<para>Required</para> +<para>Necessary for supporting subsequent versions of Qt.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>arts</term> +<listitem> +<para>Required</para> +<para>The core sound system for &tde;</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdelibs</term> +<listitem> +<para>Required</para> +<para>This package contains shared libraries that are needed by all +&tde; applications.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdebase</term> +<listitem> +<para>Required</para> +<para>This package contains the base applications that form the core +of the Trinity Desktop Environment like the window manager, the terminal +emulator, the control center, the file manager, and the panel.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>&arts;</term> +<listitem> +<para>Required</para> +<para>The &arts; sound server. A powerful, network transparent sound +server.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeaddons</term> +<listitem> +<para>Optional but recommended</para> +<para>Various plugins for &kate;, &kicker;, &knewsticker;, &konqueror; and &noatun; </para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeartwork</term> +<listitem> +<para>Optional</para> +<para>Additional wallpapers, themes, styles, sounds ...</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdebindings</term> +<listitem> +<para>Optional</para> +<para>Various bindings for other languages, including &Java;, Perl, Python, ...</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdegames</term> +<listitem> +<para>Optional</para> +<para>Various games like &kmahjongg;, &ksnake;, &kasteroids;, and +&kpatience;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdegraphics</term> +<listitem> +<para>Optional but recommended</para> +<para>Various graphics-related programs like &PostScript; previewer, +&DVI; previewer, and a drawing program.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeutils</term> +<listitem> +<para>Optional but recommended</para> +<para>Various desktop tools like a calculator, an editor and other +nifty stuff.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdemultimedia</term> +<listitem> +<para>Optional but recommended</para> +<para>Multimedia applications like a &CD; player and a mixer.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdenetwork</term> +<listitem> +<para>Optional</para> +<para>Network applications. Currently contains the instant messaging client &kopete;, the +download manager &kget;, and several other network-related programs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdepim</term> +<listitem> +<para>Optional but recommended</para> +<para>Personal information management tools. Contains the email client &kmail;, the newsreader &knode; and other related programs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeadmin</term> +<listitem> +<para>Optional but recommended</para> +<para>System administration programs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeedu</term> +<listitem> +<para>Optional</para> +<para> +Educational and entertaining applications for &tde;'s younger users. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdeaccessibility</term> +<listitem> +<para>Optional but recommended</para> +<para> +&tde; accessibility programs such as a screen magnifier and speech synthesizer front end. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdetoys</term> +<listitem> +<para>Optional</para> +<para>Toys!</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdevelop</term> +<listitem> +<para>Optional</para> +<para>A complete Integrated Development Environment for &tde; and &Qt;</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdewebdev</term> +<listitem> +<para>Optional</para> +<para>Web development applications. Contains such applications as &quanta;, an integrated web development environment and other applications useful in web development</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>tdesdk</term> +<listitem> +<para>Optional</para> +<para>&tde; Software Development Kit. Contains a collection of applications and tools used by &tde; Developers.</para> +</listitem> +</varlistentry> +</variablelist> + +<para>Information about compiling all packages is available at the +<ulink url="http://www.trinitydesktop.org/wiki/bin/view/Developers/HowToBuild"> +Trinity wiki</ulink>.</para> + +<para>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.</para> + +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Installation instructions for the different package formats</para> +</question> +<answer> +<para>As &tde; is intended for many &UNIX; systems, please consult the installtion +procedures and package management document for the system being used.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Post-installation procedures</para> +</question> +<answer> +<para>There should be nothing to do after installing the packages except use them! +Nonetheless, should problems arise, there are some common problems to consider:</para> + +<variablelist> + +<varlistentry> +<term>System search path</term> +<listitem> +<para>Be sure all &tde; binary files are installed +in a location listed in your system's <envar>PATH</envar>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>Library files</term> +<listitem> +<para>Be sure the &tde; library files are installed in the expected locations for your +system.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><envar>TDEDIR</envar> environment variable</term> +<listitem> +<para>Be sure the <envar>TDEDIR</envar> environment variable is correctly set.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><filename>starttde</filename> script installation</term> +<listitem> +<para>Verify the <filename>starttde</filename> script is installed to <filename +class="directory">$<envar>TDEDIR</envar>/bin</filename> and therefore in your +system's search path.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><filename>starttde</filename> script is run correctly</term> +<listitem> +<para>Be sure the <filename>starttde</filename> script is being run from within the appropriate +xinitrc or xsession script.</para> +</listitem> +</varlistentry> + +</variablelist> + +<para>This should present you with a new &tde; desktop. You +can now start to explore the wonderful world of &tde;. In case you +want to read some documentation first, there is a recommended +<ulink url="help:/khelpcenter/quickstart">A Quick Start Guide to the Desktop</ulink> +available. Furthermore, every application has an online +help that is available via the <guimenu>Help</guimenu> menu.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Should I remove old version xyz before installing a new +one?</para> +</question> +<answer> +<para>In principle, this is not necessary. The various distro package managers +should handle all dependencies.</para> +<para>If you compile the source code yourself, you should take more care.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="starttde"> +<para>How do I start &tde;?</para> +</question> +<answer> +<para>There are only two methods of starting &tde;: using a login +manager such as &tdm; or from the command line, using <command>startx</command>. +The respective startup scripts should contain a reference to the +<filename>starttde</filename> script.</para> +</answer> +</qandaentry> +<!-- Still needed? +<qandaentry> +<question> +<para>Whenever I start &tde;, it complains about "shadow passwords". +Why?</para> +</question> +<answer> +<para>When your system uses shadow passwords, the screensaver can only +run properly if the suid bit is set. This bit gives the screensavers +root privileges, which are needed to access the shadow passwords. +<caution><para>The screensavers might be configured to secure the +machine until the password is entered.</para></caution></para> +<procedure> +<title>Setting the suid bit on the screensavers</title> +<step performance="required"><para>become root</para></step> +<step performance="required"><para><command>chown root +$<envar>TDEDIR</envar>/bin/*.kss</command></para></step> +<step performance="required"><para><command>chmod u+s +$<envar>TDEDIR</envar>/bin/*.kss</command></para></step> +</procedure> +<para>Alternatively, if you compile &tde; from source, you can use +<command>./configure <option>with-shadow</option></command> to +configure tdebase. Then the suid bit is set automatically during +<command>make install</command>.</para> +</answer> +</qandaentry> +--> + +<qandaentry> +<question> +<para><command>starttde</command> fails with <errorname>can not connect to X +server</errorname>. What is wrong?</para> +</question> +<answer> +<para>You probably tried to start &tde; directly with <command>starttde</command> rather +than letting the login manager or startx process run that script. From the command +line the X server is started with <command>startx</command>. +<command>starttde</command> is the +script that should be run from your <filename>.xinitrc</filename>, <filename>.xsession</filename>, or +<filename>.Xclients</filename> to activate the window manager and the necessary server +daemons for &tde;. See also <xref linkend="starttde"/>.</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>&tde; on &AIX;?</para> +</question> +<answer> +<para> +<acronym>IBM</acronym> now officially support &tde; on &AIX;. You can find +details at <ulink +url="http://www.ibm.com/servers/aix/products/aixos/linux/index.html">http://www.ibm.com/servers/aix/products/aixos/linux/index.html</ulink>. +There is also some older information at <ulink url="http://space.twc.de/~stefan/kde/aix.html">http://space.twc.de/~stefan/kde/aix.html</ulink>.</para> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question> +<para>&tde; on a laptop?</para> +</question> +<answer> +<para>If you can get &X-Window; to run on your laptop, you should not have any problem +getting &tde; to run on it. In addition, you might find the following +links helpful:</para> +<itemizedlist> +<listitem> +<para><ulink url="http://www.linux-laptop.net/">http://www.linux-laptop.net/</ulink></para> +</listitem> +<listitem> +<para><ulink url="http://www.sanpei.org/Laptop-X/note-list.html">http://www.sanpei.org/Laptop-X/note-list.html</ulink></para> +</listitem> +</itemizedlist> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question> +<para>I do not like the default &tde; folder after installation. How +do I move it without breaking anything?</para> +</question> +<answer> +<para>Assuming the default is <filename +class="directory">/opt/kde</filename> and you want to move it to +<filename class="directory">/usr/local/kde</filename>, here's what +you have to do:</para> +<procedure> +<step performance="required"><para>change to superuser if you aren't already</para></step> +<step performance="required"><para><command>mv /opt/kde /usr/local/kde</command></para></step> +<step performance="required"><para><command>ln -s /usr/local/kde +/opt/kde</command></para></step> +</procedure> +<para>This will put all your &tde; files in <filename +class="directory">/usr/local/kde</filename> but everything is +still accessible from <filename +class="directory">/opt/kde</filename>.</para> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question> +<para>What files can I delete from my &tde; install folder? Can all the +<filename>*.h</filename>, <filename>*.c</filename> and <filename>*.o</filename> +files be safely removed?</para> +</question> +<answer> +<para>There should not be any need to keep the <filename>.c</filename> and +<filename>.o</filename> files, but you might want to keep the +<filename>.h</filename> files, as they are used by includes if you ever want to +compile your own &tde; 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.</para> +</answer> +</qandaentry>--> + +<qandaentry> +<question> +<para>Will I lose my current settings when I update &tde;?</para> +</question> +<answer> +<para>You shouldn't. &tde; should transport your settings +intact. All settings should be safe.</para> +</answer> +</qandaentry> + +<qandaentry id="greyscreen"> +<question> +<para>I updated &tde; and all seemed to go fine, but when I start &tde;, +I get a blank gray screen, and nothing happens. There are errors in +the console about DCOPserver. What's going on?</para> +</question> + +<answer> +<para> +&tde; uses several temporary files during its operation. +Usually these directories and files are found in the following locations:</para> +<itemizedlist> +<listitem><para><filename>$HOME/.DCOPserver-*</filename> (there are usually two of these; one is a symlink to the other)</para></listitem> +<listitem><para><filename>$HOME/.trinity/socket-<replaceable>hostname</replaceable></filename></para></listitem> +<listitem><para><filename>$HOME/.trinity/tmp-<replaceable>hostname</replaceable></filename>, which normally is a symlink to the next file:</para></listitem> +<listitem><para><filename>$TMP/tde-<replaceable>USER</replaceable></filename></para></listitem> +<listitem><para><filename>$HOME/.trinity/socket-<replaceable>hostname</replaceable></filename>, which normally is a symlink to:</para></listitem> +<listitem><para><filename>$TMP/tdesocket-<replaceable>USER</replaceable></filename></para></listitem> +</itemizedlist> + +<para>If the symlinks get broken, such as when +<command>cron</command> or a shutdown script is emptying the +<filename class="directory">/tmp</filename> folder, then strange +things will happen. These files, and the symlinks, will all be +created automatically at the start of &tde; so you can safely remove +them <emphasis>while &tde; is not running</emphasis>.</para> + +<para>If you are only getting a gray screen when you start &tde;, or if you get an error message telling you to <errorname>Check your installation</errorname>, then shut down X and delete all the files listed above, then try to restart X.</para> + +<para>Normally (&ie; when not updating between &tde; versions) it's +quite safe to leave these files intact, and you may shave a few +seconds off your &tde; startup time by doing so.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is &tde; backwards or binary compatible with KDE 3?</para> +</question> +<answer> +<para>While many programs originally designed for KDE 3 will compile on Trinity, binary +compatibility with KDE 3 is not a goal of &tde; developers.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is &tde; backwards or binary compatible with previous releases of &tde;?</para> +</question> +<answer> +<para>Possibly, but binary compatibility is not a project goal with major point +releases. A package that built on a previous version of &tde; but no longer builds +on the current release should be brought to the attention of the developers.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is my KDE 3 profile directory compatible with Trinity?</para> +</question> +<answer> +<para>Not quite but don't worry. Some "scrubbing" cleanup is required to migrate +a KDE 3 profile. For new users or those with little customization we recommend +creating a fresh profile. For those long-time users who cringe at the thought +of recreating their desktop, we provide a migratekde3 shell script. That script +copies a $HOME/.kde3 profile directory to $HOME/.trinity and performs the required +"scrubbing" cleanup. Although the script has been tested we provide the tool "as is" +with no warranties or guarantees. (The script works really well, actually. :-))</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>Compiling tdebase gives me a <errorname>bin/sh: msgfmt: command +not found</errorname> error!</para> +</question> +<answer> +<para>You need the &GNU; <application>msgfmt</application> which is +part of the &GNU; i18n package <application>gettext</application>. +You should be able to download it from any +&GNU; mirror.</para> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question> +<para>How do I uninstall &tde; applications compiled from +source?</para> +</question> +<answer> +<para>You can uninstall your programs by typing <command>make +uninstall</command> in the folder where you did <command>make +install</command>. If you have already deleted that folder, +then there is only one way, and it is not good: go to <filename +class="directory">$<envar>TDEDIR</envar>/bin</filename> and start deleting files +one by one.</para> +<para>If you expect to find yourself in this situation, you might want to +consider a program such as &GNU; <application>stow</application>, found at +<ulink url="http://www.gnu.org/software/stow/stow.html">http://www.gnu.org/software/stow/stow.html</ulink>.</para> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question id="gif"> +<para>What is up with &GIF; support?</para> +</question> +<answer> +<para>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. +<command>./configure <option>-gif</option></command>.</para> +</answer> +</qandaentry>--> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/intro.docbook b/doc/khelpcenter/faq/intro.docbook new file mode 100644 index 000000000..720b2bc61 --- /dev/null +++ b/doc/khelpcenter/faq/intro.docbook @@ -0,0 +1,218 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="introduction"> +<title>Introduction</title> + +<qandaset> +<qandaentry> +<question> +<para>What is &tde;?</para> +</question> +<answer> +<para>&tde; is the Trinity Desktop Environment. The project was initiated +by Matthias Ettrich in 1996 and originally called the K Desktop Environment. +The aim of the &tde; project is to connect the power of the &UNIX; operating +systems with the comfort of a modern user interface.</para> +<para>For additional information about &tde;, check the Trinity web site at +<ulink url="http://www.trinitydesktop.org/about.php">About Trinity</ulink></para> +</answer> +</qandaentry> + +<qandaentry> +<question id="platform"> +<para>On which platforms can I expect &tde; to work?</para> +</question> +<answer> +<para>&tde; is a Desktop Environment for all flavors of &UNIX; systems. +While most &tde; developers use &Linux; based systems, &tde; should run +on a wide range of systems. You might need to tweak the +source code a bit to get &tde; to compile on different variant +of &UNIX; systems, or when not using the &GNU; development tools, in +particular the &gcc; compiler.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Why should I use TDE?</para> +</question> +<answer> +<para>TDE provides a traditional computer desktop that is snappy and +responsive. A project goal is to provide a highly customizable +desktop without forcing any particular feature or effect on users. +TDE comes with many software tools to provide a productive and enjoyable +computer desktop system.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is &tde; a window manager?</para> +</question> +<answer> +<para>No, &tde; is not a window manager. While &tde; includes a +sophisticated window manager (&twin;), &tde; is much more, providing +a full integrated desktop environment. &tde; includes a web browser, +a file manager, a window manager, a help system, a +configuration system, many tools and utilities, and many +applications, including but not limited to mail +and news clients, drawing programs, a PDF and a &DVI; viewer +and so forth.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is &tde; a <acronym>CDE</acronym>, &Windows; or &Mac; +<acronym>OS</acronym> clone?</para> +</question> +<answer> +<para>&tde; is not a clone. Specifically &tde; is not a +Common Desktop Environment (<acronym>CDE</acronym>) or &Windows; clone. +While developers have and will continue to glean the best features from existing +desktop environments, &tde; is a unique environment that has and +will continue to go its own way.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>On what platform is TDE based?</para> +</question> +<answer> +<para>TDE uses C++ and the <link linkend="qt">&Qt; C++ crossplatform toolkit</link>. +The TDE development team now maintains the Qt3 toolkit, renamed TQt3.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is &tde; free software?</para> +</question> +<answer> +<para>Yes, &tde; is free software according to the &GNU; General +Public License. All &tde; libraries are available under the +<acronym>LGPL</acronym> making commercial software development for the +&tde; desktop possible, but all &tde; applications are licensed under +the <acronym>GPL</acronym>.</para> +<para>&tde; uses the <link linkend="qt">&Qt; C++ crossplatform +toolkit</link>, which, since version 2.2, is released under the +<acronym>GPL</acronym>.</para> +<para>Both &tde; and &Qt; can be made available on +&CD-ROM; free of charge. No runtime fees of any kind are +incurred.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Why the rebranding and renaming efforts? Why not continue calling the software KDE?</para> +</question> +<answer> +<para>The "KDE" name, various logos, and related efforts are trademarked by the KDE +Foundation. Since the Trinity project is not affiliated with the KDE Foundation, +legally we can't use their trademarks.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Why the change in version numbers?</para> +</question> +<answer> +<para>Trinity evolved from the last KDE 3.5 release, 3.5.10. Subsequent Trinity releases +followed that numbering scheme. Release R14.0.0 marks a turning point in Trinity history +because a great deal of the code infrastructure was changed. While those changes do not +effect the usability or look-and-feel of the desktop that users enjoy, Trinity developers +believe a change in the version scheme distinguishes when those changes occurred. An +original project goal by users was to retain the flavor of the original KDE 3.5 desktop. +That goal remains intact. To reflect that original goal, the last number in the original +version scheme is retained in the new version scheme but is now the primary version number. +While the infrastructure has changed, the desktop itself remains the same as the original +KDE 3.5. This new version scheme indicates a modest divergence from the original KDE 3.5 +series and that Trinity is now its own desktop environment. The new version scheme reminds +users that Trinity retains the original KDE 3.5 design, but is moving forward as a separate +desktop project.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="trinity-vs-kde4"> +<para>How is Trinity different from KDE4?</para> +</question> +<answer> +<para>Both desktop environments share common roots to KDE 3.5.10, which was the last +official release of KDE in the 3.x series. Many KDE developers wanted to break +from that code chain and tool sets to start afresh. Thus was born KDE4. In +addition to moving to the Qt4 tool set, the KDE developers revamped the +underlying KDE code set.</para> + +<para>KDE4 and Trinity have different philosophies about work flow preferences. +KDE4 developers want to support certain work flow concepts and techniques. +Trinity developers want to maintain a "traditional" desktop environment.</para> + +<para>For example, KDE4 offers the following tools:</para> + +<itemizedlist> + +<listitem> +<para>Semantic desktop through Nepomuk</para> +</listitem> + +<listitem> +<para>PIM (Personal Information Management) data caching through Akonadi</para> +</listitem> + +<listitem> +<para>Desktop file searching through Strigi</para> +</listitem> + +<listitem> +<para>Activities, a computer desktop metaphor for managing tasks and activities</para> +</listitem> + +</itemizedlist> + +<para>Whereas TDE offers the following:</para> + +<itemizedlist> + +<listitem> +<para>Desktop search through the locate:/ tdeio-slave</para> +</listitem> + +<listitem> +<para>Integrated PIM suite with plugins</para> +</listitem> + +<listitem> +<para>Related task management using multiple desktops</para> +</listitem> + +</itemizedlist> + +<para>The KDE developers support alternate desktop interfaces, such as those used +with netbooks, tablets, and smart phones. TDE provides a single interface that is +optimized for the mouse/keyboard HCI (Human-computer interaction) model.</para> + +<para>Both desktop environments provide an excellent choice for various work +flows but differ in approach. Trinity leans toward user expectations of how +desktop environments have functioned traditionally. There is a sense of +familiarity with that environment many people like. Similarly other users prefer +the work flow features offered by KDE4 because those features match their +expectations of how they want their computer to behave. The difference between the +two environments does not mean one is better, buggier, or slower -- mdash; only that +they are different and appeal to different types of people. Although sharing a +common heritage, both desktops appeal to different groups of people. As always +with free/libre software, there is a choice.</para> +</answer> +</qandaentry> + + +</qandaset> +</chapter> + diff --git a/doc/khelpcenter/faq/misc.docbook b/doc/khelpcenter/faq/misc.docbook new file mode 100644 index 000000000..0dd2c4556 --- /dev/null +++ b/doc/khelpcenter/faq/misc.docbook @@ -0,0 +1,243 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="misc"> +<title>Miscellaneous questions</title> + +<qandaset> + + +<qandaentry> +<question> +<para>Does &tde; support transparency and other visual effects provided by the new composite extension to X.org?</para> +</question> +<answer> +<para>Yes. &tde; supports for the X composite extension and provides its own compositor. This allows for effects such as translucency and drop shadows for all windows, easily configurable through &twin;'s configuration dialog. For those using an xorg.conf file, be sure the following is included: + +<screen> +Section "Extensions" +Option "Composite" "Enable" +EndSection +</screen> + +<!-- This option is enabled by default --> +<!--Those users with an Nvidia graphics card and driver can improve the performance of these effects by adding the RenderAccel option to the Device section for the graphics card: + +<screen> +Section "Device" + Identifier "nvidia-fx5200" + Driver "nvidia" + Option "RenderAccel" "true" +</screen>--> +After correctly configuring xorg.conf, transparency and other effects can be enabled through the <menuchoice><guimenu>Desktop</guimenu><guimenuitem>Window Behavior</guimenuitem></menuchoice> &kcontrolcenter; module, under the <guilabel>Translucency</guilabel> tab. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What about &tde; programs that do not have icons? How do I get +them into the menu?</para> +</question> +<answer> +<para>Use &kmenuedit;. To access it use the &RMB; on the +<guibutton>T</guibutton> button and select <guimenu>Menu Editor</guimenu>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Does &tde; have a graphical &FTP; client?</para> +</question> +<answer> +<para>Yes, and it is none other than your favorite file +manager, &konqueror;. You can drag and drop remote files into local +folders.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I exit &tde;?</para> +</question> +<answer> +<para>On the panel (kicker) use the &LMB; to select the <guibutton>T</guibutton> +button and select <guimenu>Log Out...</guimenu>. Another method is to use the &RMB; +to select an empty area of the desktop, which opens a popup menu, +containing <guimenu>Log Out...</guimenu> as one of the options. +Another option is to use a keyboard shortcut, which on many systems is +<keycombo action="simul">&Ctrl;&Alt;<keycap>Delete</keycap></keycombo>. +A fourth option is to add the <application>Lock/Logout</application> button applet. +<note><para>Depending on your configuration of the &X-Window;, <keycombo +action="simul">&Ctrl;&Alt;&Backspace;</keycombo> +might also exit &tde; by killing the X server, but using that shortcut prevents +session management and is recommended only for emergencies.</para></note></para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is there a program that checks for new mails at my +<acronym>ISP</acronym> if and only if I am online?</para> +</question> +<answer> +<para>&korn; will do the job. If you are not +connected, it will just sit there (idling).</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is it really necessary to update to the latest version?</para> +</question> +<answer> +<para>We recommend updating to the latest stable release, or at least to stay within +a release version. Otherwise, getting answers to questions might be challenging. +Each release always contains bug fixes and enhancements. Often a problem with an old version +has been fixed in a more recent release. Newer versions also fix security problems. Only seldom are bug and security fixes backported to older releases.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I copy and paste in &tde;?</para> +</question> +<answer> +<para>The simplest method is to use your mouse:</para> +<procedure> +<step performance="required"><para>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.</para></step> +<step performance="required"><para>Go to the destination area; depending on your configuration, +you might need to click it using the &LMB; to give it +focus.</para></step> +<step performance="required"><para>Click the &MMB; to paste. If you have a two +button mouse and are emulating a three button mouse, push both buttons +simultaneously.</para></step> +</procedure> +<para>The standard keyboard shortcuts for copying is <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>, to cut is <keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>, and to paste is <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>.</para> +<para>&tde; provides a multiple layer clipboard called &klipper;. Refer to the <ulink +url="help:/klipper">&klipper; handbook</ulink> for further information.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I convert the default &RedHat; menus into a menu in the +<guimenu>TDE</guimenu> menu?</para> +</question> +<answer> +<para>Click on the <guibutton>T</guibutton> button and select +<menuchoice><guimenu>System</guimenu><guimenuitem>Appfinder</guimenuitem></menuchoice>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="GIT"> +<para>What is <acronym>GIT</acronym>?</para> +</question> +<answer> +<para>GIT is a distributed version control and source code management system. +GIT is used to maintain source code under development. The &tde; developers use GIT. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Does &tde; support dual screen (Xinerama)?</para> +</question> +<answer> +<para>Yes, you need to have a multi-headed X server. +</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>Why does Drag and Drop not work with Xinerama?</para> +</question> +<answer> +<para>You should update to XFree86 4.2.0 for this to work properly.</para> +</answer> +</qandaentry>--> + +<qandaentry> +<question> +<para>How do I check which version of &tde; I am using?</para> +</question> +<answer> +<para>Start any Trinity app. Each app has a Help menu providing +related information in the <guimenuitem>About</guimenuitem> dialog. +</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>How do I create themes and icons?</para> +</question> +<answer> +<para>Go see <ulink +url="http://artist.kde.org">http://artist.kde.org</ulink>. +There is also a more informal community of &tde; related artists and +artwork at <ulink url="http://kde-look.org">http://kde-look.org</ulink>. +</para> +</answer> +</qandaentry>--> + +<qandaentry> +<question> +<para>How do I learn about development updates?</para> +</question> +<answer> +<para>You might want to subscribe to the +<ulink url="http://www.trinitydesktop.org/mailinglist.php"> +&tde; developer's mail list</ulink>. +Refer to <ulink url="http://trinity-devel.pearsoncomputing.net/">http://trinity-devel.pearsoncomputing.net/</ulink> +if you want to read without subscribing.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is there a release schedule?</para> +</question> +<answer> +<para>The Trinity developers strive for a six to nine month schedule but that is not rigid or set in stone.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Are there plans to support semantic desktops?</para> +</question> +<answer> +<para>Not at this time.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Are there plans to support tablet-like or special netbook desktop modes?</para> +</question> +<answer> +<para>No. The TDE team suggests a tablet-centric interface such as Unity, KDE4, or GNOME 3 for those devices.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do the developers propose to transition away from HAL (hardware abstraction layer)?</para> +</question> +<answer> +<para>The Trinity team developed a new native hardware support layer that is under testing. +That new system will be enabled by default in a future release, but is available now +in the development sources.</para> +</answer> +</qandaentry> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/moreinfo.docbook b/doc/khelpcenter/faq/moreinfo.docbook new file mode 100644 index 000000000..f9d619456 --- /dev/null +++ b/doc/khelpcenter/faq/moreinfo.docbook @@ -0,0 +1,137 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="more-info"> +<title>Getting more information</title> + +<qandaset> +<qandaentry> +<question> +<para>Where is the &tde; homepage?</para> +</question> +<answer> +<para>The &tde; homepage is located at <ulink +url="http://www.trinitydesktop.org/">http://www.trinitydesktop.org/</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="mailing-lists"> +<para>Is there a &tde; mailing list?</para> +</question> +<answer> +<para>There are several &tde; mailing lists. Each focuses on a different +aspect of &tde;. Some are for developers, so they are not +discussed in detail. Some of the more important lists that users +might be interested in are:</para> + +<variablelist> +<varlistentry> +<term><ulink url="http://www.trinitydesktop.org/mailinglist.php">tde-users</ulink></term> +<listitem><para>For general discussion, users helping each other.</para></listitem> +</varlistentry> + +<varlistentry> +<term><ulink url="http://www.trinitydesktop.org/mailinglist.php">tde-announce</ulink></term> +<listitem><para>Announcements of &tde; news</para></listitem> +</varlistentry> + +<varlistentry> +<term><ulink url="http://www.trinitydesktop.org/mailinglist.php">tde-devel</ulink></term> +<listitem><para>For developers, artists, documentation writers.</para></listitem> +</varlistentry> +</variablelist> + +<para>For the complete list of mailing lists available, please refer +to <ulink +url="http://www.trinitydesktop.org/mailinglist.php">http://www.trinitydesktop.org/mailinglist.php</ulink>.</para> +<para>Please note that it is not a good idea to ask questions that are +already answered in this &FAQ;.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="subscribe"> +<para>How do I subscribe/unsubscribe to these lists?</para> +</question> +<answer> +<para>To subscribe, follow the directions here: +<ulink url="http://www.trinitydesktop.org/mailinglist.php">Official Mailing Lists</ulink> +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is there a mailing list archive?</para> +</question> +<answer> +<para>Yes, each list has a searchable archive: + +<variablelist> +<varlistentry> +<term><ulink url="http://trinity-users.pearsoncomputing.net/">tde-users</ulink></term> +<listitem><para>General discussion archives.</para></listitem> +</varlistentry> + +<varlistentry> +<term><ulink url="http://trinity-announce.pearsoncomputing.net/">tde-announce</ulink></term> +<listitem><para>Announcement archives.</para></listitem> +</varlistentry> + +<varlistentry> +<term><ulink url="http://trinity-devel.pearsoncomputing.net/">tde-devel</ulink></term> +<listitem><para>Developers, artists, documentation writer archives.</para></listitem> +</varlistentry> +</variablelist> + +</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question id="newsgroups"> +<para>Is there a newsgroup about &tde;?</para> +</question> +<answer> +<para>Yes, there is! It is at <literal>comp.windows.x.kde</literal>. +In addition, there is also a German newsgroup at +<literal>de.alt.comp.kde</literal>. Please note that it is not a good +idea to ask questions which are already answered in this +&FAQ;.</para> +</answer> +</qandaentry>--> + +<!--<qandaentry> +<question> +<para>Are there any other &tde;-related &FAQ;s?</para> +</question> +<answer> +<para>Yes. Here is a list of them:</para> +<itemizedlist> +<listitem><para><ulink +url="http://www.kde.org/info/faq.php">&tde; &FAQ;</ulink></para></listitem> +<listitem><para><ulink +url="http://konqueror.org/faq/">&konqueror; +&FAQ;</ulink></para></listitem> +<listitem><para><ulink +url="http://www.arts-project.org/doc/manual/index.html">aRts +sound server documentation</ulink></para></listitem>--> + +<!-- Removed because the kmail FAQ is part of the KMail manual and not a --> +<!-- separate document +<listitem><para><ulink +url="http://kmail.kde.org/manual/faq.html">&kmail; +&FAQ;</ulink></para></listitem> +--> + +<!--</itemizedlist> +</answer> +</qandaentry>--> + +</qandaset> +</chapter> + diff --git a/doc/khelpcenter/faq/nontdeapps.docbook b/doc/khelpcenter/faq/nontdeapps.docbook new file mode 100644 index 000000000..9fc3d70ad --- /dev/null +++ b/doc/khelpcenter/faq/nontdeapps.docbook @@ -0,0 +1,84 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="non-tde-apps"> +<title>&tde; with non-&tde; applications</title> + +<!-- FIXME: This seems to be obsolete. The only similar option is "Apply +*colors* to --> + +<!-- non-tde apps" --> +<qandaset> +<qandaentry> +<question> +<para>My non-&tde; applications like &Emacs; and +<application>kterm</application> are running amok with strange +colors!</para> +</question> +<answer> +<para>Start the <application>&tde; Control Center</application> and in +<menuchoice><guimenu>Appearance & Themes</guimenu><guimenuitem> +Colors</guimenuitem></menuchoice> uncheck the <guilabel>Apply colors to +non-TDE applications</guilabel> checkbox and click +<guibutton>Apply</guibutton>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How can I set my default web browser to be something other +than &konqueror;?</para></question> +<answer> +<para>Open the &kcontrolcenter; and +navigate to the <menuchoice><guimenu>TDE Components</guimenu><guimenuitem>Component +Chooser</guimenuitem></menuchoice> panel. Select <guilabel>Web +Browser</guilabel> from the list on the left, then select <guilabel>Open +http and https URLs in the following browser:</guilabel> and type in the +name of the browser (⪚ <application>mozilla</application>, +<application>firefox</application>, <application>opera</application>, &etc;) +in the textbox.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How can I configure the style and fonts of <acronym>GTK</acronym> +applications within &tde; ? +</para> +</question> +<answer> +<para> +Install the <application>qt-gtk-engine</application> package, which is available as part of &tde;. This +theme engine makes <acronym>GTK</acronym> applications look like your &tde; 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 <menuchoice><guimenu>Appearance & Themes</guimenu><guimenuitem>GTK +Styles and Fonts</guimenuitem></menuchoice>. +</para> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>I have been hearing about this gecko kpart or &Qt; Mozilla, how do I +get these?</para> +</question> +<answer> +<para> +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: +<ulink url="http://www.mozilla.org/cvs.html"> +http://www.mozilla.org/cvs.html</ulink>. Then, configure either the Mozilla +suite or the Firefox browser with the option +<command>- -enable-default-toolkit=qt</command> in addition to any other +options you would like to enable. More instructions on building Mozilla can +be found <ulink url="http://www.mozilla.org/build">here</ulink>. +</para> +</answer> +</qandaentry>--> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/notrelated.docbook b/doc/khelpcenter/faq/notrelated.docbook new file mode 100644 index 000000000..5440341c1 --- /dev/null +++ b/doc/khelpcenter/faq/notrelated.docbook @@ -0,0 +1,232 @@ +<!-- if you want to validate this file separately, uncomment this prolog: + +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> + +--> + +<chapter id="not-kde"> +<title>Not really &tde;-related, but frequently asked nevertheless.</title> + +<qandaset> +<qandaentry> +<question> +<para>How do I change the screen resolution?</para> +</question> +<answer> +<para>Use <keycombo +action="simul">&Ctrl;&Alt;<keycap>+</keycap></keycombo> and <keycombo +action="simul">&Ctrl;&Alt;<keycap>-</keycap></keycombo> to cycle through +the resolutions you have defined in <filename>XF86Config</filename> (maybe under +<filename class="directory">/etc/X11</filename>; 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. +<caution><para>Always make a backup copy of your <filename>XF86Config</filename> file +<emphasis>before</emphasis> you start editing it. Errors in this file +can render &X-Window; unusable.</para></caution> +<note><para>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 <ulink url="http://xfree.org">XFree86(TM): +Home Page</ulink>.</para></note></para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I change the color depth?</para> +</question> +<answer> +<para>There is no way you can do this on the fly. You can either +start &X-Window; using <command>startx <option> -bpp +<replaceable>number</replaceable></option></command> where +<replaceable>number</replaceable> can be 8, 16, 24 or 32, depending on +the depth you want. Alternatively, if you are using +<application>xdm</application>/&tdm;, you +need to edit +<filename>/etc/X11/xdm/Xservers</filename> (may vary) and enter +<userinput>:0 local /usr/X11R6/bin/X -bpp 16</userinput> for 16 bit color +depth.</para> +<para>You can also edit the <filename>XF86Config</filename> file and add a line +like <userinput>DefaultColorDepth +<replaceable>number</replaceable></userinput> to Section "Screen". +The next time you start X, it will run with the newly-configured color +depth.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What can I do if I am using a 2-button mouse?</para> +</question> +<answer> +<para>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 <option>Emulate3Buttons</option> +in your <filename>XF86Config</filename> file.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What is a "sticky" window?</para> +</question> +<answer> +<para>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. +<application>Xclock</application> is a typical candidate for sticking, +as you need to run only one instance of it, and it always stays with +you.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I replace the "X" mouse pointer with an arrow?</para> +</question> +<answer> +<para>The various types of cursor available in X are defined in +<filename class="headerfile">X11/cursorfont.h</filename>. You can +change it using <command>xsetroot -cursor_name +<replaceable>name_of_cursor</replaceable></command>. For example, I +have the following in my <filename>.Xclients</filename>:</para> +<screen> +xsetroot -cursor_name left_ptr +</screen> +<para>This will create the common left-angled pointer. To see other +alternatives, type <command>xfd -fn cursor</command>. And of course, +do not forget that <command>man xsetroot</command> is your +friend.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I extract/install diff files?</para> +</question> +<answer> +<para>To generate a context-diff suitable for patching, use +<command>diff -u <replaceable>old-file new-file</replaceable> > +<replaceable>patchfile</replaceable></command>. To apply the diff to +a file (<abbrev>i.e.</abbrev> "patch the file"), execute +<command>patch < <replaceable>patchfile</replaceable></command>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I get &Linux; to mount the floppy device for use with both +DOS and ext2 formatted floppies?</para> +</question> +<answer> +<para>Just specify the filesystem type as auto in +<filename>/etc/fstab</filename>. Auto detection works fine for DOS and +ext2.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I start &tde; with the <keycap>Num Lock</keycap> on?</para> +</question> +<answer> +<para>Have you tried <command>man setleds</command>? In addition, you +might want to edit your +<filename>$<envar>HOME</envar>/.Xmodmap</filename> and put the +following lines in:</para> +<screen> +! 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 = +</screen> +<para>Other possible alternatives:</para> +<itemizedlist> +<listitem><para><application>xkeycaps</application>: +<mousebutton>right</mousebutton> clicking should allow edits. You may +have to do this as root.</para></listitem> +<listitem><para><command>man XF86Config</command> and look under +section Keyboard.</para></listitem> +<listitem><para>Install <application>NumLockX</application>, which is +available from <ulink +url="http://dforce.sh.cvut.cz/~seli/en/numlockx">http://dforce.sh.cvut.cz/~seli/en/numlockx</ulink>.</para></listitem> +</itemizedlist> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I take window or desktop screenshots?</para> +</question> +<answer> +<para>Use &ksnapshot;.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Is there a tool to make webpages?</para> +</question> +<answer> +<para>Yes, and there are a lot of them out there, including +<application>StarOffice</application>, <application>&Netscape; Composer</application>, and +<application>XEmacs</application>. +There are also many &tde; applications. To find the most current +list, go to <ulink url="http://kde-apps.org">kde-apps.org: The +Latest in &tde; Applications</ulink> and search for <emphasis>web +development</emphasis>. Try as many as possible and choose the one +most suitable to your needs.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What do all those acronyms like AFAIK mean?</para> +</question> +<answer> +<para><screen> +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 +</screen></para> +</answer> +</qandaentry> +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/panel.docbook b/doc/khelpcenter/faq/panel.docbook new file mode 100644 index 000000000..68330ac9a --- /dev/null +++ b/doc/khelpcenter/faq/panel.docbook @@ -0,0 +1,155 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="panel"> +<title>The panel</title> + +<qandaset> +<qandaentry> +<question> +<para>How do I add applications to the &tde; panel (&kicker;)?</para> +</question> +<answer> +<para>There are several ways to add an application to the panel. +The easiest is to right-click on the panel, and from the context +menu that appears, select <guimenu>Add Application to +Panel</guimenu>.</para> +<para>For more ways of adding buttons to the panel, refer to the +<ulink url="help:/kicker">Kicker</ulink> Handbook.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I change the menu <guibutton>T</guibutton> button of +the panel to another picture?</para> +</question> +<answer> +<para>The simplest way is to right-click on the panel, from the context menu +select <guimenu>Configure Panel</guimenu>, from the icon list on the left side, +select Menus, then inside the TDE Menu grouping, select the TDE Menu button icon. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>After updating &tde;, my &kmenu; appears to be empty! How can I get my menu back? +</para> +</question> +<answer> +<para> +User modifications to the &kmenu; are stored in +<filename>$<envar>HOME</envar>/.config/menus/applications-tdemenuedit.menu</filename>. +Try moving this file out of the way and then issuing the +command <userinput><command>tdebuildsycoca</command> +<option>--noincremental</option></userinput>. This should restore you to the +default system menus. If that is the case you'll have to recreate your customized menu. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>My desktop panel has disappeared. How can I get it +back?</para> +</question> +<answer> +<para>The panel disappearing is usually due to a crash. This might be +caused by loading an applet that has a fatal bug or a bad installation +of &tde; and/or the panel.</para> +<para>The easiest way to get the panel back is to launch the +<guilabel>Run Command</guilabel> window by pressing <keycombo +action="simul">&Alt;<keycap>F2</keycap></keycombo> and entering +<userinput><command>kicker</command></userinput>, and then pressing the +<guibutton>OK</guibutton> button.</para> +<para>If the panel continues to disappear, you may wish to either +remove or edit by hand your +<filename>$<envar>TDEHOME</envar>/share/config/kickerrc</filename> +file, where <filename +class="directory">$<envar>TDEHOME</envar></filename> is usually +<filename class="directory">~/.trinity</filename>. If you choose to edit +by hand, start by removing the applet entry groups.</para> +</answer> +</qandaentry> + +<!--<qandaentry><question> +<para>Where did the Icon Zooming option that used to be in &kicker; go? +</para></question> +<answer><para> +Icon zooming was not actively maintained and had caused severe bugs and usability issues. It was replaced in &tde; 3.4 by the new mouse over effects, which combine esthetics with useful information. +</para></answer> +</qandaentry>--> + +<qandaentry> +<question><para>How can I start an application minimized to the system +tray?</para> +</question> +<answer> +<para>Use <command>ksystraycmd</command>. For example, to start a &konsole; hidden +in the system tray, run <userinput><command>ksystraycmd </command> +<option>--hidden</option> <command>konsole</command></userinput>. For +more information about <command>ksystraycmd</command>, see the section +<quote>Advanced Window Management</quote> in the &tde; +<ulink url="help:/khelpcenter/userguide/windows-how-to-work.html#advanced-window-management"> +User Guide</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I use the &Windows; key to open the &kmenu;?</para> +</question> +<answer><para>Previous versions of &tde; provided a trick to allow you to +use the &Windows; key both as a modifier (so you could have shortcuts +like <keycombo action="simul"><keysym>Win</keysym><keycap>R</keycap> +</keycombo>), and as a regular key (so that pressing +<keysym>Win</keysym> 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 &tde;, you have two +options: either use a different shortcut to open the &kmenu; (the +default is <keycombo action="simul">&Alt;<keycap>F1</keycap> +</keycombo>), or remap the <keysym>Win</keysym> key to be a regular +key, rather than a modifier.</para> + +<para>If you choose to do the second, here's one way: + +<orderedlist> +<listitem><para>Find the keycode for your <keysym>Win</keysym> key +using <command>xev</command>: Run the command +<userinput><command>xev</command></userinput> in a &konsole;, and +press the <keysym>Win</keysym> key. Look in the output of +<command>xev</command> for +<computeroutput>keycode <replaceable>n</replaceable></computeroutput>, +where <replaceable>n</replaceable> is the keycode of the +<keysym>Win</keysym> key.</para> +</listitem> + +<listitem><para>Use <command>xmodmap</command> to remap the +<keysym>Win</keysym> key. An appropriate command is <userinput><command>xmodmap +<option>-e</option> 'keycode +<replaceable>n</replaceable>=Menu'</command></userinput>.</para> +</listitem> + +<listitem><para>In the &kcontrolcenter;, go to +<menuchoice><guimenu>Regional & +Accessibility</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem> +</menuchoice> and set the shortcut for <guilabel>Popup Launch +Menu</guilabel> to the <keysym>Win</keysym> key. You should now be +able to popup the &kmenu; by pressing the <keysym>Win</keysym> key.</para> +</listitem> + +<listitem><para>One more step is required to save the changes across +settings: Create a file <filename>~/.trinity/env/win-key.sh</filename> +(create the directory if it doesn't exist), and add the +<command>xmodmap</command> command you used previously to it. The +change should now be applied every time you start &tde;.</para> +</listitem> +</orderedlist> +</para> +</answer> +</qandaentry> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/qt.docbook b/doc/khelpcenter/faq/qt.docbook new file mode 100644 index 000000000..1254ec77e --- /dev/null +++ b/doc/khelpcenter/faq/qt.docbook @@ -0,0 +1,105 @@ +<chapter id="licensing"> +<title>&Qt; and Licensing questions</title> + +<qandaset> + +<qandaentry> +<question id="qt"> +<para>What is &Qt;, by the way?</para> +</question> +<answer> +<para>&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 &tde; application: +menus, buttons, sliders, &etc; &Qt; is a cross-platform library that +allows developers to write code that will compile on &UNIX; systems as well as +&Windows; and embedded devices. Learn more about &Qt; at <ulink +url="http://www.trolltech.com">http://www.trolltech.com</ulink>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Why does &tde; use &Qt;?</para> +</question> +<answer> +<para>&Qt; is a sophisticated toolkit that provides everything that +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 &tde;. 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 &tde; on anything but +the best.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Why does &tde; not use gtk, xforms, xlib, whatever?</para> +</question> +<answer> +<para>There are a number of toolkits available. To provide a +consistent user interface and to keep used resources such as memory to +a minimum, &tde; can use only one of them. &Qt; was selected for the +reasons mentioned above.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>But &Qt; isn't free, is it?</para> +</question> +<answer> +<para>&Qt; is free/libre. Since September 4, 2000, version 2.2 of the &Qt; +libraries are licensed under the <acronym>GPL</acronym>, thereby +fulfiling all aspects of <quote>free/libre software</quote>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Can I write commercial software for &tde;?</para> +</question> +<answer> +<para>You can use the &tde; libraries to write <quote>commercial and +closed source</quote> as well as <quote>commercial and open +source</quote> software. If you write open source software you can +use the &Qt; free edition. 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. For more information, please +contact <ulink url="http://www.trolltech.com">Troll Tech</ulink> directly.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Isn't Qt3 obsolete and "dead" technology?</para> +</question> +<answer> +<para>The definition for "obsolete" varies based upon who applies the term. +Generally the term "obsolete" means something no longer is useful or no longer +needed. In software circles the term often means antiquated or no longer shiny. +Usefulness often is not part of the intended meaning of the word. The term is +used as an emotional wedge more than a factual observation.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Are there plans to migrate &tde; to Qt4 or Qt5?</para> +</question> +<answer> +<para>There are no such plans. Porting Trinity to Qt4 is 5 to 10 years of solid work with current project manpower. Indeed, the KDE4 team of developers needed several years to port KDE and they have many more developers.</para> + +<para>A fundamental project goal for maintaining Trinity is to keep alive the spirit and functionality of the original KDE3 concepts. Porting to Qt4 does not support that goal. Qt4 functionality is different from Qt3 (now TQt). Those differences conflict with how users want Trinity to function. The Qt4 environment is too different in focus and functionality to be used as the base toolkit of Trinity.</para> + +<para>The idea of integrating certain portions of the Qt4 code has not been abandoned. One of the original reasons for the TQt interface layer was to keep open the possibility of adapting portions of Trinity to Qt4. That has already been done. For example, with the qt4-tqt-theme-engine package for Trinity.</para> + +<para>More information about the philosophical and design differences between Trinity and KDE4 are available in <xref linkend="trinity-vs-kde4"/> of the FAQ introduction.</para> +</answer> +</qandaentry> + + +</qandaset> +</chapter>
\ No newline at end of file diff --git a/doc/khelpcenter/faq/questions.docbook b/doc/khelpcenter/faq/questions.docbook new file mode 100644 index 000000000..b24bfa320 --- /dev/null +++ b/doc/khelpcenter/faq/questions.docbook @@ -0,0 +1,137 @@ + +<chapter id="questions"> + +<title>Asking Questions</title> + +<para>To get an appropriate answer to questions requires asking a clear +question in a manner that motivates people to help. Writing questions that +appear to be rude, lazy, or uses bad or unclear language likely will result +in your question being ignored.</para> + +<qandaset> +<qandaentry> + +<question><para>What do I do before I ask?</para></question> + +<answer><para>Read the documentation and &FAQ; for the application. There is +a wealth of &tde; documentation availible both in the help center and +online. A lot of time and effort has gone into this documentation, and +often the answer to your question is there. The general &tde; userguide +can be found by typing <userinput><command>help:/khelpcenter/userguide</command></userinput> +into the &konqueror; address bar or <userinput><command> +khelpcenter help:/khelpcenter/userguide with the minicli</command></userinput>.</para> + +<para>Search the web: Usually searching for a specific error message or +searching mailing list archives will find a solution.</para> + +<para>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. As long as you +use common sense you are unlikely to break anything by experimenting.</para> + +<para>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.</para> </answer> +</qandaentry> + +<qandaentry> +<question><para>Where do I ask?</para></question> + +<answer><para>Usually the best place to ask a question is on the +<acronym>IRC</acronym> channels and mailing lists devoted to user +questions. Don't post simple questions about using &tde; to the devel +channels and mailing lists, these are for technical discussions. Some good +places are chat.freenode.net, channel: #trinity-desktop, and the &tde; <ulink +url="http://www.trinitydesktop.org/mailinglist.php">mailing +lists</ulink>. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How do I ask?</para></question> + +<answer><para>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!</para> + +<para>Q: &tde; sucks, it's slow</para> + +<para>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.</para> + +<para>Q: Since updating &tde; on Slackware &Linux; using sources, I have +noticed it's being really slow — sometimes +applications take up to 20 seconds to launch. I am using the same user +configuration as I had with the previous version. I have tried as a new +user. I can't find anything about this on the mailing lists or by a web +search. Could anyone point me to some information that could help?</para> + +<para>This question is polite, contains information to help people +troubleshoot the problem and shows your helpers what avenues you have +already tried.</para> + +<para>Don't presume automatically that the problem is the fault of +&tde;. Otherwise you likely will annoy people.</para> + +<para>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. &tde; is a +project where many of the users and developers are not native english +speakers and if you don't use correct english, misunderstandings might +ensue. Be patient. 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 might +ignore your message because it is not in a language they understand.</para> + +<para>Include all information that could be relevant, even when you're not +sure. Have you updated other software or hardware on your system, +particularly system libraries or a new kernel? These things could affect how +&tde; performs. Even when you cannot see a connecting cause, someone else might.</para> + +<para>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 +<acronym>IRC</acronym> channel. Use an online paste service. If you +must type the messages by hand, be sure you are accurate. When you provide +faulty information, your helpers cannot help you as easily.</para> + +<para>Follow through on your solution! Tell people when the solution worked, or when you have +solved the problem yourself. This helps everybody involved know when +solutions work and helps other users who might be searching for a similar +solution to the problem.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>What do I do when told to look elsewhere?</para></question> + +<answer><para>Possibly you have not followed the above +advice. You've not done your research, and the solution probably is one the +helper knows very well to be easy to find. When provided a web link to an +<acronym>FAQ</acronym> or documentation don't say, <quote>No, I don't +want to have to read this I want you to just tell me</quote>. That response +is considered bad manners. People who don't provide effort to learn often +find others have little incentive to help.</para> +</answer> +</qandaentry> +</qandaset> + +<para>Use common courtesy. &tde; users and developers volunteer their time +out of an already very busy schedule, and like to +know that you are appreciating they are helping you for free. Be +polite, say please and thank you, be constructive, and try to be pleasant and +friendly.</para> + +<para> 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 +&tde; 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. :-)</para> + +<para>If you think the answer to your question should be included in the +&tde; &FAQ; please feel free to submit any patches or suggestions to the +&tde; &FAQ; Maintainer, at <email>trinity-devel@lists.pearsoncomputing.net</email></para> + +</chapter> diff --git a/doc/khelpcenter/faq/sound.docbook b/doc/khelpcenter/faq/sound.docbook new file mode 100644 index 000000000..feaaf6651 --- /dev/null +++ b/doc/khelpcenter/faq/sound.docbook @@ -0,0 +1,53 @@ +<chapter id="sound"> +<title>Troubleshooting sound problems</title> + +<para>&tde; 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 :</para> + +<qandaset> +<qandaentry> +<question> +<para>How can I troubleshoot sound related problems in &tde;?</para> +</question> + +<answer><para> To check that sound is working independently of &arts;, make +sure that <command>artsd</command> isn't running and then try playing sound +through <application>XMMS</application> or another multimedia application +that isn't a part of &tde;. If that application doesn't play sound, then +your general sound setup is probably broken and it's not a &tde; +problem.</para> + +<para>Try playing sound with +<userinput><command>artsplay</command><option><replaceable> +/path/to/some/soundfile</replaceable></option></userinput>. Try various +formats, ogg, mp3 and wav. Any error messages there might be useful in +pointing you in the right direction.</para> + +<para>Try setting the &arts; output method to <acronym>OSS</acronym>. In the +&kcontrolcenter; go to <menuchoice><guimenu>Sound & Multimedia</guimenu> +<guimenuitem>Sound System</guimenuitem></menuchoice>. On the +<guilabel>Hardware</guilabel> tab, under <guilabel>Select the audio +device</guilabel> choose <guilabel>Open Sound System</guilabel>. If you are +running <acronym>alsa</acronym> this will use the <acronym>OSS</acronym> +emulation, which may give better or worse results.</para> + +<para>Running <userinput><command>artsd</command><option> -l +0</option></userinput> 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 <command>artsplay</command> in a second terminal can give a wealth of information. If an <application>artsd</application> instance is already running, exit it with <userinput><command>artsshell +</command><parameter>terminate</parameter></userinput></para> +</answer> +</qandaentry> +<qandaentry> +<question><para> +I've updated to the latest version of &tde; keeping my previous configuration and my system sounds don't work anymore!</para></question> +<answer><para> +Assuming you've installed &arts; correctly and you still have the codecs installed your previous &tde; installation needed, possibly there is a problem with your <filename>knotifyrc</filename>. To confirm this, try temporarily +renaming the file. A new one will be created when starting &tde;. +</para></answer> +</qandaentry> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/tdeapps.docbook b/doc/khelpcenter/faq/tdeapps.docbook new file mode 100644 index 000000000..441759054 --- /dev/null +++ b/doc/khelpcenter/faq/tdeapps.docbook @@ -0,0 +1,158 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="applications"> +<title>&tde; applications</title> + +<qandaset> +<qandaentry> +<question> +<para>&kppp;</para> +</question> +<answer> + +<para>Many &tde; users report problems using &kppp;. Make sure you have already checked the +following:</para> + +<itemizedlist> +<listitem><para>Can you dialup to your <acronym>ISP</acronym> without using &kppp;? If you cannot, then perhaps &kppp; is not the culprit after +all.</para></listitem> +<listitem><para>Have you gone through the &kppp; documentation +and followed the instructions and troubleshooting +suggestions?</para></listitem> +</itemizedlist> +<para>The <ulink url="help:/kppp">&kppp; handbook</ulink> is available through the +<application>&tde; Help Center</application>.</para> +<para>If you still encounter problems, then the following might help:</para> +<variablelist> +<varlistentry><term>How do I change the &MTU; setting in &kppp;?</term> +<listitem><para>Open up the &kppp; dialog box and select +<guibutton>Setup</guibutton>. Choose an existing account and click +<guibutton>Edit</guibutton>, or <guibutton>New</guibutton> to create a +new dialup account. Select the <guilabel>Dial</guilabel> tab and +click <guibutton>Arguments</guibutton>. Type what you want to change +in the Argument textbox (⪚ <userinput>mtu 296</userinput>) and +click <guibutton>Add</guibutton>. When you are satisfied, click +<guibutton>Close</guibutton>.</para> +<para>To check whether the options <quote>took</quote>, do one of the following:</para> +<itemizedlist> +<listitem> +<para>In a terminal window, run +<userinput><command>/sbin/ifconfig</command> ppp0</userinput> and look +at the reported &MTU; in the output. It should match your +request.</para> +</listitem> +<listitem><para>Add <option>debug</option> and <option>kdebug</option> +(each on a separate line) to your +<filename>/etc/ppp/options</filename> file and restart your +&PPP; session. You will find debugging messages in +<filename>/var/log/messages</filename>, including &MRU; and &MTU; +settings.</para></listitem> +</itemizedlist> +<para>If you want, the &MRU; and &MTU; settings can be added to the +<filename>options</filename> file, one complete setting per line, no +quotes or dashes.</para></listitem> +</varlistentry> +<varlistentry> +<term>&kppp; connects at a slower speed than +normal.</term> +<listitem><para>The following might do the trick:</para> +<itemizedlist> +<listitem><para>Try executing <command>setserial +spd_hi</command>.</para></listitem> +<listitem><para>The default &MTU; value is 1500, +which maybe too large +for a dialup connection. Try changing it to a smaller value like +<userinput>296</userinput> +or <userinput>576</userinput>.</para></listitem> +<listitem><para>Check in your <filename +class="directory">$<envar>HOME</envar>/.trinity/share/config</filename> for the +<filename>kppprc</filename>. Ensure the correct modem speed is +actually defined there.</para></listitem> +</itemizedlist></listitem> +</varlistentry> +</variablelist> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>&konsole;</para> +</question> +<answer> +<variablelist> + +<varlistentry> +<term>How do I page-up or page-down?</term> +<listitem><para>Use <keycombo action="simul"> +<keycap>Shift</keycap><keycap>Page Up</keycap></keycombo> +and <keycombo action="simul"><keycap>Shift</keycap><keycap>Pg +Dn</keycap></keycombo>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>How do I copy text from &konsole; to +anything else?</term> +<listitem><para>Use the mouse to select the desired text. From the +<guimenu>Edit</guimenu> menu, select <guimenuitem>Copy</guimenuitem>, or press +<keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo>. This places +the text in the &tde; clipboard, &klipper;. Next select +the target application, place the mouse pointer to the +desired location and press <keycombo +action="simul">&Ctrl;<keycap>V</keycap></keycombo>. +Alternately, 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). +</para><note><para>Note that the copying and pasting keyboard shortcuts use the +<keycap>&Shift;</keycap> key. That is because in traditional Unix terminals, +<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> is used to break or stop +a process from running.</para></note></listitem> +</varlistentry> + +<varlistentry> +<term>Why can't &konsole; find the <quote>9x15</quote> and the 2 +<quote>console</quote> bitmap fonts installed with &tde;?</term> +<listitem> + +<para><application>FontConfig</application> must find the three fonts +installed in: <filename +class="directory">$<envar>TDEDIR</envar>/share/fonts</filename>. + If +the &tde; install does not install these fonts in a directory that +already exists (⪚ <filename +class="directory">/usr/share/fonts</filename>) then you must add this +directory to the configuration file <filename +class="directory">/etc/fonts/local.conf</filename>. This should be +the first line after <quote><fontconfig></quote>. For example: +<programlisting> +<fontconfig> +<dir>/usr/trinity/share/fonts</dir> +</fontconfig> +</programlisting> +After adding the directory, run (as root): +<userinput><command>fc-cache</command> -v</userinput> and check that +it found the directory.</para> +</listitem> +</varlistentry> + +</variablelist> +</answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>&kmail;</para> +</question> +<answer> +<para>&kmail; has its own home page at <ulink +url="http://kmail.kde.org">http://kmail.kde.org</ulink> where an +<acronym>FAQ</acronym> is available.</para> +</answer> +</qandaentry>--> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/tips.docbook b/doc/khelpcenter/faq/tips.docbook new file mode 100644 index 000000000..89c324be3 --- /dev/null +++ b/doc/khelpcenter/faq/tips.docbook @@ -0,0 +1,131 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="tips"> +<title>Useful tips</title> + +<qandaset> +<qandaentry> +<question> +<para>Reading documentation in &tde;</para> +</question> +<answer> +<para>Pop up the <guilabel>Run Command</guilabel> window (<keycombo +action="simul">&Alt;<keycap>F2</keycap></keycombo> by +default) and type: +<itemizedlist> +<listitem> +<para><command>man:<replaceable>command</replaceable></command> for man pages. It +even unpacks on the fly if the man pages are gzipped.</para> +</listitem> + +<listitem> +<para><command>info:<replaceable>command</replaceable></command> for info +pages.</para> +</listitem> + +<listitem> +<para><command>help:<replaceable>kdeappname</replaceable></command> for &tde; +application help pages.</para> +</listitem> + +</itemizedlist> +</para> + +<para>You can enter any of these in the <guilabel>Location</guilabel> text +box in &konqueror;.</para> +<para>Uou can use the <application>&tde; Help Center</application>. Start the <application>&tde; Help Center</application> by selecting <guimenuitem>Help</guimenuitem> from the <guimenu>TDE menu</guimenu>. Once the <application>&tde; Help Center</application> has loaded, the window on the left will contain an entry called +<guilabel>Unix manual pages</guilabel>. Select that entry to browse through all the installed manual pages on your +system.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Move or resize windows quickly</para> +</question> +<answer> +<para>To move a window, use <keycombo +action="simul">&Alt;<mousebutton>left</mousebutton></keycombo> mouse +button. <keycombo +action="simul">&Alt;<mousebutton>right</mousebutton></keycombo> mouse +button will resize the window. Last but not least, <keycombo +action="simul">&Alt;<mousebutton>middle</mousebutton></keycombo> mouse button +raises/lowers the window. The <application>&tde; Control Center</application> +allows you to change these mouse bindings. Please refer to <ulink url="help:/khelpcenter/userguide/windows-how-to-work.html"> +Windows, How To Work Them</ulink> in the Trinity user guide for more information.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Killing windows in &tde;</para> +</question> +<answer> +<para>There is a standard keybinding (<keycombo +action="simul">&Ctrl;&Alt;&Esc;</keycombo>) +that changes the mouse pointer to a skull & crossbones cursor. Click that cursor on a +window to kill it. The keybindings are viewable/changeable from the +<application>&tde; Control Center</application>. + +<caution><para>Using this option kills the program forcibly. Data might be lost, +and some processes related to the program might remain active. Use only as a +last resort.</para></caution> +<!-- fixme: use only if necessary; processes might remain --></para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>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?</para> +</question> +<answer> +<para>These kind of locks tend to occur when an application locks up +while it has a so called <quote>mouse/keyboard grab</quote>. When that +happens you can try to select a virtual text console with <keycombo +action="simul">&Ctrl;&Alt;<keycap>F1</keycap></keycombo> and login. With the +following command you will get a list of all running processes:</para> + +<screen><userinput> <command>ps</command> <option>-aux</option> | <command>more</command></userinput></screen> + +<para>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:</para> + +<screen><userinput> <command>kill</command> <option>-9</option> <replaceable>pid</replaceable></userinput></screen> + +<para>Here <replaceable>pid</replaceable> is the process id of the +process, which is the first number on each line reported by +<command>ps</command> <option>-aux</option>.</para> + +<para>You can switch back to the desktop with <keycombo +action="simul">&Ctrl;&Alt;<keycap>F7</keycap></keycombo> (or +<keycap>F8</keycap> through <keycap>F9</keycap> depending on your +operating system) to see if things work again. When you press +<keycombo action="simul">&Alt;<keycap>Tab</keycap></keycombo> 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.</para> +</answer> +</qandaentry> + +<!-- fixme: how to do in KDE2.x +<qandaentry> +<question> +<para>Switching window managers on the fly in &tde; 1.x</para> +</question> +<answer> +<para>If you want to switch your window manager on the fly, type the +following into a terminal window: <command>kwmcom +go:<replaceable>blackbox</replaceable></command>. This switches to +Blackbox, but you can substitute any window manager you like.</para> +</answer> +</qandaentry> +--> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/webbrowse.docbook b/doc/khelpcenter/faq/webbrowse.docbook new file mode 100644 index 000000000..b466eb0d8 --- /dev/null +++ b/doc/khelpcenter/faq/webbrowse.docbook @@ -0,0 +1,217 @@ +<!-- <?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> --> + +<chapter id="webbrowser"> +<title>Webbrowsing with &konqueror;</title> +<para>&konqueror; is &tde;'s default web browser. Please refer to +the <ulink url="help:/konqueror/index.html"> +Konqueror Handbook</ulink> for detailed information.</para> + +<qandaset> + +<qandaentry> +<question><para>Where does the name &konqueror; come from?</para></question> +<answer><para>It's a word play on the other browsers' names. After the Navigator +and the Explorer comes the Conqueror.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>Can I run &konqueror; without running &tde;?</para></question> +<answer><para>Yes. Install &Qt;, tdelibs, and tdebase. From your window manager launch &konqueror;. It should work just fine, but if it doesn't (&tde; developers don't often test that use case), report the problem to <ulink +url="http://bugs.trinitydesktop.org/">http://bugs.trinitydesktop.org/</ulink>. Before reporting a bug, try running "tdeinit" before running &konqueror;. This is of course the same for any other &tde; application running in +a non &tde; setup.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>Why doesn't &konqueror; show the contents of an image's <sgmltag class="attribute">ALT</sgmltag> attribute in a tooltip?</para></question> +<answer><para> +There is no standard that states the <sgmltag class="attribute">ALT</sgmltag> attribute should appear as a tooltip. The specification calls for <sgmltag class="attribute">ALT</sgmltag> to be displayed in place of the image, as in text-mode only browsers such at lynx or w3m. Abusing the <sgmltag class="attribute">ALT</sgmltag> attribute is bad for accessibility. Tooltips are supposed to come from the <sgmltag class="attribute">TITLE</sgmltag> attribute and this is implemented in &konqueror;. +</para></answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I use &konqueror; as a web browser with a proxy?</para> +</question> +<answer> +<para>&konqueror; can be used with &HTTP; and &FTP; proxies. To set +up the proxy server in &konqueror;, select +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice> from the &konqueror; menu and +select the <guilabel>Proxy</guilabel> option.</para> +</answer> +</qandaentry> + +<qandaentry> +<question id="nsbookmark"> +<para>How do I import bookmarks from another browser into &konqueror; ?</para> +</question> +<answer> +<para>To import bookmarks from another browser into &konqueror;, from the menu +bar select <guimenu>Bookmarks</guimenu>, then select <guimenuitem>Edit Bookmarks</guimenuitem>. +In the <application>Bookmark Editor</application>, select +<guimenu>File</guimenu> then select <guimenuitem>Import</guimenuitem>. Select +the browser from which you would like to import bookmarks. In the Open dialog, +navigate to the location of the folder or file your bookmarks are +located. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para>How can I make &konqueror; only show certain bookmarks in the bookmarks toolbar?</para></question> +<answer><para>In &konqueror; select <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice>. Then select <guilabel>Web Behaviour</guilabel> from the icon list. Under the <guilabel>Bookmarks</guilabel> heading, place a check in the box next to <guilabel>Show only marked bookmarks in bookmark toolbar</guilabel>.</para> +<para>In the <application>Bookmark Editor</application> an option to <guilabel>Show in Toolbar</guilabel> appears on clicking with the &RMB; on any bookmark entry or in the <guimenu>Edit</guimenu> menu when the entry is highlighted. Folders can also be shown in the bookmarks toolbar in much the same way.</para></answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I fool a site into believing &konqueror; is &Netscape; or +some other browser?</para> +</question> +<answer> +<para>That is called setting the user agent. In &konqueror;, select +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice>. In the icon list, select +<guilabel>Browser Identification</guilabel>. Default +and site-specific browser identifications can be set there.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>&konqueror; is taking a really long time to load web pages -- mdash; what +could cause this?</para></question> +<answer> +<para>Quite often &konqueror; loading web pages slowly is caused by +<acronym>DNS</acronym> servers with broken <acronym>IPV6</acronym> +support. Adding the following to <filename>/etc/profile</filename> or any +other script that is sourced on login should solve this problem: +<screen> +export TDE_NO_IPV6=true +</screen> +for bourne compatible shells, and for C-style shells: +<screen> +setenv TDE_NO_IPV6 true +</screen> +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I configure &konqueror; to run &Java; applets?</para> +</question> +<answer> +<para>From &konqueror;'s menubar choose +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice>. +From the icon list select <guilabel>Java & Javascript</guilabel>. Set the +<guilabel>Path to Java executable</guilabel>.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I block unrequested popup windows in &konqueror;?</para> +</question> +<answer> +<para>&konqueror; provides a 'smart' policy for JavaScript popups. From the +&konqueror; main window, select<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice>. Then +<guilabel>Java & JavaScript</guilabel>. On the +<guilabel>JavaScript</guilabel> tab, under <guilabel>Global JavaScript +Policies</guilabel>, set the radio button beside <guilabel>Open new +windows:</guilabel> to <guilabel>Smart</guilabel>. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>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;.</para> +</question> +<answer> +<para> +Make sure you have Javascript enabled, and the default JavaScript web popups +policy set to <guilabel>Ask</guilabel> or <guilabel>Allow</guilabel>. The +<guilabel>Smart</guilabel> policy is not always sufficient for some banks. +Many banks also require &Java; support. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Can &konqueror; use user-specified stylesheets, like those in the +Firefox adblock extension?</para> +</question> +<answer> +<para>Yes, you can set &konqueror; to use any kind of valid +<acronym>css</acronym> stylesheet to filter webcontent or improve accessibility. +From the &konqueror; main window simply click +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice> and select +<guilabel>Stylesheets</guilabel>. Set the radio button to +<guilabel>Use user-defined stylesheet</guilabel> and browse to where the +stylesheet you want to use is located. Alternately, select +<guilabel>Use accessibility stylesheet defined in "Customize" +tab</guilabel> and then set your own options.</para> +</answer> +</qandaentry> + +<qandaentry> +<question><para> +Why does &konqueror; display a plain grey square when I try to view flash animations, even though the flash plugin is installed? +</para></question> +<answer><para> +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 whether normal flash operation is restored. +</para></answer> +</qandaentry> + +<!--<qandaentry> +<question> +<para>Why can't &konqueror; render &GIF; images?</para> +</question> +<answer> +<para>It is because you did not enable &GIF; support in &Qt;. Please see +<xref linkend="gif"/> for more details.</para> +</answer> +</qandaentry>--> + +<qandaentry> +<question><para>When I try to open a web page with &konqueror;, I get the +message: <quote>There appears to be a configuration error. You have +associated Konqueror with text/html, but it cannot handle this file +type.</quote></para> +</question> +<answer> +<para>Make sure the embedding settings for the text/html +<acronym>MIME</acronym> type are correct: +<orderedlist> +<listitem><para>In &konqueror;, go to +<menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure +&konqueror;...</guisubmenu></menuchoice>. In the icon list select <guilabel>File +Associations</guilabel>.</para> +</listitem> +<listitem><para>Open +text->html in the tree view.</para> +</listitem> +<listitem><para>Click on the +<guilabel>Embedding</guilabel> tab. Make sure that <guilabel>Left Click +Action</guilabel> is set to <guilabel>Show file in embedded +viewer</guilabel>, and that <guilabel>TDEHTML (tdehtml)</guilabel> is at the top +of <guilabel>Services Preference Order</guilabel>.</para></listitem> +</orderedlist> +</para> +</answer> +</qandaentry> + +</qandaset> +</chapter> diff --git a/doc/khelpcenter/faq/winmng.docbook b/doc/khelpcenter/faq/winmng.docbook new file mode 100644 index 000000000..dd79018bc --- /dev/null +++ b/doc/khelpcenter/faq/winmng.docbook @@ -0,0 +1,133 @@ +<!-- +<?xml version="1.0" ?> +<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" + "dtd/kdex.dtd"> +--> + +<chapter id="windowmanager"> +<title>The window manager</title> + +<para>The default window manager provided by &tde; is the Trinity Window +Manager (&twin;). Please refer to <ulink url="help:/khelpcenter/userguide/windows-how-to-work.html"> +Windows, How To Work Them</ulink> in the Trinity user guide for more information.</para> + +<qandaset> +<qandaentry> +<question> +<para>Are there keyboard shortcuts for &twin; operations?</para> +</question> +<answer> +<para>Yes. Please use to the Trinity Control Center (&kcontrol;), +<menuchoice><guimenu>Regional & Accessibility</guimenu><guimenuitem> +Keyboard Shortcuts</guimenuitem></menuchoice>, for the +list of available shortcuts.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>Can I define my own set of keyboard shortcuts?</para> +</question> +<answer> +<para>Yes. Launch the +<application>&tde; Control Center</application> and select +<menuchoice><guimenu>Regional & Accessibility</guimenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice> to +configure window manager bindings like maximizing windows, &etc;. +</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>When I "iconify" a window, it disappears. Where does it +go?</para> +</question> +<answer> +<para>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. &tde; does not do this. Instead, when a +window is iconified it is simply hidden (but the program is still +running).</para> +<para>There are a few ways to access <quote>disappeared</quote> windows:</para> +<itemizedlist> +<listitem> +<para>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.</para> +</listitem> +<listitem> +<para>If you click the &MMB; on the root window (&ie;, +the background of the desktop), &twin; will give you a list +of all available tasks.</para> +</listitem> +</itemizedlist> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>How do I maximize windows only vertically or horizontally?</para> +</question> +<answer> +<para>Provided your window is not already maximized, clicking on the +maximize button with the &LMB;/&MMB;/&RMB; will +maximize fully/vertically/horizontally respectively.</para> +</answer> +</qandaentry> + +<qandaentry> +<question> +<para>What is <quote>shading</quote> a window?</para> +</question> +<answer> +<para>By <quote>shading</quote> a window we mean <quote>rolling up</quote> the window leaving just +the title bar visible. You can do this by double clicking on the +window title bar.</para> +</answer> +</qandaentry> + +<!-- This is kinda covered in desktop.docbook, but the question here --> +<!-- is different, even if the answer is nearly the same --> +<qandaentry> +<question> +<para>How can I start an application with special window options, like +maximized/minimized/to stay on top?</para> +</question> +<answer> +<para>Use the <command>kstart</command> command. As an example, to +open &kcalc; with the <quote>Stay on Top</quote> option, use: +<screen><prompt>%</prompt> <userinput><command>kstart</command> <option>--ontop</option> <option>kcalc</option></userinput></screen> +</para> +<para>For maximized windows, use the <option>--maximize</option> +option, for minimized windows, use <option>--iconify</option>. You can +see a full list of <command>kstart</command> options with +<userinput><command>kstart</command> +<option>--help-all</option></userinput>.</para> + +<warning><para>If you're using <command>kstart</command> to start +applications at &tde; startup, you should use the +<option>--window</option> option. See the &tde; User Guide, section +<quote>Advanced Window Management</quote> for more information about +this feature.</para> +</warning> + +</answer> +</qandaentry> + +<!-- Not sure this is still applicable +<qandaentry> +<question> +<para>Is it possible to have FVWM2-like shadow frameworks for the +placement of windows?</para> +</question> +<answer> +<para>Yes. Run <application>&tde; Control Center</application> and select <guimenu>Look and Feel</guimenu> +followed by <guisubmenu>Window Behavior</guisubmenu> and finally +<guimenuitem>Advanced</guimenuitem>. There is a dialog option that +allows you to set the placement policy you want.</para> +</answer> +</qandaentry> +--> +</qandaset> +</chapter> + |