diff --git a/doc/keys.xml b/doc/keys.xml
index 14a334e444bdeb3d1b2bebb5c8e3727259f7753d..aaa8adc9805e750d503d82a94aa153b33921de40 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
<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
</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>
<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>
*<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>
<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>
</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>
*<section title="Pen (Bezier) tool" color="e7f5d7">
<note>These commands change the last (red) segment of the path to straight line or curve.</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>
+
<group>
<title>Finish</title>
<keys><key><misc-wide f="Enter"/></key> <action>finish current line</action></keys>
<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>