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

Welcome, Quick Start guides; numerous revisions.

1 files changed, 158 insertions, 0 deletions

diff --git a/doc/faq/tdeapps.docbook b/doc/faq/tdeapps.docbook
new file mode 100644
index 000000000..e10a452e7
--- /dev/null
+++ b/doc/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;.  But before you
+complain about &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 at
+least three times and followed its instructions and trouble-shooting
+suggestions?</para></listitem>
+</itemizedlist>
+<para>The &kppp; documentation can be accessed through the 
+<application>&tde; Help Center</application>.
+ Last, but not least, the &kppp; homepage is at <ulink
+ url="http://ktown.kde.org/~kppp/">http://ktown.kde.org/~kppp/</ulink>.</para>
+<para>Now, if you still encounter problems, here's what might help you
+solve them:</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 (&eg; <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>/.kde/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 perform a simple <quote>copy</quote> from &konsole; to
+anything else?</term>
+<listitem><para>When I do a <command>ls</command>, first I select with
+the mouse the desired text, press 
+<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>,
+then I make the target application active, point the mouse to the
+relevant part and press <keycombo
+action="simul">&Ctrl;<keycap>V</keycap></keycombo>.
+Alternatively, highlight the text by dragging with the &LMB; down and
+paste by clicking with the &MMB; (or both buttons if you are using a
+2 button mouse with 3 button emulation).
+</para></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 (&eg; <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>&lt;fontconfig&gt;</quote>.  For example:
+<programlisting>
+&lt;fontconfig&gt;
+&lt;dir&gt;/usr/trinity/share/fonts&lt;/dir&gt;
+&lt;/fontconfig&gt;
+</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>