[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-doc-english
Subject: [kde-doc-english] patch to Kontact handbook
From: David Palser <davidpalser179 () btinternet ! com>
Date: 2012-10-11 13:37:16
Message-ID: 1349962636.1529.3.camel () llainwen
[Download RAW message or body]
Hi all
attached is a patch to the Kontact handbook.
It consists of making better sense of one or two sentences, improving
grammar, and capitalizing the initial letters of gui features.
best regards
David
["dp4.patch" (dp4.patch)]
diff --git a/doc/kontact/index.docbook b/doc/kontact/index.docbook
index 7f86f70..2faaa8c 100644
--- a/doc/kontact/index.docbook
+++ b/doc/kontact/index.docbook
@@ -48,7 +48,7 @@
<abstract><para>&kontact; is the integrated solution to your personal
information management (&PIM;) needs. It combines well-known &kde;
-applications like &kmail;, &korganizer; and &kaddressbook; into a
+applications such as &kmail;, &korganizer; and &kaddressbook; into a
single interface to provide easy access to mail, scheduling,
address book and other &PIM; functionality. </para></abstract>
@@ -86,7 +86,7 @@ applications are run within &kontact; and which are run
stand-alone.</para>
<para>In addition to the functionality of the individual applications &kontact;
-provides, a summary view and advanced drag & drop features between
+provides a summary view and advanced drag & drop features between
components.
</para>
@@ -142,14 +142,14 @@ them stand-alone.
<chapter id="main-window">
<title>The &kontact; Main Window</title>
-<para>The main window consists of a side pane on the left showing the icons of
-the available components, the main view on the right which contains the main
+<para>The Main Window consists of a side pane on the left showing the icons of
+the available components, a main view on the right which contains the main
window of the active component and the usual menu, tool and status bars.</para>
<sect1 id="side-pane">
<title>Side Pane</title>
-<para>The side pane serves multiple purposes. It allows for switching between
+<para>The Side Pane serves multiple purposes. It allows for switching between
components, shows which component is active and serves as the target for
drag & drop operations to the different applications.</para>
@@ -173,19 +173,19 @@ The main window of the component is shown and the menu, tool and status bars are
adapted to reflect the functionality of the active component. If you activate a
component for the first time there might be a small delay until the main view
is changed, because components are loaded on demand. This means you don't waste
-memory for components you don't use.</para>
+memory for components not in use.</para>
-<para>The icons in the side pane can also be used as targets for drag & drop
-operations. For example, you can drag a mail from the mail part and
+<para>The icons in the Side Pane can also be used as targets for drag & drop
+operations. For example, you can drag a mail message from the mail part and
drop it on the icon of the to-do list or the calendar to create a to-do
or event associated with this mail.</para>
-<para>Finally, you can change the size of the icons in the side pane.
-Right-clicking on the side pane will give you the option to use Large,
+<para>Finally, you can change the size of the icons in the Side Pane.
+Right-clicking on the Side Pane will give you the option to use Large,
Normal, or Small icons, as well as the option to use text only
instead of icons.</para>
-<para>If you dislike the sidebar, you can simply hide it by dragging the
+<para>If you dislike the Side Pane, you can simply hide it by dragging the
splitter. An alternative navigation between parts is provided by the
<guilabel>Navigator</guilabel> toolbar, which can be freely positioned. See
<xref linkend="bars" /> for more on the <guilabel>Navigator</guilabel>
@@ -201,10 +201,9 @@ toolbar.</para>
<para>The view on the right which takes up most of the area of the &kontact;
main window shows the active component. This exactly corresponds to the main
window the component uses when run as a stand-alone application. The highlighted
-icon in the side pane indicates to which application the main view belongs.
-&kontact; remembers which component was active, so when starting &kontact; the
-view initially shows which one was activated when exiting &kontact; the last
-time.</para>
+icon in the Side Pane indicates to which application the Main View belongs.
+&kontact; remembers the active component when exiting, so the next time
+&kontact; starts it initially displays that component in the Main View.</para>
<screenshot>
<screeninfo>&kontact;'s Main View</screeninfo>
@@ -222,7 +221,7 @@ time.</para>
</screenshot>
<para>In addition, there are two ways of overriding the component that &kontact;
-starts in. The first is as an argument to the &kontact; program call
+starts with. The first is supplying an argument to the &kontact; program call
(see <xref linkend="command-line"/>). The second is a setting in the
&kontact; Settings dialog that will allow you to always start &kontact; in a
certain mode.</para>
@@ -255,7 +254,7 @@ certain mode.</para>
means that, in addition to some common functions like the help menu which are
shown for all components, there are actions which are switched when the active
component is switched. These actions available for each component are the same
-ones which are also available when running the application stand-alone.</para>
+as those available when running the application stand-alone.</para>
<screenshot>
<screeninfo>Views of &kontact;'s menubars in the Summary View, Mail View, and
@@ -302,9 +301,9 @@ ones which are also available when running the application stand-alone.</para>
</mediaobject>
</screenshot>
-<para>In addition, &kontact; can show a <guilabel>Navigator</guilabel>
-toolbar, which allows you access to the &kontact; components very much like the
-side pane does. However, unlike the side pane, buttons in the
+<para>In addition, &kontact; can show the <guilabel>Navigator</guilabel>
+toolbar, which allows you access to the &kontact; components very much as the
+Side Pane does. However, unlike the Side Pane, buttons in the
<guilabel>Navigator</guilabel> toolbar cannot be used for drag & drop
operations to other components.</para>
@@ -332,7 +331,7 @@ operations to other components.</para>
<para>A special action common to all components is the
<guimenuitem>New</guimenuitem> action. It allows creation of new objects
-like emails, contacts, appointments and to-dos independently of which
+including emails, contacts, appointments and to-dos independently of which
component is active. The component responsible for processing the
selected object is started, if required, and takes over the created
object.</para>
@@ -567,8 +566,8 @@ you can configure the keyboard shortcuts by going to
<chapter id="summary-view">
<title>The Summary View</title>
-<para>The default view when starting &kontact; for the first time is the summary
-view. It shows an overview of the most relevant information provided by the
+<para>The default view when starting &kontact; for the first time is the Summary
+View. It shows an overview of the most relevant information provided by the
selected &kontact; components. These can be notes, imminent
appointments or birthdays, due to-dos, new messages &etc; Which information is
shown is configurable by selecting the corresponding components in the <link
@@ -601,17 +600,17 @@ the data.</para-->
<para>The Summary View allows you to change where the
components are in the view itself. So, if you prefer to
-have your Special Dates in the lower left and your to-dos in
-the upper right, you can rearrange the summary view to
+have your Special Dates in the lower left and your To-dos in
+the upper right, you can rearrange the Summary View to
reflect that.</para>
<para>Repositioning components in the Summary View is as simple
-as dragging them to the new location you want them to be in. Hold down the &Ctrl; key, click and
-hold on the gray title area of the component and drag the component
-to wherever you want it to be. Note that this positioning is done
+as dragging them to the new location you want them to be in. Hold down the
+&Ctrl; key, click and hold on the gray title area of the component and drag
+the component to wherever you want it to be. Note that this positioning is done
compared to other components. So you can move the Mail component to be
-below the to-do component in the view, but you cannot place it in a specific
-position. If you have only one component in your summary view, the only option
+below the To-do component in the view, but you cannot place it in a specific
+position. If you have only one component in your Summary View, the only option
is to move it between the two columns of the view; two components can either
be two in one column or one in each column; and so on and so forth. Whenever
you are dragging a component, you will see a small preview box following your
@@ -646,9 +645,9 @@ Rearranging &kontact;'s Summary View
action from the <guimenu>Settings</guimenu> menu, the &kontact;
configuration dialog is shown. It provides a list of the
configurations for all the active components of &kontact;. You can
-click the <guilabel>></guilabel> symbol next to the component names to
-collapse their options so that you can view the options for the
-component you are looking for. Selecting one of the configuration
+click the <guilabel>></guilabel> symbol next to the component name to
+expand the tree so that you can view the options for that
+component. Selecting one of the configuration
options under a heading will bring up that configuration section on
the right.</para>
@@ -668,20 +667,18 @@ the right.</para>
</screenshot>
<para>By checking the box next to the component title you select the
-component to be put into the side bar and the summary view. The
-component is loaded and its main view is shown in the main window when
-clicking on its icon in the side pane for the first time. By
-unchecking the check box the component is removed from the side pane and
-summary view. Changes become effective by clicking the
+component to be visible in the Side Pane and the Summary View. The
+component is loaded and shown in the Main Window when
+clicking on its icon in the Side Pane. By
+unchecking the check box the component is removed from the Side Pane and
+Summary View. Changes become effective by clicking the
<guibutton>Apply</guibutton> or <guibutton>OK</guibutton>
-button.</para>
-
-<para>You can also configure individual components by activating the
-component by clicking on the corresponding icon in the side pane of
-the main window and then selecting the menu item
-<guimenuitem>Configure <replaceable>application
-name</replaceable></guimenuitem> from the <guimenu>Settings</guimenu>
-menu.</para>
+buttons.</para>
+
+<para>You can also configure individual components by clicking on the
+corresponding icon in the Side Pane and then selecting the menu item
+<guimenuitem>Configure <replaceable>application name</replaceable></guimenuitem>
+from the <guimenu>Settings</guimenu> menu.</para>
<screenshot>
<screeninfo>&kontact; Settings Menu When &kmail; is Selected</screeninfo>
_______________________________________________
kde-doc-english mailing list
kde-doc-english@kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic