[kde-doc-english] Update for KSnapshot handbook

[Brad Hards]

OK to commit? I'm not really sure whether I'm an author or reviewer in this 
context.

diff -u -4 -p -r1.26 index.docbook
--- index.docbook       8 Jan 2005 23:46:21 -0000       1.26
+++ index.docbook       30 Jan 2005 03:58:46 -0000
@@ -38,8 +38,17 @@
 </affiliation>
 <contrib>Reviewer</contrib>
 </othercredit>

+<othercredit role="reviewer">
+<firstname>Brad</firstname>
+<surname>Hards</surname>
+<affiliation>
+<address><email>bradh at frogmouth.net</email></address>
+</affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+
 <othercredit role="developer">
 <firstname>Richard</firstname>
 <othername>J</othername>
 <surname>Moore</surname>
@@ -77,31 +86,31 @@
 <releaseinfo>1.01.00</releaseinfo>

 <abstract>
 <para>&ksnapshot; is a simple applet for taking screenshots. It is capable
-of capturing images of either the whole desktop or just a single
-window.  The images can then be saved in a variety of formats.</para>
+of capturing images of the whole desktop, a single window or a selected
+region.  The images can then be saved in a variety of formats.</para>
 </abstract>

 <keywordset>
 <keyword>KDE</keyword>
 <keyword>KSnapshot</keyword>
-<keyword>kdeutils</keyword>
-<keyword>nothing</keyword>
-<keyword>nothing else</keyword>
+<keyword>kdegraphics</keyword>
+<keyword>screen capture</keyword>
+<keyword>screen grab</keyword>
 </keywordset>

 </bookinfo>

 <chapter id="introduction">
 <title>Introduction</title>

-<para>&ksnapshot; is a simple application for taking screenshots. It is 
capable
-of capturing images of either the whole desktop or just a single
-window. The images can then be saved in a variety of formats.</para>
+<para>&ksnapshot; is a simple applet for taking screenshots. It is capable
+of capturing images of the whole desktop, a single window or a selected
+region.  The images can then be saved in a variety of formats.</para>

 <para>Please report any problems or feature requests to the <ulink
-url="http://bugs.kde.org/wizard.cgi">KDE bugzilla</ulink></para>
+url="http://bugs.kde.org/wizard.cgi">KDE Bug Tracking System</ulink></para>

 </chapter>

 <chapter id="using-ksapshot">
@@ -165,31 +174,46 @@ will differ depending on what you have d
 </textobject>
 </mediaobject>

 <para>The snapshot can be saved by clicking on
-the <guibutton>Save As...</guibutton> button. If multiple snapshots are 
taken, the filename is automatically incremented to prevent you from 
overwriting previous snapshots. You
-may however edit the filename to anything you wish, including the name
+the <guibutton>Save As...</guibutton> button. If multiple snapshots are 
taken, the
+filename is automatically incremented to prevent you from overwriting 
previous
+snapshots. You may however edit the filename to anything you wish, including 
the name
 of a previously saved snapshot. </para>

-<para>To take a snapshot of a single window, enable <guilabel>Only
-grab the window containing the pointer</guilabel> and then take a
-<guibutton>New Snapshot</guibutton>. </para>
+<para>To take a snapshot of a single window, select the <guilabel>Window
+Under Cursor</guilabel> combo box entry (next to the <guilabel>Capture 
mode:</guilabel>
+label), and then click on the <guibutton>New Snapshot</guibutton> 
button.</para>
+
 <para>Depending on your <guilabel>Snapshot delay:</guilabel> settings you
-get either a cross as the mouse pointer or you can work with a program until
+get either a cross as the mouse pointer (for <guilabel>No delay</guilabel>),
+or a standard mouse cursor which you can use to work with a program until
 the delay is over and a snapshot is taken.</para>
+
 <para>With <guilabel>No delay</guilabel>, the snapshot is taken immediately 
when you
 click in a window.</para>
+
 <para>&ksnapshot; will display the new snapshot in the preview
 area, at which time you can choose to save the new image (by pressing
 <guibutton>Save As...</guibutton>)
 or to grab a new one, by pressing the
 <guibutton>New Snapshot</guibutton> button.</para>

-<para>To take a new snapshot of the entire desktop, uncheck the
-<guilabel>Only grab the window containing the pointer</guilabel>
-option.  &ksnapshot; will now capture the entire desktop if you press
+<para>To take a new snapshot of the entire desktop, select the
+<guilabel>Full Screen</guilabel> combo box entry (next to the
+<guilabel>Capture mode:</guilabel> label), and then click on the
+<guibutton>New Snapshot</guibutton> button.
+&ksnapshot; will now capture the entire desktop if you press
 <guibutton>New Snapshot</guibutton>.</para>

+<para>Similarly, to take a snapshot of a region, select the
+<guilabel>Region</guilabel> combo box entry (next to the
+<guilabel>Capture mode:</guilabel> label) and set the
+<guilabel>Snapshot delay</guilabel> to <guilabel>No delay</guilabel>,
+and then click on the <guibutton>New Snapshot</guibutton> button. The
+mouse cursor will then change into a cross, and you can then use the
+mouse to select the region you want to capture. </para>
+
 </sect1>

 <sect1 id="additional-features">
 <title>Additional Features</title>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20050130/cf6f09c0/attachment.sig