Update Help center: Reorganize TOC, rename files; initial update of FAQ,

Welcome, Quick Start guides; numerous revisions.

1 files changed, 250 insertions, 0 deletions

diff --git a/doc/faq/configtde.docbook b/doc/faq/configtde.docbook
new file mode 100644
index 000000000..8f687f69b
--- /dev/null
+++ b/doc/faq/configtde.docbook
@@ -0,0 +1,250 @@
+<!--
+<?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>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>Fire up the <application>&tde; Control Center</application> and select
+<guimenu>Regional &amp; Accessibility</guimenu> followed by
+<guimenuitem>Country/Region &amp; 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, you can configure it using the <application>&tde; Control Center</application>
+<guimenu>Regional &amp; Accessibility</guimenu>
+<guimenuitem>Keyboard Layout</guimenuitem>
+ 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 distribution/&UNIX; flavor may have its own setup tools to
+change this (&eg; <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 may be useful.</para></note>
+<para>First, you need to change to the <quote>xdm runlevel</quote> (runlevel 5 on
+&RedHat; and &SuSE; systems) by editing your
+<filename>/etc/inittab</filename> file.  In the file, you should have
+a line saying <userinput>id:3:initdefault:</userinput>.  Change it to
+<userinput>id:5:initdefault:</userinput>.  Now, 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/kde/</replaceable>bin/tdm
+-nodaemon</userinput>.
+<note><para>The location of &tdm; may 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>K</guimenu> menu displayed.</para>
+</question>
+<answer>
+<para>Open the <application>&tde; Control Center</application> and
+choose <menuchoice><guisubmenu>Desktop</guisubmenu>
+<guisubmenu>Behavior</guisubmenu></menuchoice>.  You
+can now choose the behavior of mouse clicks on the desktop.  To have
+the <guimenu>K</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 information regarding &tde; themes?</para>
+</question>
+<answer>
+<para>Go to <ulink
+url="http://kde.themes.org/">http://kde.themes.org/</ulink> or <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>If you are using &konqueror;, do this instead: first, open a
+&konqueror; window and choose
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+Konqueror</guimenuitem></menuchoice>, then <guilabel>File Associations</guilabel>.  Find the type you want to change
+(&eg; <literal>text/english</literal> or
+<literal>image/gif</literal>), and set the application preference order
+to whatever you want.</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.  So 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>You need to 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>XF86Config</filename> file to get the
+fonts from the font folder.  Then just tell &tde; to use these new
+fonts with the font administrator 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 and no.  For details, look here: <ulink
+url="http://www.koffice.org/kword/euro.php">http://www.koffice.org/kword/euro.php</ulink>.</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>How do I run a program at &tde; startup?</para></question>
+
+<answer><para>There are many ways to do that. If what you want to do
+is to run some scripts that would set some environment variables (for
+example, to start <command>gpg-agent</command>, <command>ssh-agent</command> and others), you can put
+these scripts into <filename class="directory">$<envar>TDEHOME</envar>/env/</filename> and make sure their names end in
+<literal role="extension">.sh</literal>. $<envar>TDEHOME</envar> is
+usually a folder named <filename class="directory">.kde</filename>
+(note 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; was
+installed to (you can find this out using the command
+<userinput><command>tde-config</command> --prefix</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>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>) you
+need to tell the program that logs you in that it can use 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">Specifying permanent &X-Server;s</ulink>.
+After modifying tdmrc, you will have to let &tdm; know about it; just
+invoke <command>killall -HUP tdm</command>.</para>
+</answer>
+</qandaentry>
+</qandaset>
+</chapter>