[kde-doc-english] [kde-baseapps] doc/konqueror: Improve Konqueror docs
Yuri Chornoivan
yurchor at ukr.net
Tue May 14 17:06:11 UTC 2013
Git commit a1bcb356854b45087abeb671d452a20993650931 by Yuri Chornoivan, on behalf of David Palser.
Committed on 14/05/2013 at 19:05.
Pushed by yurchor into branch 'master'.
Improve Konqueror docs
M +11 -12 doc/konqueror/bookmarks.docbook
M +2 -2 doc/konqueror/config.docbook
M +19 -14 doc/konqueror/plugins.docbook
M +1 -1 doc/konqueror/save-settings.docbook
M +7 -7 doc/konqueror/sidebar.docbook
M +25 -25 doc/konqueror/view-extensions.docbook
http://commits.kde.org/kde-baseapps/a1bcb356854b45087abeb671d452a20993650931
diff --git a/doc/konqueror/bookmarks.docbook b/doc/konqueror/bookmarks.docbook
index 960eaf2..bb9a9aa 100644
--- a/doc/konqueror/bookmarks.docbook
+++ b/doc/konqueror/bookmarks.docbook
@@ -15,12 +15,11 @@
your own files and folders, they are most useful when you are surfing the
Web, letting you build up a list of useful sites.</para>
-<para>To open the <guimenu>Bookmarks</guimenu> menu you may
-<mousebutton>left</mousebutton> click on the
-<guimenu>Bookmarks</guimenu> menu. Once
-the list is visible, you can navigate through it with the arrow keys or with
-your mouse, then press &Enter; or
-<mousebutton>left</mousebutton> click to visit the selected location.</para>
+<para>To open the <guimenu>Bookmarks</guimenu> menu
+<mousebutton>left</mousebutton> click on the <guimenu>Bookmarks</guimenu> menu.
+Once the list is visible, you can navigate through it with the arrow keys or
+with your mouse, then press &Enter; or <mousebutton>left</mousebutton>
+click to visit the selected location.</para>
<para>To add a new item to the list use <menuchoice><guimenu>Bookmarks
</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice> or
@@ -50,12 +49,12 @@ bookmarks home page with an overview of all bookmarks and folders is shown.</par
Bookmarks</guimenuitem> </menuchoice> option opens the <guilabel>Bookmark
Editor</guilabel>.</para>
<para>This shows a tree view of your bookmarks and bookmark subfolders.
-As is usual for tree views in &kde;, subfolders are shown with a small square
-at the left of the folder name; if the square contains a <keycap>+</keycap>
-sign <mousebutton>left</mousebutton> clicking on it will expand the view to
-show the contents of that subfolder and the <keycap>+</keycap> sign will
-change to <keycap>-</keycap>, <mousebutton>left</mousebutton> clicking on the
-<keycap>-</keycap> sign will collapse the subfolder view.</para>
+As is usual for tree views in &kde;, subfolders are shown with a small
+<keycap>></keycap> arrow at the left of the folder name;
+<mousebutton>left</mousebutton> clicking on it will expand the view to
+show the contents of that subfolder and the <keycap>></keycap> arrow will
+change to <keycap>v</keycap>; <mousebutton>left</mousebutton> clicking on the
+<keycap>v</keycap> arrow will collapse the subfolder view.</para>
<para>To select an item in the list you can <mousebutton>left</mousebutton>
click on it, or you can navigate through the list by using the <keysym>
diff --git a/doc/konqueror/config.docbook b/doc/konqueror/config.docbook
index 6d1026e..ba8dd14 100644
--- a/doc/konqueror/config.docbook
+++ b/doc/konqueror/config.docbook
@@ -23,7 +23,7 @@ wishes.</para>
<para>When &kde; is newly installed, &konqueror;'s window contains a Menubar,
Main and Location Toolbars and possibly a Bookmark Toolbar.</para>
-<para>Maybe you don not need all these toolbars. To hide one of them, go into
+<para>Maybe you don't need all these toolbars. To hide one of them, go into
the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Toolbars Shown</guisubmenu>
</menuchoice> menu and uncheck its box. To show a hidden toolbar, just check
the box.</para>
@@ -117,7 +117,7 @@ box:</para>
<listitem><para><ulink url="help:/kcontrol/khtml-general/index.html">General</ulink>:
Configure general &konqueror; behavior</para></listitem>
<listitem><para><ulink url="help:/kcontrol/performance/index.html">Performance</ulink>:
-Configure settings that can improve &konqueror; performance</para></listitem>
+Configure settings that can improve &konqueror;'s performance</para></listitem>
<listitem><para><ulink url="help:/kcontrol/bookmarks/index.html">Bookmarks</ulink>:
Configure the bookmarks home page</para></listitem>
<listitem><para><ulink url="help:/kcontrol/filemanager/index.html">File Management</ulink>:
diff --git a/doc/konqueror/plugins.docbook b/doc/konqueror/plugins.docbook
index b2f001d..b8fefe2 100644
--- a/doc/konqueror/plugins.docbook
+++ b/doc/konqueror/plugins.docbook
@@ -21,9 +21,9 @@
<para>Selecting <menuchoice><guimenu>Settings</guimenu><guimenuitem>
Configure Konqueror...</guimenuitem>
</menuchoice> opens the configuration dialog. Select the
-<guilabel>Plugins</guilabel> page, where you find two tabs;
+<guilabel>Plugins</guilabel> page, where you find two tabs:
<guilabel>Global Settings</guilabel> to enable plugins and configure
-how they are used in &konqueror; and the <guilabel>Plugins</guilabel>
+how they are used in &konqueror; and <guilabel>Plugins</guilabel>
which shows you the &Netscape; plugins that &kde; has found
and allows you to scan for plugins.</para>
@@ -221,14 +221,14 @@ settings without going through the <guimenu>Settings</guimenu> dialog.
<varlistentry>
<term><guimenuitem>Enable Cache</guimenuitem></term>
-<listitem><para>Allows you to enable or disable the use of cache in the &konqueror; browser.</para></listitem>
+<listitem><para>Allows you to enable or disable the use of a cache in the &konqueror; browser.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Cache Policy</guimenuitem></term>
<listitem>
-<para>The Cache Policy submenu provides you with a way to configure the how
-&konqueror; uses cache. The possible uses include:</para>
+<para>The Cache Policy submenu provides you with a way to configure how
+&konqueror; uses a cache. The possible uses include:</para>
<itemizedlist>
<listitem><para>Keep Cache in Sync</para></listitem>
<listitem><para>Use Cache if Possible</para></listitem>
@@ -261,7 +261,7 @@ limit access to those using a particular web browser.</para>
<varlistentry>
<term>Browser submenu</term>
<listitem><para>
-The following menu items show a lot of popular browsers like <guimenuitem>Firefox</guimenuitem>,
+The following menu items show a list of popular browsers such as <guimenuitem>Firefox</guimenuitem>,
<guimenuitem>Internet Explorer</guimenuitem>, <guimenuitem>Netscape Navigator</guimenuitem>,
<guimenuitem>Opera</guimenuitem>, <guimenuitem>Other</guimenuitem>, and <guimenuitem>Safari</guimenuitem>.
</para></listitem>
@@ -347,17 +347,20 @@ way the gallery is created.</para>
<varlistentry>
<term><guimenuitem>Show image file name</guimenuitem></term>
-<listitem><para>The Show image file name check box allows you to turn on or off the use of the filenames below the gallery thumbnails.</para></listitem>
+<listitem><para>The Show image file name check box allows you to choose whether
+to display filenames below the gallery thumbnails.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Show image file size</guimenuitem></term>
-<listitem><para>The Show image filesize check box allows you to turn on or off the use of the filesizes below the gallery thumbnails.</para></listitem>
+<listitem><para>The Show image filesize check box allows you to choose whether
+to display filesizes below the gallery thumbnails.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Show image dimensions</guimenuitem></term>
-<listitem><para>The Show image dimensions check box allows you to turn on or off the use of the image dimensions in pixels below the gallery thumbnails.</para></listitem>
+<listitem><para>The Show image dimensions check box allows you to choose
+whether to display image dimensions in pixels below the gallery thumbnails.</para></listitem>
</varlistentry>
<varlistentry>
@@ -386,7 +389,7 @@ way the gallery is created.</para>
<title>Folders</title>
<varlistentry>
<term>The Folders dialog is used for choosing where to save the gallery.
-This dialog is also used to configure what folders are used.</term>
+This dialog is also used to configure which folders are used.</term>
<listitem>
<screenshot>
@@ -405,7 +408,8 @@ This dialog is also used to configure what folders are used.</term>
<varlistentry>
<term><guimenuitem>Save to HTML file</guimenuitem></term>
-<listitem><para>The Save to file selector decides where you want to save you image gallery html page.</para></listitem>
+<listitem><para>The Save to file selector allows you to decide where you want
+to save your image gallery html page.</para></listitem>
</varlistentry>
<varlistentry>
@@ -462,7 +466,8 @@ Description
<varlistentry>
<term><guimenuitem>Image format for the thumbnails</guimenuitem></term>
-<listitem><para>The image format combo box allows you to choose what format is used for the thumbnail images.</para></listitem>
+<listitem><para>The image format combo box allows you to choose which format is
+used for the thumbnail images.</para></listitem>
</varlistentry>
<varlistentry>
@@ -472,7 +477,7 @@ Description
<varlistentry>
<term><guimenuitem>Set different color depth</guimenuitem></term>
-<listitem><para>The set different color depth check box enables a combo box for selecting a different color depth for the thumbnails if you wish to use a color depth other than the depth used in the original image.</para></listitem>
+<listitem><para>The set different color depth check box enables a combo box for changing the color depth of the thumbnails if you wish to use a different color depth to that used in the original image.</para></listitem>
</varlistentry>
</variablelist>
@@ -493,7 +498,7 @@ Description
<!--How to enable ???-->
<varlistentry>
<term>Search Bar</term>
-<listitem><para>Provides a text box for easy access to search engines like Google.
+<listitem><para>Provides a text box for easy access to search engines such as Google.
Clicking on the icon on the left side of the search box opens a menu to select
and enable different search engines and configure their <ulink
url="help:/kcontrol/ebrowsing/index.html">Web Shortcuts</ulink>.
diff --git a/doc/konqueror/save-settings.docbook b/doc/konqueror/save-settings.docbook
index 06f948c..80b80f1 100644
--- a/doc/konqueror/save-settings.docbook
+++ b/doc/konqueror/save-settings.docbook
@@ -32,7 +32,7 @@ creates a <filename>.directory</filename> file in that folder to hold the
folder <guimenu>View</guimenu> settings. Use this dialog again to remove the folder specific
settings (or just delete the <filename>.directory</filename> file).</para>
<note><para>One nice use of this feature is if you have a folder full of
-pictures. You can set that particular folder to display thumbnails of the
+pictures, you can set that particular folder to display thumbnails of the
pictures (by choosing the <menuchoice><guisubmenu>View Mode</guisubmenu>
<guimenuitem>Icons</guimenuitem></menuchoice> and <guimenuitem>Preview</guimenuitem>
from the <guimenu>View</guimenu> menu) when you open it, while
diff --git a/doc/konqueror/sidebar.docbook b/doc/konqueror/sidebar.docbook
index 40f2700..119215c 100644
--- a/doc/konqueror/sidebar.docbook
+++ b/doc/konqueror/sidebar.docbook
@@ -144,17 +144,17 @@ from the context menu.
<!-- end copy from dolphin docbook-->
</variablelist>
-<para>The sidebar configuration can be changed by <mousebutton>right
+<para>The Sidebar configuration can be changed by <mousebutton>right
</mousebutton> clicking on the empty area below the bottom tab icon or by
<mousebutton>left</mousebutton> clicking on the <guilabel>Configuration
-Button</guilabel> icon, this is enabled in the contextmenu. Doing this
+Button</guilabel> icon, which is enabled in the context menu. Doing this
brings up a menu with the following options:</para>
<variablelist>
<varlistentry>
<term><guisubmenu>Add New</guisubmenu></term>
<listitem><para>This option lets you add a new tab page to the Sidebar.
-The new page can contain different sidebar modules or a new
+The new page can contain different Sidebar modules or a new
<guimenuitem>Folder</guimenuitem> tree view. The last option in this
submenu allows you to rollback to system default.</para>
</listitem>
@@ -170,7 +170,7 @@ two tab pages can be seen at once.</para>
<varlistentry>
<term><guimenuitem>Show Tabs Left</guimenuitem>, <guimenuitem>Show Tabs Right</guimenuitem></term>
<listitem><para>This option lets you choose whether the tab icons are shown at
-the left or right of the sidebar.</para>
+the left or right of the Sidebar.</para>
</listitem>
</varlistentry>
@@ -206,14 +206,14 @@ change the &URL; (path) of the folder viewed in that page.</para></listitem>
<varlistentry>
<term><guimenuitem>Remove</guimenuitem></term>
-<listitem><para>To remove the tab page from the sidebar.</para>
+<listitem><para>To remove the tab page from the Sidebar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem>Configure Sidebar</guimenuitem></term>
-<listitem><para>The last item offers a configuration submenu of the
-sidebar as described above.</para>
+<listitem><para>The last item shows the Sidebar configuration submenu
+as described above.</para>
</listitem>
</varlistentry>
diff --git a/doc/konqueror/view-extensions.docbook b/doc/konqueror/view-extensions.docbook
index e27e583..4c9f388 100644
--- a/doc/konqueror/view-extensions.docbook
+++ b/doc/konqueror/view-extensions.docbook
@@ -46,7 +46,7 @@ nested structures: each object is represented by a rectangle whose
area is proportional to its metric. The sum of the children's metrics must be
equal to or smaller than the parent object's metric.</para>
-<para>For &fsview;, sizes of files and folders are chosen as
+<para>For &fsview;, sizes of files and folders are chosen as the
metric, where the size of a folder is defined to be the sum of the
sizes of its subitems. This way, big files even deep down in the
folder hierarchy can be spotted easily be looking for large
@@ -54,12 +54,12 @@ rectangles. So &fsview; can be looked at as a graphical and interactive
version of the &UNIX; <command>du</command> command.</para>
<para>The integration of &fsview; as part of Konqueror allows it to
-use the standard features like context file menus, and mime type
-sensitive actions. But it was chosen not to implement automatical
-update of file system changes by watching: if you delete a file shown
+use the standard features such as context file menus, and mime type
+sensitive actions. But it was chosen not to implement automatic
+update by watching file system changes: if you delete a file shown
in &fsview; outside of &konqueror;, you have to update manually by
-⪚ pressing <keycap>F5</keycap>. The reason for this decision is
-the potentially huge amount of files which would have to be watched
+⪚ pressing <keycap>F5</keycap> to see the change. The reason for this
+decision is the potentially huge number of files which would have to be watched
for changes, and thus, could put an unreasonable pressure on system
resources for a small feature.</para>
@@ -76,20 +76,20 @@ in detail.</para>
<para>In &fsview;, an item of the tree map visualization is a rectangle
representing a file or folder of your file system. For easier navigation,
-rectangles have a meaningful coloring and labeling options.</para>
+rectangles have meaningful coloring and labeling options.</para>
<para>The color of a rectangle, switchable via menu item
<menuchoice><guimenu>View</guimenu><guisubmenu>Color
-Mode</guisubmenu></menuchoice> can be either
-<guimenuitem>Depth</guimenuitem> for easy detection of the nesting, or
-a color mapping of different file attributes like name, owner, group,
+Mode</guisubmenu></menuchoice> can be either representative of
+<guimenuitem>Depth</guimenuitem>, for easy detection of nesting, or
+a color mapping of different file attributes such as name, owner, group,
or mime type.</para>
<para>A rectangle can be labeled with the various attributes
-of the corresponding file or folder. For an attribute, you can
-choose, whether it should be shown at all, only if space is available,
+of the corresponding file or folder. For each attribute, you can
+choose whether it should be shown at all, only if space is available,
or if space should be taken from children (thus introducing
-errors to pure tree map drawing constrains). Additionally, you can choose
+errors to pure tree map drawing constraints). Additionally, you can choose
the relative location of the label in the rectangle.</para>
</sect3>
@@ -100,17 +100,17 @@ the relative location of the label in the rectangle.</para>
<para>For drawing algorithms in tree maps, the rule that the area
is proportional to the metric of an item should hold true.
With the tree map in &fsview;, this goal isn't always met: we draw borders
-to show the nesting of items, and this border takes space for a item
-which is possible lost for the areas of child items. Note that
+to show the nesting of items, and this border takes space for an item
+which is possibly lost for the areas of child items. Note that
less space is lost for the border if the rectangle is quadratic.</para>
-<para>Similar, it is good for a better overview to let all rectangles
-at least have its name as label, taking space, too. It is an option to
+<para>Similarly, it is better for a good overview to let each rectangle
+at least have its name as a label. It is an option to
always force space for labels, or only to draw labels when empty space
is available. In the latter case, the tool tips appearing when the
-mouse is kept over an item for some time, can help a lot. They show
+mouse is held over an item can help a lot. They show
information for the item the mouse is currently over, together with
-its parent relations up to the root item of the tree map.</para>
+its parent folders up to the root item of the tree map.</para>
<para>How the space of an item is split into subareas for children is
left to the implementation. It is always better to try to split areas
@@ -123,7 +123,7 @@ regard are <guilabel>Rows</guilabel>, <guilabel>Columns</guilabel>, or
menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Stop at
Area</guimenuitem></menuchoice>. Instead, a hash pattern will be drawn
over the parents area to signal that this space is in fact occupied by
-a child.</para>
+a child or children.</para>
</sect3>
@@ -141,14 +141,14 @@ combination with pressing the &Shift; key for range selection or the
longer be selected. Selecting an item will also clear the selection of all its
parent items before.</para>
-<para>There is keyboard navigation available in tree maps: use
+<para>Keyboard navigation is available in tree maps: use
<keycap>Left Arrow</keycap> and <keycap>Right Arrow</keycap> keys to
move the current item between siblings, and the <keycap>Up
Arrow</keycap> and <keycap>Down Arrow</keycap> keys to go up and down
-the nesting hierarchy. <keycap>Space</keycap> selects the item, in
-conjunction with &Shift; does range selection, and with the &Ctrl; key
-hold down simultaneously, toggles selection of the current item. Press
-<keycap>Return</keycap> to run the open action onto the current item.</para>
+the nesting hierarchy. <keycap>Space</keycap> selects the item; in
+conjunction with &Shift; does range selection; and with the &Ctrl; key
+held down simultaneously, toggles selection of the current item. Press
+<keycap>Return</keycap> to run the open action on the current item.</para>
</sect2>
More information about the kde-doc-english
mailing list