summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDarrell Anderson <humanreadable@yahoo.com>2012-07-11 19:54:37 -0500
committerDarrell Anderson <humanreadable@yahoo.com>2012-07-11 19:54:37 -0500
commit9e8356536eb7ae212bf5c1262ac4dda65c450565 (patch)
tree1cc17efbfd990dc19100ddee19715843d0c7f394 /doc
parent62c3760e42a9e982729ccc922d4167eaf975b5e1 (diff)
downloadtdebase-9e8356536eb7ae212bf5c1262ac4dda65c450565.tar.gz
tdebase-9e8356536eb7ae212bf5c1262ac4dda65c450565.zip
Help handbook updates.
Diffstat (limited to 'doc')
-rw-r--r--doc/userguide/getting-help.docbook14
-rw-r--r--doc/userguide/index.docbook4
-rw-r--r--doc/userguide/windows-how-to.docbook52
3 files changed, 33 insertions, 37 deletions
diff --git a/doc/userguide/getting-help.docbook b/doc/userguide/getting-help.docbook
index 08456e942..7eb5d004c 100644
--- a/doc/userguide/getting-help.docbook
+++ b/doc/userguide/getting-help.docbook
@@ -16,10 +16,10 @@
<listitem>
<para>From the menu bar:
<menuchoice><guimenu>Help</guimenu><guimenuitem><replaceable>Application name
-</replaceable></guimenuitem></menuchoice></para>
+</replaceable></guimenuitem></menuchoice>.</para>
</listitem>
<listitem>
-<para>By browsing 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;. 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.
@@ -40,17 +40,17 @@ Tooltips and <quote>What's This</quote> help.</para>
<indexterm><primary>Tooltips</primary></indexterm>
<para>Tooltips are small informational windows or balloons that appear when
-hovering the mouse over an item.</para>
+hovering the mouse pointer over an item.</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
+information on the screen about an item. 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 the Desktop, tooltips can
provide information about files. This information is commonly referred to as
-<quote>meta information</quote>.</para>
+<quote>meta information.</quote></para>
<para>Learn more about meta-information tooltips in the section
about <link linkend="file-manager">the &konqueror; file manager</link>.</para>
@@ -72,7 +72,7 @@ window.</para>
</listitem>
<listitem>
<para>By pressing the key combination
-<keycombo>&Shift;<keycap>F1</keycap></keycombo></para>
+<keycombo>&Shift;<keycap>F1</keycap></keycombo>.</para>
</listitem>
</itemizedlist>
@@ -104,7 +104,7 @@ 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
+<para>Find list archives at <ulink
url="http://trinity-users.pearsoncomputing.net/">http://trinity-users.pearsoncomputing.net/</ulink>.</para>
</listitem>
</varlistentry>
diff --git a/doc/userguide/index.docbook b/doc/userguide/index.docbook
index 05c48e363..a815735d5 100644
--- a/doc/userguide/index.docbook
+++ b/doc/userguide/index.docbook
@@ -377,7 +377,7 @@ the computer is ready for logging in graphically.</para>
<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,
+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
@@ -415,7 +415,7 @@ select the <guimenuitem>Log Out...</guimenuitem> item.</para>
<itemizedlist>
<title>Related Information</title>
-<listitem><para>The &tdm; Handbook has information about using and configuring
+<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>
diff --git a/doc/userguide/windows-how-to.docbook b/doc/userguide/windows-how-to.docbook
index 1652f9a58..c6d1020d9 100644
--- a/doc/userguide/windows-how-to.docbook
+++ b/doc/userguide/windows-how-to.docbook
@@ -271,7 +271,7 @@ vertical/horizontal maximization. Or is this advanced? -->
<para>The simplest way to access the advanced window management
facilities in &tde; is to use a little known
-utility called &kstart;, which is included in &tde; since version 2.1 &kstart; lets you control the way an application interacts with
+utility called &kstart;. &kstart; lets you control the way an application interacts with
the window manager. The command is usually
used to define special behavior for commonly-used applications, but
it can also be useful for integrating non-&tde; applications into your
@@ -286,8 +286,8 @@ before a command. To begin, let's look at how we might use
<screen><prompt>%</prompt> <userinput><command>kstart</command> <option>--ontop</option> <option>--alldesktops</option> <option>kcalc</option></userinput></screen>
</para>
-<para>With luck, the effect this command has
-should be fairly obvious - the kcalc window will stay on top of all
+<para>Hopefully the effect this command is
+obvious - the kcalc window will stay on top of all
the others and be visible on every virtual desktop. A feature that is
less obvious is that this command will work with any NET compliant
environment, not just &tde;.</para>
@@ -295,9 +295,7 @@ environment, not just &tde;.</para>
<para>We can pass arguments to programs we invoke with &kstart; as normal, for
example:
-<screen><prompt>%</prompt> <userinput><command>kstart</command>
-<option>--skiptaskbar</option> <option>--desktop</option>
-1 xmessage'Hello World'</userinput></screen>
+<screen><prompt>%</prompt> <userinput><command>kstart</command> <option>--skiptaskbar</option> <option>--desktop</option> 1 xmessage 'Hello World'</userinput></screen>
</para>
@@ -307,14 +305,14 @@ ensures that the window will be shown on the first virtual desktop and
will be omitted from the taskbar. The fact that this program is
written using the Xt toolkit rather than being a native &tde;
application does not cause any problem for
-&kstart;, hopefully this illustrates how
+&kstart;. Hopefully this illustrates how
&kstart; can be used to integrate foreign
applications into your &tde; desktop.</para>
</sect3>
<sect3 id="special-window-settings">
<title>Other Special Window Settings</title>
-<para>While you can use &kstart; to assign particular window settings, &tde; also allows you to alter these -- mdash; as well as other similar settings -- mdash; from the program window itself. Simply select the left-most button in the window titlebar (or just hit <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> once the window is focued), and then go to <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>Special Window Settings...</guimenuitem></menuchoice>. As you can see, from here you change various things from its geometry upon startup, to whether it should have a border or not.</para>
+<para>While you can use &kstart; to assign particular window settings, &tde; also allows you to alter these &mdash; as well as other similar settings &mdash; from the program window itself. Simply select the left-most button in the window titlebar (or press <keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo> after the window is focused), and then go to <menuchoice><guisubmenu>Advanced</guisubmenu><guimenuitem>Special Window Settings...</guimenuitem></menuchoice>. As you can see, from here you change various things from its geometry upon startup, to whether it should have a border or not.</para>
</sect3>
<sect3 id="system-tray">
@@ -341,7 +339,7 @@ command:
<para>The icon shown in the tray is the one specified in the window
hints and will be updated if the icon changes. The window title is
-shown as a tooltip if you hold the mouse over the icon.
+shown as a tooltip if you hold the mouse pointer over the icon.
<application>ksystraycmd</application> follows standard &tde;
behaviour so the target window can be shown and hidden by clicking the
tray icon, and a standard context menu is available.</para>
@@ -361,10 +359,8 @@ fileref="kcalc-systray.png"></imagedata></imageobject>
<filename>.xsession-errors</filename> file (this is the log file that records what's
happening on your desktop). To begin with, we'll simply look at how
we can view this:
-<screen><prompt>%</prompt> <userinput><command>konsole</command> <option>--icon</option>
-log <option>--caption</option> 'X Log' \
-<option>--nomenubar</option> <option>--notabbar</option>
-<option>--noframe</option> \
+<screen><prompt>%</prompt> <userinput><command>konsole</command> <option>--icon</option> log <option>--caption</option> 'X Log' \
+<option>--nomenubar</option> <option>--notabbar</option> <option>--noframe</option> \
<option>-e</option> tail -f ~/.xsession-errors</userinput></screen>
</para>
@@ -379,8 +375,7 @@ the tray icon. The <option>-e</option> argument is specific to &konsole; and tel
to run the <command>less</command> command. Despite its complexity, we can easily move
this window into the tray with <application>ksystraycmd</application>:
-<screen><prompt>%</prompt> <userinput><command>ksystraycmd</command>
-<option>--hidden</option> <option>--title</option> 'X Log' \
+<screen><prompt>%</prompt> <userinput><command>ksystraycmd</command> <option>--hidden</option> <option>--title</option> 'X Log' \
konsole --icon log --caption 'XLog' \
--nomenubar --notabbar --noframe \
-e tail -f .xsession-errors</userinput></screen>
@@ -430,9 +425,7 @@ make our commands more robust we can use the
of the target window. The following example uses the <option>--window</option> parameter
to ensure that a particular konsole window is affected:
-<screen><prompt>%</prompt> <userinput><command>kstart</command> <option>--iconify</option> <option>--window</option> 'kstart_me' konsole
---caption 'kstart_me' -e tail -f
-~/.xsession-errors</userinput></screen>
+<screen><prompt>%</prompt> <userinput><command>kstart</command> <option>--iconify</option> <option>--window</option> 'kstart_me' konsole --caption 'kstart_me' -e tail -f ~/.xsession-errors</userinput></screen>
</para>
@@ -456,7 +449,7 @@ throughout &tde;.) </para>
<para>Sometimes, one screen's worth is just not enough space. If you
use many applications at the same time, and find yourself drowning in
-different windows, virtual desktops offer the solution. By default,
+different windows, virtual desktops offer a solution. By default,
&tde; has four virtual desktops, each one of which is like a separate
screen: you can open windows, move windows around, and set backgrounds and
icons on each of the desktops. If you are familiar with the concept of
@@ -465,13 +458,16 @@ desktops.</para>
<sect3 id="switching-virtual-desktops">
<title>Switching Virtual Desktops</title>
-<para>To move to a different virtual desktop, you can use <keycombo action="simul">&Ctrl;&Tab;
+<para>One way to move to a different desktop is to use the desktop pager in the panel.
+Use the mouse pointer and &LMB; to select the desired desktop.</para>
+<para>Another way to move to a different virtual desktop, is using <keycombo action="simul">&Ctrl;&Tab;
</keycombo> in the same way as you would use <keycombo action="simul">&Alt;&Tab;
-</keycombo> to switch between windows (see <xref linkend="switching-between-windows"/>): Hold down &Ctrl; and then press
+</keycombo> to switch between windows (refer to the <xref linkend="switching-between-windows"/>):
+Hold down &Ctrl; and then press
&Tab;. A small popup window appears, showing the virtual desktops,
-with one highlighted. If you release &Ctrl;, &tde; will switch to the
-highlighted virtual desktop. To select a different desktop, press
-&Tab; repeatedly, while holding down &Ctrl;. The selection moves
+with one highlighted. When you release &Ctrl;, &tde; will switch to the
+highlighted virtual desktop. To select a different desktop, hold down &Ctrl;
+whle pressing &Tab; repeatedly. The selection moves
through the available desktops. When the desktop you want to switch to
is highlighted, release &Ctrl;.</para>
@@ -481,10 +477,10 @@ is highlighted, release &Ctrl;.</para>
<sect3 id="windows-and-virtual-desktops">
<title>Windows and Virtual Desktops</title>
-<para>You can move windows around your virtual desktops with the
-<guisubmenu>To Desktop</guisubmenu> item in the window menu: just
-select the desktop to which you want to move the window. You can make the
-window appear on all desktops with the <guimenuitem>All
+<para>You can move windows to different virtual desktops with the
+<guisubmenu>To Desktop</guisubmenu> item in the window menu button. Use the &LMB;
+to select the window menu button and select the desktop to which you want to move
+the window. You can make the window appear on all desktops with the <guimenuitem>All
Desktops</guimenuitem><indexterm><primary>Sticky
Windows</primary></indexterm> item.</para>