From 2557aeb900677c969c5cbaac487a25b7646feb84 Mon Sep 17 00:00:00 2001
From: William Kendrick <wkendrick@users.sourceforge.net>
Date: Mon, 12 Oct 2015 17:36:49 +0000
Subject: [PATCH] Made docs clearer re: stamp controls. (Fixes bug #182 @ SF)

---
 docs/CHANGES.txt      |  7 +++++--
 docs/README.txt       | 22 ++++++++++++++--------
 docs/html/README.html | 22 ++++++++++++++--------
 3 files changed, 33 insertions(+), 18 deletions(-)

diff --git a/docs/CHANGES.txt b/docs/CHANGES.txt
index 231a3e372..21a84cd0e 100644
--- a/docs/CHANGES.txt
+++ b/docs/CHANGES.txt
@@ -15,9 +15,13 @@ $Id$
     * Stars
       Pere Pujal i Carabantes
 
+  * Documentation updates
+    ---------------------
+    * Made stamp controls (size, flip, mirror) section clearer.
+      Fixes https://sourceforge.net/p/tuxpaint/bugs/182/
+
   * New locales
     -----------
-
     * Bengali
       Provided by chandrakant dhutadmal
 
@@ -38,7 +42,6 @@ $Id$
     * Urdu
       Provided by chandrakant dhutadmal
 
-
   * Localization Updates:
     ---------------------
     * Danish translation
diff --git a/docs/README.txt b/docs/README.txt
index 6f7aa60fd..2a0f14f4f 100644
--- a/docs/README.txt
+++ b/docs/README.txt
@@ -9,7 +9,7 @@
                            bill@newbreedsoftware.com
                             http://www.tuxpaint.org/
 
-                          June 14, 2002 - May 6, 2015
+                        June 14, 2002 - October 12, 2015
 
      ----------------------------------------------------------------------
 
@@ -228,14 +228,20 @@ Available Tools
                  plants, outer space, vehicles, people, etc.). Use the Left
                  and Right arrows to cycle through the collections.
 
-                 Some stamps can be colored or tinted. If the color palette
-                 below the canvas is activated, you can click the colors to
-                 change the tint or color of the stamp before placing it in
-                 the picture.
+                 Prior to 'stamping' an image onto your drawing, various
+                 effects can sometimes be applied (depending on the stamp):
 
-                 Stamps can be shrunk and expanded, and many stamps can be
-                 flipped vertically, or displayed as a mirror-image, using
-                 controls at the bottom right of the screen.
+                    * Some stamps can be colored or tinted. If the color
+                      palette below the canvas is activated, you can click
+                      the colors to change the tint or color of the stamp
+                      before placing it in the picture.
+                    * Stamps can be shrunk and expanded, by clicking within
+                      the triangular-shaped series of bars at the bottom
+                      right; the larger the bar, the larger the stamp will
+                      appear in your picture.
+                    * Many stamps may be flipped vertically, or displayed as
+                      a mirror-image, using the control buttons at the bottom
+                      right.
 
                  Different stamps can have different sound effects and/or
                  descriptive (spoken) sounds. Buttons at the lower left (near
diff --git a/docs/html/README.html b/docs/html/README.html
index 15f90951b..16095e5c6 100644
--- a/docs/html/README.html
+++ b/docs/html/README.html
@@ -26,7 +26,7 @@ version
 
 <p>June 14, 2002 -
 
-				May 6, 2015</p>
+				October 12, 2015</p>
 
 </center>
 
@@ -322,13 +322,19 @@ version
 	plants, outer space, vehicles, people, etc.).  Use the
 	Left and Right arrows to cycle through the collections.</p>
 
-	<p>Some stamps can be colored or tinted.  If the color palette
-        below the canvas is activated, you can click the colors to change
-	the tint or color of the stamp before placing it in the picture.</p>
-	
-	<p>Stamps can be shrunk and expanded, and many stamps can be
-	flipped vertically, or displayed as a mirror-image, using
-	controls at the bottom right of the screen.</p>
+	<p>Prior to 'stamping' an image onto your drawing, various
+        effects can sometimes be applied (depending on the stamp):</p>
+        <ul>
+        <li>Some stamps can be colored or tinted.  If the color palette
+          below the canvas is activated, you can click the colors to change
+	  the tint or color of the stamp before placing it in the picture.</li>
+	<li>Stamps can be shrunk and expanded, by clicking within the
+          triangular-shaped series of bars at the bottom right;
+          the larger the bar, the larger the stamp will appear in your
+          picture.</li>
+        <li>Many stamps may be flipped vertically, or displayed as a
+          mirror-image, using the control buttons at the bottom right.</li>
+        </ul>
 
 	<p align=center>
 	<img src="images/tool_stamp_controls.png" width=96 height=96 alt="">