copyedit

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index 43cbe44995aa0c8ae84f484218b8ce37420519d4..aaa8adc9805e750d503d82a94aa153b33921de40 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
@@ -1,6 +1,6 @@
 <root xmlns="http://www.inkscape.org/namespaces/keys" 
   title="Inkscape keyboard and mouse reference"
-  ver  ="0.46"
+  ver  ="0.47"
 >
 
 <p>This document describes the default keyboard and mouse shortcuts of Inkscape, corresponding to the
@@ -756,7 +756,10 @@ groups) with the same effect as Alt+click.)</note>
 <group>
 <title>Change node type</title>
 <keys><key><shift/>C</key>  <action>make cusp</action></keys>
+<note>First Shift+C changes type of node; if you do another Shift+C on an already cusp node, it retracts its handles</note>
 <keys><key><shift/>S</key>  <action>make smooth</action></keys>
+<note>If a cusp node is adjacent to a line segment, first Shift+S makes it half-smooth with one handle collinear 
+with the segment; another Shift+S will expand a second handle</note>
 <keys><key><shift/>Y</key>  <action>make symmetric</action></keys>
 <note>When making smooth or symmetric, you can lock the position of one of the handles by hovering mouse over it.</note>
 <mouse><key><ctrl/><left-click/></key> <action>toggle smooth/cusp/symmetric</action></mouse>
@@ -900,7 +903,8 @@ groups) with the same effect as Alt+click.)</note>
 *<section title="3D box tool" color="cff4e2">
 <group>
 <title>Draw</title>
-<mouse><key><left-drag/></key> <action>draw a 3D box (use shift to extrude in Z direction)</action></mouse>
+<mouse><key><left-drag/></key> <action>draw a 3D box (X/Y plane)</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>draw a 3D box (extrude in Z)</action></mouse>
 </group>
 
 <group>
@@ -1065,8 +1069,14 @@ groups) with the same effect as Alt+click.)</note>
 <note>If a path is selected, Shift+dragging anywhere creates a new subpath instead of a new independent path.</note>
 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
 <note>Shift also temporaily disables snapping to grid or guides when you are drawing with grid or guides on.</note>
-<mouse><key><ctrl/><left-click/></key> <action>create a single dot</action></mouse>
-<note>This creates a single dot, represented by a small circle. The dot size (relative to the current stroke width) can be set in the Preferences dialog. With Shift, the size is doubled. Pressing Alt while creating multiple dots randomly varies their size.</note>
+</group>
+
+<group>
+<title>Create dots</title>
+<mouse><key><ctrl/><left-click/></key> <action>create a dot</action></mouse>
+<note>This creates a small circle. Its size (relative to the current stroke width) can be set in Preferences.</note> 
+<mouse><key><shift/><ctrl/><left-click/></key> <action>create a double-sized dot</action></mouse>
+<mouse><key><alt/><ctrl/><left-click/></key> <action>create a random-sized dot</action></mouse>
 </group>
 </section>
 
@@ -1108,9 +1118,11 @@ groups) with the same effect as Alt+click.)</note>
 
 <group>
 <title>Create dots</title>
-<mouse><key><ctrl/><left-click/></key> <action>create a single dot</action></mouse>
-<note>This creates a single dot, represented by a small circle. The dot size (relative to the current stroke width) can be set in the Preferences dialog. With Shift, the size is doubled. Pressing Alt while creating multiple dots randomly varies their size.</note>
-
+<mouse><key><ctrl/><left-click/></key> <action>create a dot</action></mouse>
+<note>This creates a small circle. Its size (relative to the current stroke width) can be set in Preferences.</note> 
+<mouse><key><shift/><ctrl/><left-click/></key> <action>create a double-sized dot</action></mouse>
+<mouse><key><alt/><ctrl/><left-click/></key> <action>create a random-sized dot</action></mouse>
+</group>
 
 <group>
 <title>Finish</title>