copyedit

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index 6486450b12260d270165ed7a2260fe5ba3bff92e..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
@@ -161,15 +161,17 @@ RFE</a>).</p>
 </group>
 
 <group>
-<title>Guides and grid</title>
+<title>Guides, grids, snapping</title>
 <mouse><key><left-drag/></key> <action>drag off a ruler to create guide</action></mouse>
 <note>Drag off the horizontal or vertical ruler to create a new guideline. Drag a guideline onto the ruler to delete it.</note>
 <keys><key>|</key> <key><shift/>\</key> <action>toggle guides and snapping to guides</action></keys>
-<note>If you want to have different values for guides visibility and snapping, set them via the Document Options dialog.</note>
+<note>If you want to see the guides but not snap to them, use the global snapping toggle (% key).</note>
 <note>When you create a new guide by dragging off the ruler, guide visibility and snapping are turned on.</note>
-<keys><key>#</key> <key><shift/>3</key> <action>toggle grid and snapping to grid</action></keys>
-<note>If you want to have different values for grid visibility and snapping, set them via the Document Options dialog.</note>
+<keys><key>#</key> <key><shift/>3</key> <action>toggle grids and snapping to grids</action></keys>
+<note>If you want to see the grids but not snap to them, use the global snapping toggle (% key).</note>
 <note>Note that only the 3 key on the main keyboard works, not on the keypad.</note>
+<keys><key>%</key> <action>toggle snapping on and off</action></keys>
+<note>This toggle affects snapping to grids, guides, and objects in all tools.</note>
 </group>
 
 <group>
@@ -754,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>
@@ -898,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>
@@ -1063,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>
 
@@ -1106,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>
@@ -1178,7 +1192,7 @@ groups) with the same effect as Alt+click.)</note>
 <title>Select handles</title>
 <mouse><key><left-click/></key> <action>select a handle</action></mouse>
 <mouse><key><shift/><left-click/></key> <action>add handle to selection</action></mouse>
-<mouse><key><left-drag/></key> <action>select by rubberband</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>select by rubberband</action></mouse>
 <keys><key><misc f="Tab"/></key>  <action>select next handle</action></keys> 
 <keys><key><shift/><misc f="Tab"/></key> <action>select previous handle</action></keys>
 <keys><key><ctrl/>A</key>       <action>select all handles</action></keys>