1 files changed, 582 insertions, 0 deletions
diff --git a/doc/khelpcenter/userguide/index.docbook b/doc/khelpcenter/userguide/index.docbook
new file mode 100644
index 000000000..2ffdc84f5
--- /dev/null
+++ b/doc/khelpcenter/userguide/index.docbook
@@ -0,0 +1,582 @@
+<?xml version="1.0" ?>
+  <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kappname "<replaceable>KApp</replaceable>">
+  <!ENTITY % addindex "INCLUDE">
+  <!ENTITY % imageobjectco.module "INCLUDE">
+  <!ENTITY getting-help SYSTEM "getting-help.docbook">
+  <!ENTITY programs-controlling SYSTEM "programs-controlling.docbook">
+  <!ENTITY troubleshooting-no-open SYSTEM "troubleshooting-no-open.docbook">
+  <!ENTITY troubleshooting-network-x SYSTEM "troubleshooting-network-x.docbook">
+  <!ENTITY windows-how-to SYSTEM "windows-how-to.docbook">
+  <!ENTITY the-filemanager SYSTEM "the-filemanager.docbook">
+  <!ENTITY panel-and-desktop SYSTEM "panel-and-desktop.docbook">
+  <!ENTITY programs-and-documents SYSTEM "programs-and-documents.docbook">
+  <!ENTITY control-center SYSTEM "control-center.docbook">
+  <!ENTITY customizing-desktop SYSTEM "customizing-desktop.docbook">
+  <!ENTITY base-tde-applications SYSTEM "base-tde-applications.docbook">
+  <!ENTITY removable-disks SYSTEM "removable-disks.docbook">
+  <!ENTITY burning-cds SYSTEM "burning-cds.docbook">
+  <!ENTITY playing-music SYSTEM "playing-music.docbook">
+  <!ENTITY playing-audiocds SYSTEM "playing-audiocds.docbook">
+  <!ENTITY playing-movies SYSTEM "playing-movies.docbook">
+  <!ENTITY your-tde-account SYSTEM "your-tde-account.docbook">
+  <!ENTITY tde-as-root SYSTEM "tde-as-root.docbook">
+  <!ENTITY switching-sessions SYSTEM "switching-sessions.docbook">
+  <!ENTITY file-sharing SYSTEM "file-sharing.docbook">
+  <!ENTITY networking-with-windows SYSTEM  "networking-with-windows.docbook">
+  <!ENTITY shared-sessions SYSTEM "shared-sessions.docbook">
+  <!ENTITY printer-setup SYSTEM "printer-setup.docbook">
+  <!ENTITY printing-from-apps SYSTEM "printing-from-apps.docbook">
+  <!ENTITY pdf-files SYSTEM "pdf-files.docbook">
+  <!ENTITY font-installation SYSTEM "font-installation.docbook">
+  <!ENTITY creating-graphics SYSTEM "creating-graphics.docbook">
+  <!ENTITY screen-captures SYSTEM "screen-captures.docbook">
+  <!ENTITY konsole-intro SYSTEM "konsole-intro.docbook">
+  <!ENTITY tde-edutainment SYSTEM "tde-edutainment.docbook">
+  <!ENTITY accessibility SYSTEM "accessibility.docbook">
+  <!ENTITY under-the-hood SYSTEM "under-the-hood.docbook">
+  <!ENTITY net-connection-setup SYSTEM "net-connection-setup.docbook">
+  <!ENTITY email SYSTEM "email.docbook">
+  <!ENTITY internet-shortcuts SYSTEM "internet-shortcuts.docbook">
+  <!ENTITY browser-fine-tuning SYSTEM "browser-fine-tuning.docbook">
+  <!ENTITY usenet SYSTEM "usenet.docbook">
+  <!ENTITY messaging-intro SYSTEM "messaging-intro.docbook">
+  <!ENTITY tde-office SYSTEM "tde-office.docbook">
+  <!ENTITY migrator-dictionary SYSTEM "migrator-dictionary.docbook">
+  <!ENTITY glossary SYSTEM "glossary.docbook">
+  <!ENTITY standard-menu-entries SYSTEM "standard-menu-entries.docbook">
+  <!ENTITY where-next SYSTEM "where-next.docbook">
+  <!ENTITY credits-and-license SYSTEM "credits-and-license.docbook">
+  <!ENTITY extragear-applications SYSTEM "extragear-applications.docbook">
+  <!ENTITY migrator-applications SYSTEM "migrator-applications.docbook">
+  <!ENTITY % English "INCLUDE">
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+
+<title>The &tde; (Trinity Desktop Environment) User Guide</title>
+
+<authorgroup>
+<author>&tde-authors;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2004-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>A general user guide to the Trinity Desktop Environment.
+</para>
+
+<para>Please report problems with this document to
+<email>trinity-devel@lists.pearsoncomputing.net</email>.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>TDE</keyword>
+<keyword>desktop</keyword>
+<keyword>handbook</keyword>
+<keyword>tutorial</keyword>
+</keywordset>
+
+</bookinfo>
+
+<part id="introduction">
+<title>Introduction</title>
+
+<chapter id="welcome">
+<title>Welcome to the &tde; User Guide</title>
+
+<para>This User Guide provides an overview of &tde;. Use this
+guide after installing &tde; and accompanying packages. This guide should be
+a first point of reference for basic &tde; configuration questions, or
+to learn to perform common tasks.</para>
+
+<sect1 id="what-the-ug-is">
+<title>What this guide aims to be</title>
+
+<para>The first place to look and a one-stop location for questions
+regarding &tde;.</para>
+
+<para>A quick guide to commonly performed tasks. In most cases, learning
+basic functions does not require configuring every option in an application.
+Provided in this guide is information that works
+for most common situations, along with links to sources of
+further information.</para>
+
+<para>There are also some tips and tricks showing useful features
+of &tde; and ways to save time and effort.</para>
+
+</sect1>
+
+<sect1 id="what-the-ug-is-not">
+<title>What this book is not</title>
+
+<para>This guide is not intended to replace the individual application
+handbook help manuals. Use the appropriate handbook to help with specific program
+configuration and troubleshooting issues not covered in this guide. Where to find
+additional information is provided when answers are outside the scope of this guide.</para>
+
+<para>Several applications provided outside the main &tde; suite
+are mentioned in this guide, but mostly this guide covers only the
+applications provided as part of the main suite.</para>
+
+<para>The user guide is not specific to a distribution and covers a default &tde;
+installation. Local installations might be customized by
+distribution providers, or end-users. Therefore advice provided in this guide is
+generic. For example, file paths used to run files might be different than
+described in this guide.</para>
+</sect1>
+
+<sect1 id="typographic-conventions">
+<title>Conventions used in this book</title>
+
+<para>The following formatting conventions are used:
+<informaltable>
+<tgroup cols="3">
+
+<thead>
+<row>
+<entry>Type of Text</entry>
+<entry>Style</entry>
+<entry>Example</entry>
+</row>
+</thead>
+<tbody>
+
+<row>
+<entry>Text appearing in the &GUI; (on buttons, &etc;)</entry>
+<entry>Light gray background</entry>
+<entry><guilabel>Settings</guilabel></entry>
+</row>
+
+<row>
+<entry>Names of keys</entry>
+<entry>Bold font</entry>
+<entry>&Ctrl;</entry>
+</row>
+
+<row>
+<entry>Menu entries</entry>
+<entry><quote>Menu Name</quote>-><quote>Menu Item</quote></entry>
+<entry><menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem>
+</menuchoice></entry>
+</row>
+
+<row>
+<entry>Key combinations (pressed simultaneously)</entry>
+<entry><quote>Modifier Key</quote>+<quote>Action Key</quote></entry>
+<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap>
+</keycombo></entry>
+</row>
+
+<row>
+<entry>Text you should enter</entry>
+<entry>Bold, fixed width font</entry>
+<entry><userinput>ls -al tde/</userinput></entry>
+</row>
+
+<row>
+<entry>Text you should replace as appropriate</entry>
+<entry>Italic green font</entry>
+<entry><replaceable>user</replaceable></entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+</para>
+
+<para>Mouse buttons often are referred to as the left mouse button and right mouse button.
+Traditionally, the left mouse button is used the primary button to select items and the right
+mouse button is used as the secondary button to open popup context menus. Within that context,
+terms such as "left-click" and "right-click" have become common. Unfortunately, that terminology
+describes the buttons from a right-handed perspective. For people using a mouse configured
+for left-handed use, the roles of the buttons are reversed. That is, the right mouse button
+becomes the primary button and the left mouse button becomes the secondary button. To avoid
+confusion in this guide, that traditional terminology will be used as little as possible.
+Although this guide is revised periodically, those traditional terms might still be used.</para>
+
+</sect1>
+
+<sect1 id="system-locations">
+<title>System Locations</title>
+
+<para>The following system location information might be useful:
+
+<variablelist>
+
+<varlistentry>
+<term>&tde; prefix</term>
+<listitem><para>&tde; installs into its own folder tree, which is found by
+running the command <userinput><command>tde-config</command> <option>--prefix</option></userinput>. This folder is referred to
+by the environment variable $<envar>TDEDIR</envar> and possibly
+$<envar>TDEDIRS</envar>.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>&tde; user-specific settings</term>
+<listitem><para>The environment variable $<envar>TDEHOME</envar>
+points to the folder where &tde; should find user-specific settings.
+The default location is <filename class="directory">$HOME/.trinity</filename>.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</para>
+</sect1>
+
+<sect1 id="overview">
+<title>Overview, or <quote>Where to look in the User Guide</quote></title>
+
+<para>Here's an overview of what's in the User Guide:</para>
+
+<para><xref linkend="desktop"/> contains an introduction to the basic
+use of &tde;, such as <xref linkend="windows-how-to-work"/>, and the tools
+used in all &tde; applications, like <xref
+linkend="programs-save-open" />. Those users new to &tde; or
+computers in general, will find this section helpful.</para>
+
+<para><xref linkend="components"/> explains some important components
+of a &tde; installation and how they fit together. &tde;'s multimedia
+and networking capabilities are extensive and not covered thoroughly
+here, but there's a taster of both of them in this part of the User
+Guide. At the end of this part are suggestions for tweaking &tde;
+in <xref linkend="tinkering-under-the-hood"/>.</para>
+
+<para><xref linkend="tde-online"/> highlights &tde;'s suite of
+Internet applications. &tde; includes a powerful web browser,
+&konqueror;, a full-featured email client, &kmail;, a news reader,
+&knode;, and many more applications to use the Internet.
+This part of the User Guide contains
+information about configuring these applications.</para>
+
+</sect1>
+</chapter>
+</part>
+
+<part id="desktop">
+<title>The Desktop</title>
+
+<chapter id="basics">
+<title>The Basics</title>
+<para>The <quote>desktop</quote><indexterm><primary>Desktop</primary>
+</indexterm> is the name for the layout of
+the screen when starting &tde;. The desktop might look slightly different,
+but the main features should be the same as the following image.</para>
+
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata fileref="desktop.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>A default desktop layout</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<para>Let us look at the most important parts:
+<itemizedlist>
+<listitem><para>Most of the screen is
+occupied by the background<indexterm><primary>Background</primary></indexterm>. With some distributions,
+there might be a picture for the background. This picture is referred to as the
+<quote>wallpaper,</quote><indexterm><primary>Wallpaper</primary></indexterm> and can be changed by every user.</para>
+</listitem>
+
+<listitem><para>In the left-hand side are two icons:
+<guiicon>Trash</guiicon> and <guiicon>Home</guiicon>. Selecting
+these will open the <filename>Trash</filename> folder and Home
+folder, respectively. Add more icons to the desktop as desired
+to open favorite programs, or access removable media.</para>
+</listitem>
+
+<listitem><para>At the bottom is the &tde; Panel<indexterm><primary>Panel</primary></indexterm>, also known as
+<quote>&kicker;</quote>. The Panel contains several useful ways of
+interacting with &tde;. The Panel houses the &kmenu; button, from where
+any &tde; application can be started. The Panel can be configured to show all the
+programs that are running, as well as the date and time, and more.
+Read <xref linkend="panel-and-desktop"/> for more
+information about the &tde; Panel.</para>
+</listitem>
+</itemizedlist></para>
+
+<!-- Put this somewhere else
+At the far left is the &kmenu;
+button. Selecting this button will open the main &tde; menu, which
+has links to all the installed &tde; applications, and some useful
+commands, like <guilabel>Find Files</guilabel> and <guilabel>Log
+Out</guilabel>. Start an application from the
+&kmenu;. Like the other things on the desktop,
+the &kmenu; can be changed.</para>
+</listitem>
+-->
+
+<!-- Put this in the Panel section
+<listitem><para>Next to the &kmenu; button are icons which will
+start some commonly-used &tde; applications. These icons are similar
+to the ones on the desktop, but only links to programs
+(and not links to removable media, like CDs).</para>
+</listitem>
+
+-->
+
+<sect1 id="logging-in">
+
+<title>Logging In and Logging Out</title>
+<para>There are two ways to log into &tde;: graphically and via the
+command line.</para>
+
+<sect2 id="logging-in-graphically">
+<title>Logging in Graphically</title>
+<indexterm><primary>login</primary></indexterm>
+<indexterm><primary>&tdm;</primary></indexterm>
+
+<para>A screen similar to the one shown below means
+the computer is ready for logging in graphically.</para>
+
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tdm.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>A typical TDM display</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<para> Enter a username in the
+<guilabel>Username</guilabel> text box and password in the
+<guilabel>Password</guilabel> text box. The password will not be shown
+while typing, instead displaying as asterisks or dots. When finished,
+select the <guibutton>Login</guibutton> button, or press the Enter key,
+and &tde; will start. A &tde; splash image will appear,
+and provide &tde; startup information. When done
+&tde; will be ready to use.</para>
+</sect2>
+
+<sect2 id="logging-in-via-cmdline">
+<title>Logging in at the Command Line</title>
+<indexterm><primary><command>starttde</command></primary></indexterm>
+<indexterm><primary><command>startx</command></primary></indexterm>
+
+<para>For those preferring the command line, log in to &tde;
+with the <command>startx</command> command. If necessary then in the
+system or user <filename>.xinitrc</filename> file, add the line
+<userinput>exec starttde</userinput>. &tde; should start the same way as
+when logging in graphically.</para>
+</sect2>
+
+<sect2 id="logging-out">
+<title>Logging Out</title>
+<indexterm><primary>logout</primary></indexterm>
+
+<para>When finished using &tde; for the moment, then
+log out until next time. The easiest way to do this is to
+select the &kmenu; button
+<guiicon>
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="../common/kmenu.png" format="PNG"/>
+</imageobject>
+</inlinemediaobject>
+</guiicon>
+at the bottom left of the screen, and then
+select the <guimenuitem>Log Out...</guimenuitem> item.</para>
+
+<itemizedlist>
+<title>Related Information</title>
+<listitem><para>The <ulink url="help:/tdm">&tdm; Handbook</ulink> has information about using and configuring
+the &tde; graphical login manager. Read more in &khelpcenter; or
+by entering <userinput>help:/tdm</userinput> in &konqueror;'s
+<guilabel>Location</guilabel> bar.</para>
+</listitem>
+</itemizedlist>
+
+</sect2>
+</sect1>
+
+&getting-help;
+&windows-how-to;
+
+&the-filemanager;
+
+
+</chapter>
+
+&panel-and-desktop;
+
+&programs-and-documents;
+
+</part>
+
+<part id="components">
+<title>&tde; Components</title>
+
+&control-center;
+
+&base-tde-applications;
+
+&extragear-applications;
+
+<chapter id="multimedia">
+<title>Multimedia With &tde;</title>
+
+&removable-disks;
+
+&playing-music;
+
+&playing-audiocds;
+
+&playing-movies;
+
+</chapter>
+
+<chapter id="multiuser-kde">
+<title>&tde; the Multiuser Desktop</title>
+
+&your-tde-account;
+
+&tde-as-root;
+
+&switching-sessions;
+</chapter>
+
+<chapter id="networking">
+<title>Networking with &tde;</title>
+
+&file-sharing;
+
+&networking-with-windows;
+
+&shared-sessions;
+</chapter>
+
+<chapter id="graphics-printing-and-fonts">
+<title>Graphics, Printing, and Fonts</title>
+
+&printer-setup;
+
+&printing-from-apps;
+
+&pdf-files;
+
+&font-installation;
+
+&creating-graphics;
+
+</chapter>
+&customizing-desktop;
+
+&konsole-intro;
+
+&tde-edutainment;
+
+&accessibility;
+
+&under-the-hood;
+</part>
+
+<part id="tde-online">
+<title>&tde; and the Internet</title>
+
+&net-connection-setup;
+
+&email;
+
+<chapter id="browser">
+<title>&konqueror;</title>
+
+<para>Intro to the browser</para>
+
+&internet-shortcuts;
+
+&browser-fine-tuning;
+</chapter>
+
+&usenet;
+
+&messaging-intro;
+
+</part>
+
+&tde-office;
+
+<part id="more">
+<title>More Tools</title>
+
+&migrator-applications;
+
+&migrator-dictionary;
+
+&standard-menu-entries;
+
+&glossary;
+
+<chapter id="troubleshooting">
+<title>Troubleshooting Problems</title>
+
+<para>Problems that aren't</para>
+
+<para>Frozen apps (how to kill them)</para>
+
+<para>Things won't open</para>
+
+<para>That scary crash dialog</para>
+
+<para>Reporting Bugs</para>
+
+<para>More Resources</para>
+
+&troubleshooting-network-x;
+
+&troubleshooting-no-open;
+
+</chapter>
+
+<chapter id="contributing">
+<title>Contributing to &tde;</title>
+
+<para>Some basic information to get encourage people to contribute to
+&tde;, information about what's available, and how to get
+started.</para>
+
+</chapter>
+
+</part>
+
+
+<appendix id="appendix-credits">
+<title>Credits and Licenses</title>
+
+&credits-and-license;
+
+<sect1 id="license">
+<title>License</title>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+</sect1>
+
+</appendix>
+
+&documentation.index;
+
+</book>