summaryrefslogtreecommitdiffstats
path: root/doc/userguide/getting-help.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'doc/userguide/getting-help.docbook')
-rw-r--r--doc/userguide/getting-help.docbook132
1 files changed, 46 insertions, 86 deletions
diff --git a/doc/userguide/getting-help.docbook b/doc/userguide/getting-help.docbook
index c3a872c7c..08456e942 100644
--- a/doc/userguide/getting-help.docbook
+++ b/doc/userguide/getting-help.docbook
@@ -1,25 +1,17 @@
<sect1 id="getting-help">
-<sect1info>
-<authorgroup>
-<author>&Lauri.Watts;
-</author>
-</authorgroup>
-</sect1info>
-
-
<title>Getting Help</title>
<sect2 id="user-manuals">
<title>User Manuals</title>
<indexterm><primary>User Manual</primary></indexterm>
-<para>Most applications come with a comprehensive user manual<indexterm><primary>User Manual</primary><secondary>Handbook</secondary></indexterm>, which you can
-reach various ways:</para>
+<para>Most applications come with a user manual<indexterm><primary>User Manual</primary><secondary>Handbook
+</secondary></indexterm>, which can be reached in various ways:</para>
<itemizedlist>
<listitem>
-<para>By pressing <keycap>F1</keycap> inside the application.</para>
+<para>By pressing <keycap>F1</keycap> while inside the application.</para>
</listitem>
<listitem>
<para>From the menu bar:
@@ -27,16 +19,12 @@ reach various ways:</para>
</replaceable></guimenuitem></menuchoice></para>
</listitem>
<listitem>
-<para>By browsing to it in &khelpcenter;<indexterm><primary>&khelpcenter;</primary></indexterm></para>
+<para>By browsing in &khelpcenter;<indexterm><primary>&khelpcenter;</primary></indexterm></para>
</listitem>
<listitem>
-<para>By using the help KIOslave in &konqueror;. So, in the Location Toolbar, simply type <userinput>help:/<replaceable>Application name</replaceable></userinput>
+<para>By using the help KIOslave in &konqueror;. For example, in the Location bar, type <userinput>help:/<replaceable>Application name</replaceable></userinput>, where <replaceable>Application name</replaceable> is the name of the application.
</para>
</listitem>
-<listitem>
-<para>Online at <ulink
-url="http://docs.kde.org">http://docs.kde.org</ulink></para>
-</listitem>
</itemizedlist>
</sect2>
@@ -45,25 +33,26 @@ url="http://docs.kde.org">http://docs.kde.org</ulink></para>
<title>Context and <quote>What's This</quote> Help</title>
<para>Many applications also provide context help in two forms:
-Tooltips, and <quote>What's This</quote> help.</para>
+Tooltips and <quote>What's This</quote> help.</para>
<sect3 id="tooltips">
<title>Tooltips</title>
<indexterm><primary>Tooltips</primary></indexterm>
-<para>Tooltips are small informational windows or balloons that display when
-you hover the mouse over an item on your screen without clicking.</para>
+<para>Tooltips are small informational windows or balloons that appear when
+hovering the mouse over an item.</para>
-<para>&kde; uses tooltips in many places to provide brief help or
-information about an item on your screen. For instance, most toolbar buttons
-inside applications will display their name in a tooltip if you rest or hover
-your mouse over them.</para>
+<para>&tde; uses tooltips in many places to provide brief help or
+information about an item on the screen. For instance, most toolbar buttons
+inside applications will display their name in a tooltip when resting or hovering
+the mouse pointer over them.</para>
<para>Tooltips have another function, which is not specifically tied to
-help. In the &konqueror; file manager and on your Desktop, tooltips can
-provide information about files. This is commonly referred to as <quote>meta information</quote>.</para>
+help. In the &konqueror; file manager and on the Desktop, tooltips can
+provide information about files. This information is commonly referred to as
+<quote>meta information</quote>.</para>
-<para>You can find out more about meta-information tooltips in the section
+<para>Learn more about meta-information tooltips in the section
about <link linkend="file-manager">the &konqueror; file manager</link>.</para>
</sect3>
@@ -73,12 +62,12 @@ about <link linkend="file-manager">the &konqueror; file manager</link>.</para>
<indexterm><primary>What's This?</primary></indexterm>
-<para><quote>What's This?</quote> help is usually more detailed than tooltips.
-You can access <quote>What's This?</quote> help in two ways:</para>
+<para><quote>What's This?</quote> help usually is more detailed than tooltips.
+Access <quote>What's This?</quote> help in two ways:</para>
<itemizedlist>
<listitem>
-<para>By pressing the <guibutton>?</guibutton> button in the titlebar of the
+<para>By selecting the <guibutton>?</guibutton> button in the titlebar of the
window.</para>
</listitem>
<listitem>
@@ -87,69 +76,48 @@ window.</para>
</listitem>
</itemizedlist>
-<para>The cursor will change to a pointer with a question mark next to it.
-Click on the item you want to know about, and a small window will
+<para>The mouse pointer will change to a pointer with a question mark.
+Select an item to learn more, and a small window will
pop up displaying information.</para>
</sect3>
</sect2>
<sect2 id="mailing-lists-newsgroups-and-irc">
-<title>Mailing Lists, Newsgroups and <acronym>IRC</acronym></title>
+<title>Mailing Lists, Newsgroups, and <acronym>IRC</acronym></title>
<sect3 id="mailing-lists">
<title>Mailing Lists</title>
<indexterm><primary>Mailing Lists</primary></indexterm>
-<para>&kde; provides many mailing lists which can provide you with help
-and guidance in using and configuring your Desktop.</para>
-
-<para>Some of the lists you might find useful are:</para>
+<para>The &tde; Team provides some mailing lists to provide help
+and guidance with using and configuring &tde;:</para>
<variablelist>
<varlistentry>
-<term>The &kde; User List
-<indexterm><primary>&kde; User Mailing List</primary></indexterm></term>
+<term>The &tde; User List
+<indexterm><primary>&tde; User Mailing List</primary></indexterm></term>
<listitem>
-<para>This mailing list focuses specifically on <acronym>OS</acronym>-independent questions
-and discussions regarding using &kde;. Operating-system-specific questions and
-discussion are off-topic here. For
-example, the question <quote>How do I change the margin size for KWord
-documents</quote> is appropriate for this list; whereas <quote>How do I set
-up my printer using &kde; under UnixOS X.Y</quote> is not. Questions asked and
-discussions here should apply to all &kde; users using the applicable &kde;
-software, not just those using the same operating system.</para>
-<para>You can subscribe to this list at <ulink
-url="https://mail.kde.org/mailman/listinfo/kde">https://mail.kde.org/mailman/listinfo/kde</ulink>.</para>
-<para>You can find archives at <ulink
-url="http://lists.kde.org/?l=kde">http://lists.kde.org/?l=kde</ulink>.</para>
+<para>This mailing list focuses specifically on questions
+and discussions about using &tde;. For example,
+the question <quote>How do I change the margin size for KWord
+documents</quote> is appropriate for this list.</para>
+<para>Subscribe to this list at <ulink
+url="http://www.trinitydesktop.org/mailinglist.php">http://www.trinitydesktop.org/mailinglist.php</ulink>.</para>
+<para>Find archives at <ulink
+url="http://trinity-users.pearsoncomputing.net/">http://trinity-users.pearsoncomputing.net/</ulink>.</para>
</listitem>
</varlistentry>
-<varlistentry>
-<term>The &kde;-&Linux; List
-<indexterm><primary>kde-linux Mailing List</primary></indexterm></term>
-<listitem>
-<para>This mailing list focusses specifically on questions and discussions
-regarding using &kde; on &Linux;. Questions and discussions can involve any
-issue confronting desktop users who run &kde; on a &Linux; system. Hence,
-questions such as <quote>How do I setup a networked printer for printing from
-&kde; on LinuxDistro X.Y</quote> are appropriate here. If you prefer a list
-limited to <acronym>OS</acronym>-independent questions and discussions
-concerning &kde;, please use the general &kde; mailing list.</para>
-<para>You can subscribe to this list at <ulink
-url="https://mail.kde.org/mailman/listinfo/kde-linux">https://mail.kde.org/mailman/listinfo/kde-linux</ulink>.</para>
-<para>You can find archives at <ulink
-url="http://lists.kde.org/?l=kde-linux">http://lists.kde.org/?l=kde-linux</ulink>.</para>
-</listitem>
-</varlistentry>
</variablelist>
</sect3>
<sect3>
<title>IRC</title>
-<para>There is a #kde channel on Freenode (irc.freenode.net) for support and other general talk about &kde;. As usual, you can access this channel by using any of &kde;'s popular IRC clients which include <application>konversation</application>, &ksirc;, as well as &kopete;. For more information, check the <xref linkend="irc"/> section.</para>
+<para>There is a #trinity channel on Freenode (irc.freenode.net) for support and other general talk about &tde;.
+Access this channel by using any of &tde;'s popular IRC clients, which include <application>Konversation</application>,
+&ksirc; and &kopete;. For more information, check the <xref linkend="irc"/> section.</para>
</sect3>
</sect2>
@@ -158,34 +126,26 @@ url="http://lists.kde.org/?l=kde-linux">http://lists.kde.org/?l=kde-linux</ulink
<sect2 id="more-resources">
<title>More Resources</title>
-<para>There are many other resources which you may found useful; some of these are listed below:</para>
-
-<variablelist>
-<varlistentry>
-<term>dot.kde.org
-<indexterm><primary>&kde; News Resource</primary></indexterm></term>
-<listitem>
-<para>This website has a searchable &kde; news resource where you can find out about a superfluity of innovations in the world of &kde;.</para>
-</listitem>
-</varlistentry>
-</variablelist>
+<para>Other resources that might prove useful:</para>
<variablelist>
<varlistentry>
-<term>kde-look.org
-<indexterm><primary>icandy for &kde;</primary></indexterm></term>
+<term>trinitydesktop.org/rss.php (RSS Feed)
+<indexterm><primary>&tde; News Resource</primary></indexterm></term>
<listitem>
-<para>The paramount resource for &kde; icandy, including themes, window decorations, wallpapers, mouse themes and icons for your &kde; desktop. Note also that the site contains a howto section on how to install the most common of these.</para>
+<para>The RSS feed news resource to stay informed about &tde;.</para>
</listitem>
</varlistentry>
</variablelist>
<variablelist>
<varlistentry>
-<term>wiki.kde.org
-<indexterm><primary>&kde; wiki</primary></indexterm></term>
+<term><ulink
+url="http://www.trinitydesktop.org/wiki">http://www.trinitydesktop.org/wiki</ulink>
+<indexterm><primary>The &tde; Wiki</primary></indexterm></term>
<listitem>
-<para>The official &kde; Wiki. From here you can have access to a plethora of information ranging from frequently asked questions and HOWTOs to tips and tricks. The wiki should never, however, be used as a substitute for the respective application's handbook or the official &kde; documentation.</para>
+<para>The &tde; Wiki. The wiki should not be used as a substitute for the
+respective application's handbook or official &tde; documentation.</para>
</listitem>
</varlistentry>
</variablelist>