update

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index b20291e0c7f542d6eca0eca7533b8a5d2de37e65..977ff4ba7f295a30f51d3dc31e4b7ba85f325fa5 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
@@ -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>
@@ -898,7 +900,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>
@@ -942,11 +945,15 @@ groups) with the same effect as Alt+click.)</note>
 *<section title="Ellipse tool" color="ffece8">
 <group>
 <title>Draw</title>
+<note>Without Alt the starting end ending point of the mouse drag mark the corners of the bounding box.</note>
+<note>With Alt the ellipse is enlarged so that its circumference passes through these two points (Ctrl+Alt is a special case; see below).</note>
 <mouse><key><left-drag/></key> <action>draw an ellipse</action></mouse>
 <mouse><key><ctrl/><left-drag/></key>  <action>make circle or integer-ratio ellipse</action></mouse>
 <note>This restricts ellipse so its height/width ratio is a whole number.</note>
 <mouse><key><shift/><left-drag/></key> <action>draw around the starting point</action></mouse>
 <note>This creates an ellipse symmetric around the starting point of the mouse drag.</note>
+<mouse><key><ctrl/><alt/><left-drag/></key>create circle passing through the starting and ending point<action></action></mouse>
+<note>This creates a perfect circle whose diameter is defined by the starting and ending point of the mouse drag.</note>
 </group>
 
 <group>
@@ -1060,6 +1067,14 @@ groups) with the same effect as Alt+click.)</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>
 </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">
@@ -1098,6 +1113,14 @@ groups) with the same effect as Alt+click.)</note>
 <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>
@@ -1166,6 +1189,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><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>