![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/doc/keys.xml b/doc/keys.xml
index 8367eecba621cb96fd91e92d26d6ba2b419cb90d..ffad4cfbdd0509bf6ff6301483253a13fcbaf36d 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
-<root xmlns="http://www.inkscape.org/namespaces/keys">
+<root xmlns="http://www.inkscape.org/namespaces/keys"
+ title="Inkscape keyboard and mouse reference"
+ ver ="0.46"
+>
-<p>This document describes the default keyboard shortcuts of Inkscape, corresponding to the
+<p>This document describes the default keyboard and mouse shortcuts of Inkscape, corresponding to the
share/keys/default.xml file in Inkscape distribution. Most (but not all) of these keys
are configurable by the user; see the default.xml file for details on how to do that.</p>
<keys><key><keyf f="F1"/></key><key>s</key> <action>Selector</action></keys>
<keys><key><misc-wide f="Space"/></key> <action>Selector (temporary)</action></keys>
<note>Space switches to the Selector tool temporarily; another Space switches back.</note>
+<note>When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag pans canvas instead of switching to Selector.</note>
<keys><key><keyf f="F2"/></key><key>n</key> <action>Node tool</action></keys>
+<keys><key><shift/><keyf f="F2"/></key><key>w</key> <action>Tweak tool</action></keys>
<keys><key><keyf f="F3"/></key><key>z</key> <action>Zoom tool</action></keys>
<keys><key><keyf f="F4"/></key><key>r</key> <action>Rectangle tool</action></keys>
+<keys><key><shift/><keyf f="F4"/></key><key>x</key> <action>3D box tool</action></keys>
<keys><key><keyf f="F5"/></key><key>e</key> <action>Ellipse/arc tool</action></keys>
<keys><key><keyf f="F6"/></key><key>p</key> <action>Freehand (Pencil) tool</action></keys>
<keys><key><shift/><keyf f="F6"/></key><key>b</key> <action>Bezier (Pen) tool</action></keys>
*<section title="Dialogs" color="f0eae7">
<group>
+<title>Open</title>
<keys><key><shift/><ctrl/>F</key> <action>Fill and Stroke</action></keys>
<keys><key><shift/><ctrl/>W</key> <action>Swatches</action></keys>
<keys><key><shift/><ctrl/>T</key> <action>Text and Font</action></keys>
<keys><key><shift/><ctrl/>L</key> <action>Layers</action></keys>
<keys><key><shift/><ctrl/>A</key> <action>Align and Distribute</action></keys>
<keys><key><shift/><ctrl/>O</key> <action>Object Properties</action></keys>
-<keys><key><shift/><ctrl/>H</key> <action>Undo history</action></keys>
+<keys><key><shift/><ctrl/>H</key> <action>Undo History</action></keys>
<keys><key><shift/><ctrl/>X</key> <action>XML Editor</action></keys>
<keys><key><shift/><ctrl/>D</key> <action>Document Preferences</action></keys>
<keys><key><shift/><ctrl/>P</key> <action>Inkscape Preferences</action></keys>
<keys><key><shift/><ctrl/>E</key> <action>Export to PNG</action></keys>
<keys><key><ctrl/>F</key> <action>Find</action></keys>
-<keys><key><shift/><alt/>B</key> <action>Trace bitmap</action></keys>
-<note>These open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus.</note>
+<keys><key><shift/><alt/>B</key> <action>Trace Bitmap</action></keys>
+<keys><key><shift/><ctrl/>7</key> <action>Path Effects</action></keys>
+<note>These shortcuts open a new dialog window if it wasn't open yet, otherwise the corresponding dialog gets focus.</note>
</group>
<group>
*<section title="Controls bar" color="f8f3e9">
<group>
+<title>Access</title>
<note>The Controls bar at the top of the document window provides different buttons and controls for each tool.</note>
<keys><key><alt/>X</key> <action>jump to the first editable field</action></keys>
-<keys><key><misc-wide f="Enter"/></key> <action>accept the new value</action></keys>
-<note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
-<keys><key><misc f="Esc"/></key> <action>cancel changes, return to canvas</action></keys>
-<note>This cancels any changes you made in a text field and returns focus to canvas.</note>
-<keys><key><ctrl/>Z</key> <action>cancel changes</action></keys>
-<note>This cancels any changes you made in a text field but you stay in the field.</note>
+</group>
+
+<group>
+<title>Navigate</title>
<keys><key><misc f="Tab"/></key> <action>jump to next field</action></keys>
<keys><key><shift/><misc f="Tab"/></key> <action>jump to previous field</action></keys>
<note>Use these to navigate between fields in the Controls bar (the value in the field you leave, if changed, is accepted).</note>
</group>
<group>
-<title>Changing values</title>
+<title>Change values</title>
<mouse><key><up/></key> <key><down/></key> <action>change value by 0.1</action></mouse>
<keys><key><misc f="PgUp"/></key><key><misc f="PgDn"/></key> <action>change value by 5.0</action></keys>
+<keys><key><misc-wide f="Enter"/></key> <action>accept the new value</action></keys>
+<note>This accepts the new value you typed in a text field and returns focus to canvas.</note>
+<keys><key><misc f="Esc"/></key> <action>cancel changes, return to canvas</action></keys>
+<note>This cancels any changes you made in a text field and returns focus to canvas.</note>
+<keys><key><ctrl/>Z</key> <action>cancel changes</action></keys>
+<note>This cancels any changes you made in a text field but you stay in the field.</note>
</group>
</section>
<mouse><key><mid-click/></key> <key><ctrl/><right-click/></key> <action>zoom in</action></mouse>
<mouse><key><shift/><mid-click/></key> <key><shift/><right-click/></key> <action>zoom out</action></mouse>
<mouse><key><ctrl/><wheel/></key> <action>zoom in or out</action></mouse>
+<note>When the "Mouse wheel zooms by default" option is on in Preferences, Ctrl+wheel scrolls instead of zooming. To zoom, use wheel without Ctrl.</note>
<mouse><key><shift/><mid-drag/></key> <action>zoom into the area</action></mouse>
<keys><key><alt/>Z</key> <action>activate zoom field</action></keys>
<note>The zoom field in the lower left corner of the window allows you to specify zoom level precisely.</note>
</group>
<group>
-<title>Scrolling (panning)</title>
+<title>Scroll (pan)</title>
<mouse><key><ctrl/><arrows/></key> <action>scroll canvas</action></mouse>
<note>Scrolling by keys is accelerated, i.e. it speeds up when you press Ctrl+arrows in quick succession, or press and hold.</note>
<mouse><key><mid-drag/></key> <action>pan canvas</action></mouse>
<mouse><key><shift/><right-drag/></key> <key><ctrl/><right-drag/></key> <action>pan canvas</action></mouse>
<mouse><key><wheel/></key> <action>scroll canvas vertically</action></mouse>
+<note>When the "Mouse wheel zooms by default" option is on in Preferences, mouse wheel zooms instead of scrolling. To scroll, use Ctrl+wheel.</note>
<mouse><key><shift/><wheel/></key> <action>scroll canvas horizontally</action></mouse>
+<note>When the "Left mouse button pans when Space is pressed" option is on in Preferences, Space+mouse drag also pans canvas.</note>
</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>
<note>These keys work both in the floating palette dialog and in the palette frame at the bottom of the window.</note>
<mouse><key><left-click/></key> <action>set fill color on selection</action></mouse>
<mouse><key><shift/><left-click/></key> <action>set stroke color on selection</action></mouse>
+<mouse><key><right-click/></key> <action>set stroke color on selection</action></mouse>
<mouse><key><left-drag/></key> <action>drag fill color to objects</action></mouse>
<mouse><key><shift/><left-drag/></key> <action>drag stroke color to objects</action></mouse>
<note>To change fill/stroke of an object by dragging color on it, that object need not be selected.</note>
<keys><key><ctrl/><alt/>V</key> <action>paste in place</action></keys>
<note>This places the clipboard objects to the original location from which they were copied.</note>
<keys><key><shift/><ctrl/>V</key> <action>paste style</action></keys>
-<note>This applies the style of the (first of the) coped object(s) to the current selection.</note>
+<note>This applies the style of the (first of the) copied object(s) to the current selection.</note>
<note>If a gradient handle (in Gradient tool) or a text span (in Text tool) are selected, they get the style instead of the entire object.</note>
+<keys><key><ctrl/>7</key> <action>paste path effect</action></keys>
+<note>This applies the path effect of the copied path to the paths/shapes in current selection.</note>
</group>
<group>
</group>
<group>
-<title>Booleans</title>
+<title>Boolean operations</title>
<keys><key><ctrl/>+</key> <action>union</action></keys>
<note>Union combines any number of objects into a single path, removing overlaps.</note>
<keys><key><ctrl/>-</key> <action>difference</action></keys>
*<section title="Selector" color="eee4dc">
<group>
-<title>Keyboard select</title>
+<title>Select (mouse)</title>
+<mouse><key><left-click/></key> <action>select an object</action></mouse>
+<note>When you left-click on an object, previous selection is deselected.</note>
+<mouse><key><shift/><left-click/></key> <action>toggle selection </action></mouse>
+<note>Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise.</note>
+<mouse><key><left-click/><left-click/></key> <action>edit the object</action></mouse>
+<note>For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool.</note>
+<note>For groups, double clicking performs the "Enter group" command (the group becomes temporary layer).</note>
+<note>Double clicking in empty space swithes to the parent layer in the hierarchy, if any.</note>
+</group>
+
+<group>
+<title>Rubberband, touch selection</title>
+<mouse><key><left-drag/></key> <action>select by rubberband</action></mouse>
+<note>Dragging around objects does "rubberband" selection; previous selection is deselected.</note>
+<mouse><key><shift/><left-drag/></key> <action>add objects to selection</action></mouse>
+<note>Normally, you need to start from an empty space to initiate a rubberband.</note>
+<note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object.</note>
+<mouse><key><alt/><left-drag/></key><key><shift/><alt/><left-drag/></key> <action>select by touch</action></mouse>
+<note>Alt+dragging over objects selects those objects that are touched by the path.</note>
+<note>To start touch selection with Alt, you must have nothing selected; otherwise use Shift+Alt.</note>
+<note>You can switch rubberband selection to touch selection and back while dragging by pressing/releasing Alt.</note>
+</group>
+
+<group>
+<title>Select (keyboard)</title>
<keys><key><misc f="Tab"/></key> <action>select next object </action></keys>
<keys><key><shift/><misc f="Tab"/></key> <action>select previous object </action></keys>
<note>These keys pick objects in their z-order (Tab cycles from bottom to top, Shift+Tab cycles from top to bottom).</note>
<keys><key><misc-wide f="Backspace"/></key><key><misc f="Del"/></key> <action>delete selection</action></keys>
</group>
-<group>
-<title>Keyboard move</title>
-<mouse><key><arrows/></key> <action>move selection by the nudge distance</action></mouse>
-<mouse><key><shift/><arrows/></key> <action>move selection by 10x nudge distance</action></mouse>
-<note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
-<mouse><key><alt/><arrows/></key> <action>move selection by 1 pixel</action></mouse>
-<mouse><key><alt/><shift/><arrows/></key> <action>move selection by 10 pixels</action></mouse>
-<note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
-</group>
-
-<group>
-<title>Keyboard scale</title>
-<keys><key>.</key> <key>></key> <action>scale selection up by the scale step</action></keys>
-<keys><key>,</key> <key><</key> <action>scale selection down by the scale step</action></keys>
-<note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
-<keys><key><ctrl/>.</key> <key><ctrl/>></key> <action>scale selection to 200%</action></keys>
-<keys><key><ctrl/>,</key> <key><ctrl/><</key> <action>scale selection to 50%</action></keys>
-<keys><key><alt/>.</key> <key><alt/>></key> <action>scale selection up by 1 pixel</action></keys>
-<keys><key><alt/>,</key> <key><alt/><</key> <action>scale selection down by 1 pixel</action></keys>
-<note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
-<note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
-</group>
-
-<group>
-<title>Keyboard rotate</title>
-<keys><key>[</key> <key>]</key> <action>rotate selection by the angle step</action></keys>
-<note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
-<keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate selection by 90 degrees</action></keys>
-<keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate selection by 1 pixel</action></keys>
-<note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
-<note>These commands use the rotation center, draggable in Selector (by default it's in geometric center).</note>
-</group>
-
-<group>
-<title>Keyboard flip</title>
-<keys><key>h</key> <action>flip selection horizontally</action></keys>
-<keys><key>v</key> <action>flip selection vertically</action></keys>
-</group>
-
-<group>
-<title>Mouse select</title>
-<mouse><key><left-click/></key> <action>select an object</action></mouse>
-<note>When you left-click on an object, previous selection is deselected.</note>
-<mouse><key><shift/><left-click/></key> <action>toggle selection </action></mouse>
-<note>Shift+click adds an object to the current selection if it was not selected, or deselects it otherwise.</note>
-<mouse><key><left-click/><left-click/></key> <action>edit the object</action></mouse>
-<note>For paths, double clicking switches to Node tool; for shapes, to corresponding shape tool; for text, to Text tool.</note>
-<note>For groups, double clicking performs the "Enter group" command (the group becomes temporary layer).</note>
-<note>Double clicking in empty space swithes to the parent layer in the hierarchy, if any.</note>
-</group>
-
<group>
<title>Select within group, select under</title>
<mouse><key><ctrl/><left-click/></key> <action>select within group</action></mouse>
</group>
<group>
-<title>Rubberband, touch selection</title>
-<mouse><key><left-drag/></key> <action>select by rubberband</action></mouse>
-<note>Dragging around objects does "rubberband" selection; previous selection is deselected.</note>
-<mouse><key><shift/><left-drag/></key> <action>add objects to selection</action></mouse>
-<note>Normally, you need to start from an empty space to initiate a rubberband.</note>
-<note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start from an object.</note>
-<mouse><key><alt/><left-drag/></key><key><shift/><alt/><left-drag/></key> <action>select by touch</action></mouse>
-<note>Alt+dragging over objects selects those objects that are touched by the path.</note>
-<note>To start touch selection with Alt, you must have nothing selected; otherwise use Shift+Alt.</note>
-<note>You can switch rubberband selection to touch selection and back while dragging by pressing/releasing Alt.</note>
-</group>
-
-<group>
-<title>Mouse move</title>
+<title>Move (mouse)</title>
<mouse><key><left-drag/></key> <action>select + move</action></mouse>
<note>Dragging an object selects it if it was not selected, then moves selection.</note>
<mouse><key><alt/><left-drag/></key> <action>move selected</action></mouse>
</group>
<group>
-<title>Mouse transform</title>
-<mouse><key><left-click/></key> <action>toggle scale/rotation handles</action></mouse>
-<mouse><key><left-drag/></key> <action>scale (scale handles)</action></mouse>
-<mouse><key><left-drag/></key> <action>rotate or skew (rotation handles)</action></mouse>
+<title>Move (keyboard)</title>
+<mouse><key><arrows/></key> <action>move selection by the nudge distance</action></mouse>
+<mouse><key><shift/><arrows/></key> <action>move selection by 10x nudge distance</action></mouse>
+<note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
+<mouse><key><alt/><arrows/></key> <action>move selection by 1 pixel</action></mouse>
+<mouse><key><alt/><shift/><arrows/></key> <action>move selection by 10 pixels</action></mouse>
+<note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
</group>
<group>
-<title>Scale handles</title>
+<title>Transform (mouse)</title>
+<mouse><key><left-click/></key><key><shift/>S</key> <action>toggle scale/rotation handles</action></mouse>
+<mouse><key><left-drag/></key> <action>scale (with scale handles)</action></mouse>
+<mouse><key><left-drag/></key> <action>rotate or skew (with rotation handles)</action></mouse>
+</group>
+
+<group>
+<title>Scale by handles</title>
<mouse><key><left-drag/></key> <action>scale</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>scale preserving aspect ratio</action></mouse>
-<!--<mouse><key><ctrl/><left-drag/></key> only smaller, keep aspect ratio--> <!-- TO BE REMOVED -->
<mouse><key><shift/><left-drag/></key> <action>symmetric transformation</action></mouse>
<note>Holding Shift while transforming makes transformation symmetric around the center of the selection.</note>
<!-- FIXME: why not disable snapping? inconsistent! -->
-<mouse><key><alt/><left-drag/></key> <action>slow movement</action></mouse>
-<note>Holding Alt while transforming makes transformation lag behind mouse movement, allowing finer changes.</note>
+<mouse><key><alt/><left-drag/></key> <action>scale by integer</action></mouse>
+<note>Hold Alt while scaling to limit scale to 2, 3, 4, etc. or 1/2, 1/3, 1/4 etc. of the initial size.</note>
+</group>
+
+<group>
+<title>Scale (keyboard)</title>
+<keys><key>.</key> <key>></key> <action>scale selection up by the scale step</action></keys>
+<keys><key>,</key> <key><</key> <action>scale selection down by the scale step</action></keys>
+<note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
+<keys><key><ctrl/>.</key> <key><ctrl/>></key> <action>scale selection to 200%</action></keys>
+<keys><key><ctrl/>,</key> <key><ctrl/><</key> <action>scale selection to 50%</action></keys>
+<keys><key><alt/>.</key> <key><alt/>></key> <action>scale selection up by 1 pixel</action></keys>
+<keys><key><alt/>,</key> <key><alt/><</key> <action>scale selection down by 1 pixel</action></keys>
+<note>The actual size increment for pixel scaling depends on zoom level. Zoom in for finer scaling.</note>
+<note>Scaling is uniform around the center, so that the size increment applies to the larger of the two dimensions.</note>
</group>
<group>
-<title>Rotation/skew handles</title>
+<title>Rotate/skew by handles</title>
<mouse><key><left-drag/></key> <action>rotate or skew</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>snap skew angle</action></mouse>
<note>Holding Ctrl when dragging a skew (non-corner) handle snaps the skew angle to angle steps (default 15 degrees).</note>
<note>Holding Ctrl when dragging a rotation (corner) handle snaps the rotation angle to angle steps (default 15 degrees).</note>
</group>
+<group>
+<title>Rotate (keyboard)</title>
+<keys><key>[</key> <key>]</key> <action>rotate selection by the angle step</action></keys>
+<note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
+<keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate selection by 90 degrees</action></keys>
+<keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate selection by 1 pixel</action></keys>
+<note>The actual angle for pixel rotation depends on zoom level. Zoom in for finer movement.</note>
+<note>These commands use the rotation center, draggable in Selector (by default it's in geometric center).</note>
+</group>
+
+<group>
+<title>Flip</title>
+<keys><key>h</key> <action>flip selection horizontally</action></keys>
+<keys><key>v</key> <action>flip selection vertically</action></keys>
+<note>If the tool is in rotate mode (rotation center visible), that center becomes the axis of flipping; otherwise it flips around geometric center of selection</note>
+</group>
+
<group>
<title>Rotation center</title>
<mouse><key><left-drag/></key> <action>move rotation center</action></mouse>
-<note>Moved rotation center remembers its position for (all) selected object(s) until you reset it.</note>
+<note>Moved rotation center remembers and saves its position for (all) selected object(s); you can reset it.</note>
<note>Dragging the center snaps it to the centerlines and bounding box edges of the selection.</note>
<mouse><key><shift/><left-drag/></key> <action>move without snapping</action></mouse>
<mouse><key><shift/><left-click/></key> <action>reset rotation center</action></mouse>
*<section title="Node tool" color="f9f1d9">
<group>
-<title>Keyboard select</title>
+<title>Select objects (mouse)</title>
+<mouse><key><left-click/></key> <action>click a non-selected object to select</action></mouse>
+<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
+<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+<note>These work the same as in Selector. The nodes or handles of the single selected object become editable.</note>
+</group>
+
+<group>
+<title>Select nodes (mouse)</title>
+<mouse><key><left-click/></key> <action>select a node</action></mouse>
+<note>Clicking on a node selects it.</note>
+<mouse><key><left-click/></key> <action>select two adjacent nodes</action></mouse>
+<note>Clicking on a selected path between the nodes selects the two nodes closest to the click point.</note>
+<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+<note>This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection.</note>
+<mouse><key><left-click/></key> <action>deselect</action></mouse>
+<note>Clicking in an empty space deselects all selected nodes. Next click will deselect the object.</note>
+</group>
+
+<group>
+<title>Rubberband selection</title>
+<mouse><key><left-drag/></key> <action>select multiple nodes</action></mouse>
+<note>Dragging around nodes does "rubberband" selection; previous node selection is deselected.</note>
+<mouse><key><shift/><left-drag/></key> <action>add nodes to selection</action></mouse>
+<note>Normally, you need to start from a point not over a path or a node to initiate a rubberband.</note>
+<note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path.</note>
+</group>
+
+<group>
+<title>Select nodes (keyboard)</title>
<keys><key><misc f="Tab"/></key> <action>select next node</action></keys>
<keys><key><shift/><misc f="Tab"/></key> <action>select previous node</action></keys>
<note>These keys select nodes within the selected path</note>
</group>
<group>
-<title>Keyboard move</title>
+<title>Grow/shrink node selection</title>
+<keys><key><misc f="PgUp"/></key> <key><misc f="PgDn"/></key> <action>grow/shrink selection (spatial)</action></keys>
+<mouse><key><wheel/></key> <action>grow/shrink selection (spatial)</action></mouse>
+<keys><key><ctrl/><misc f="PgUp"/></key> <key><ctrl/><misc f="PgDn"/></key> <action>grow/shrink selection (along path)</action></keys>
+<mouse><key><ctrl/><wheel/></key> <action>grow/shrink selection (along path)</action></mouse>
+<note>Your mouse pointer must be over a node for growing/shrinking.</note>
+<note>Each key press or wheel click selects the nearest unselected node or deselects the farthest selected node.</note>
+<note>Distance to nodes can be calculated directly (spatial mode) or along path.</note>
+</group>
+
+<group>
+<title>Move nodes (mouse)</title>
+<mouse><key><left-drag/></key> <action>move selected nodes</action></mouse>
+<mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
+<mouse><key><ctrl/><alt/><left-drag/></key> <action>move along handles</action></mouse>
+<note>This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps).</note>
+<note>If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead.</note>
+<mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
+<note>Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides.</note>
+<mouse><key><shift/><left-drag/></key> <action>drag out handle</action></mouse>
+<note>If a node has a retracted handle, dragging with Shift lets you drag it out of the node.</note>
+<mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
+<note>When dragging nodes with mouse, each Space leaves a copy of the selected object.</note>
+<note>You can press and hold Space while dragging for a nice "trail."</note>
+<mouse><key><alt/><left-drag/></key> <action>sculpt selected nodes</action></mouse>
+<note>Sculpting moves the selected nodes so that the dragged node moves all the way, the farthest selected nodes stay put;</note>
+<note>all intermediate selected nodes move intermediate distances, governed by a bell-like curve.</note>
+<note>Sculpting is pressure-sensitive with a tablet; press harder for a blunter drag profile, press lightly for a sharper profile.</note>
+<note>To stop sculpting without losing the pressure-sensitive profile, release Alt first and then lift the pen.</note>
+</group>
+
+<group>
+<title>Move nodes (keyboard)</title>
<mouse><key><arrows/></key> <action>move selected node(s) by the nudge distance</action></mouse>
<mouse><key><shift/><arrows/></key> <action>move selected node(s) by 10x nudge distance</action></mouse>
<note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
</group>
<group>
-<title>Keyboard handle scale (1 node selected)</title>
+<title>Move node handle (mouse)</title>
+<mouse><key><left-drag/></key> <action>move a node handle</action></mouse>
+<mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
+<note>The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars.</note>
+<mouse><key><shift/><left-drag/></key> <action>rotate both handles</action></mouse>
+<mouse><key><alt/><left-drag/></key> <action>lock the handle length</action></mouse>
+<note>Ctrl, Shift, Alt can be combined when dragging handles.</note>
+<mouse><key><ctrl/><left-click/></key> <action>retract the handle</action></mouse>
+<note>Retracted handle is zero length; use Shift+drag to drag it back out.</note>
+</group>
+
+<group>
+<title>Scale handle (1 node selected)</title>
<keys><key><</key> <key>></key> <action>contract/expand both handles by scale step</action></keys>
<note>The default scale step is 2 px (SVG pixel units, not screen pixels). May apply to more than one node.</note>
<keys>
</group>
<group>
-<title>Keyboard handle rotate (1 node selected)</title>
+<title>Rotate handle (1 node selected)</title>
<keys><key>[</key> <key>]</key> <action>rotate both handles by the angle step</action></keys>
<note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise. May apply to more than one node.</note>
<keys><key><left/><ctrl/>[</key> <key><left/><ctrl/>]</key> <action>rotate left handle by the angle step</action></keys>
<group>
-<title>Keyboard scale (>1 nodes selected)</title>
-<note>These commands scale the selected nodes as if they were an "object", around the center of that object.</note>
+<title>Scale nodes (>1 nodes selected)</title>
+<note>These commands scale the selected nodes as if they were an "object".</note>
+<note>If mouse is over a node, that node becomes the axis of scaling; otherwise it scales around geometric center of selected nodes.</note>
<keys><key>.</key> <key>></key> <action>scale nodes up by the scale step</action></keys>
<keys><key>,</key> <key><</key> <action>scale nodes down by the scale step</action></keys>
<note>The default scale step is 2 px (SVG pixel units, not screen pixels).</note>
</group>
<group>
-<title>Keyboard rotate (>1 nodes selected)</title>
-<note>These commands rotate the selected nodes as if they were an "object", around the center of that object.</note>
+<title>Rotate nodes (>1 nodes selected)</title>
+<note>These commands rotate the selected nodes as if they were an "object".</note>
+<note>If mouse is over a node, that node becomes the axis of rotation; otherwise it rotates around geometric center of selected nodes.</note>
<keys><key>[</key> <key>]</key> <action>rotate nodes by the angle step</action></keys>
<note>The default angle step is 15 degrees. ] rotates clockwise, [ rotates counterclockwise.</note>
<keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate nodes by 1 pixel</action></keys>
</group>
<group>
-<title>Keyboard flip (>1 nodes selected)</title>
+<title>Flip nodes (>1 nodes selected)</title>
<note>These commands flip the selected nodes as if they were an "object", around the center of that object.</note>
<keys><key>h</key> <action>flip nodes horizontally</action></keys>
<keys><key>v</key> <action>flip nodes vertically</action></keys>
+<note>If mouse is over a node, that node becomes the axis of flipping; otherwise it flips around geometric center of selected nodes</note>
</group>
-
<group>
<title>Change segment(s)</title>
<keys><key><shift/>L</key> <action>make line</action></keys>
</group>
-->
-<group>
-<title>Mouse select: objects</title>
-<mouse><key><left-click/></key> <action>click a non-selected object to select</action></mouse>
-<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
-<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
-<note>These work the same as in Selector. The nodes or handles of the single selected object become editable.</note>
-</group>
<group>
-<title>Mouse select: nodes</title>
-<mouse><key><left-click/></key> <action>select a node</action></mouse>
-<note>Clicking on a node selects it.</note>
-<mouse><key><left-click/></key> <action>select two adjacent nodes</action></mouse>
-<note>Clicking on a selected path between the nodes selects the two nodes closest to the click point.</note>
-<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
-<note>This adds/removes a node (if clicked on node) or two nodes (if clicked on path) to/from the node selection.</note>
-<mouse><key><left-click/></key> <action>deselect</action></mouse>
-<note>Clicking in an empty space deselects all selected nodes. Next click will deselect the object.</note>
-</group>
-
-<group>
-<title>Rubberband</title>
-<mouse><key><left-drag/></key> <action>select multiple nodes</action></mouse>
-<note>Dragging around nodes does "rubberband" selection; previous node selection is deselected.</note>
-<mouse><key><shift/><left-drag/></key> <action>add nodes to selection</action></mouse>
-<note>Normally, you need to start from a point not over a path or a node to initiate a rubberband.</note>
-<note>However, if you press Shift before dragging, Inkscape will do rubberband selection even if you start over the path.</note>
-
-</group>
-
-<group>
-<title>Node move (mouse)</title>
-<mouse><key><left-drag/></key> <action>move selected nodes</action></mouse>
-<mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
-<mouse><key><ctrl/><alt/><left-drag/></key> <action>move along handles</action></mouse>
-<note>This restricts movement to the directions of the node's handles, their continuations and perpendiculars (total 8 snaps).</note>
-<note>If the node has straight lines on one or both sides, this will snap it to these lines' directions and perpendiculars instead.</note>
-<mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
-<note>Snapping nodes is enabled in Document Preferences. By default, only bounding box of objects snaps to grid/guides.</note>
-<mouse><key><shift/><left-drag/></key> <action>drag out handle</action></mouse>
-<note>If a node has a retracted handle, dragging with Shift lets you drag it out of the node.</note>
-<mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
-<note>When dragging nodes with mouse, each Space leaves a copy of the selected object.</note>
-<note>You can press and hold Space while dragging for a nice "trail."</note>
-</group>
-
-<group>
-<title>Node handles</title>
-<mouse><key><left-drag/></key> <action>move a node handle</action></mouse>
-<mouse><key><ctrl/><left-drag/></key> <action>snap the handle to angle steps</action></mouse>
-<note>The default angle step is 15 degrees. This also snaps to the handle's original angle, its continuation and perpendiculars.</note>
-<mouse><key><shift/><left-drag/></key> <action>rotate both handles</action></mouse>
-<mouse><key><alt/><left-drag/></key> <action>lock the handle length</action></mouse>
-<note>Ctrl, Shift, Alt can be combined when dragging handles.</note>
-<mouse><key><ctrl/><left-click/></key> <action>retract the handle</action></mouse>
-<note>Retracted handle is zero length; use Shift+drag to drag it back out.</note>
-</group>
-
-<group>
-<title>Reversing</title>
+<title>Reverse</title>
<keys><key><shift/>r</key> <action>reverse path direction</action></keys>
</group>
<group>
-<title>Editing shapes</title>
+<title>Edit shapes</title>
<note>Node tool can also drag the handles of shapes (rectangles, ellipses, stars, spirals). Click on a shape to select it.</note>
<note>See the corresponding shape tools for their editing shortcuts, all of which also work in node tool.</note>
</group>
-
<group>
<title>Cancel</title>
<keys><key><misc f="Esc"/></key> <action>cancel rubberband or move</action></keys>
<column>
+*<section title="Tweak tool" color="f2f1ea">
+<group>
+<title>Operation</title>
+<mouse><key><left-drag/></key> <action>act on selected paths in the current mode</action></mouse>
+<mouse><key><ctrl/><left-drag/></key> <action>act temporarily switching to shrink mode</action></mouse>
+<mouse><key><ctrl/><shift/><left-drag/></key> <action>act temporarily switching to grow mode</action></mouse>
+<note>The amount of tweaking action is the greatest at the center of the circular area and drops off smoothly towards the edges.</note>
+</group>
+
+<group>
+<title>Modes</title>
+<keys><key><shift/>p</key> <action>push mode</action></keys>
+<keys><key><shift/>s</key> <action>shrink (inset) mode</action></keys>
+<keys><key><shift/>g</key> <action>grow (outset) mode</action></keys>
+<keys><key><shift/>a</key> <action>attract mode</action></keys>
+<keys><key><shift/>e</key> <action>repel mode</action></keys>
+<keys><key><shift/>r</key> <action>roughen mode</action></keys>
+<keys><key><shift/>c</key> <action>color paint mode</action></keys>
+<keys><key><shift/>j</key> <action>color jitter mode</action></keys>
+</group>
+
+<group>
+<title>Parameters</title>
+<mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust brush width by 1</action></mouse>
+<mouse><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>set brush width to 1 / 100</action></mouse>
+<mouse><key><up/></key> <key><down/></key> <action>adjust tweaking force</action></mouse>
+<note>Width and force can be adjusted while drawing. With a pressure-sensitive tablet, force also depends on pen pressure.</note>
+</group>
+
+</section>
*<section title="Rectangle tool" color="ebf1fd">
<group>
-<title>Drawing</title>
+<title>Draw</title>
<mouse><key><left-drag/></key> <action>draw a rectangle</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>make a square or integer-ratio rectangle</action></mouse>
<note>This restricts rectangle 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 a rectangle symmetric around the starting point of the mouse drag.</note>
</group>
+
<group>
-<title>Editing</title>
-<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
+<title>Select</title>
+<mouse><key><left-click/></key> <action>click to select</action></mouse>
<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
-<mouse><key><left-drag/></key> <action>drag a handle to resize or round corners</action></mouse>
-<note>Initially, the two rounding handles are in the top right corner; two resize handles are in top left and bottom right corners.</note>
-<mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio (resize handles)</action></mouse>
-<mouse><key><ctrl/><left-drag/></key> <action>lock the corner circular (rounding handles)</action></mouse>
+<note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
+<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
+</group>
+
+<group>
+<title>Resize by handles</title>
+<mouse><key><left-drag/></key> <action>drag a square handle to resize</action></mouse>
+<note>Initially, the two resize (square) handles are in top left and bottom right corners.</note>
<note>Resize handles change the width and height of the rectangle in its own coordinate system, before any transforms are applied.</note>
-<note>When rounding corners, dragging only one rounding handle (with the other at the corner) keeps the corner circular.</note>
-<note>You can drag both handles for an elliptic rounded corner, or drag one with Ctrl to make sure the other one is synchronized.</note>
+<mouse><key><ctrl/><left-drag/></key> <action>lock width, height, or ratio</action></mouse>
+</group>
+
+<group>
+<title>Round corners by handles</title>
+<mouse><key><left-drag/></key> <action>drag a circular handle to round corners</action></mouse>
+<note>Initially, the two rounding handles are in the top right corner of the rectangle.</note>
+<mouse><key><ctrl/><left-drag/></key> <action>lock the corner circular</action></mouse>
+<mouse><key><ctrl/><left-click/></key> <action>set the corner circular</action></mouse>
+<note>When rounding corners, dragging one rounding handle keeps the corner circular if the other remains at the corner.</note>
+<note>You can drag both handles for an elliptic rounded corner, or drag/click one with Ctrl to make it circular again.</note>
+<mouse><key><shift/><left-click/></key> <action>remove corner rounding</action></mouse>
+</group>
+</section>
+
+*<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>
+</group>
+
+<group>
+<title>Select</title>
+<mouse><key><left-click/></key> <action>click to select</action></mouse>
+<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
+<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
</group>
+
+<group>
+<title>Edit by handles</title>
+<note>All editing operations occur "in perspective", i.e., either along PLs or within planes spanned by these.</note>
+<mouse><key><left-drag/></key> <action>resize/move box</action></mouse>
+<note>The four front handles and the center normally move withing the XY-plane, the four rear handles along the Z-axis.</note>
+<mouse><key><shift/><left-drag/></key> <action>resize/move (with handle behaviour swapped)</action></mouse>
+<mouse><key><ctrl/><left-drag/></key> <action>resize/move (handles snap to axes or diagonals)</action></mouse>
+</group>
+
+<group>
+<title>Edit perspectives</title>
+<note>In what follows, we use the abbreviations VP = vanishing point, PL = perspective line.</note>
+<mouse><key><left-drag/></key> <action>drag square handles to move the VPs</action></mouse>
+<keys><key>[</key> <key>]</key> <action>rotate X-PLs (if parallel) by the angle step</action></keys>
+<note>The default angle step is 15 degrees. ],),} rotate clockwise, [,(,{ rotate counterclockwise.</note>
+<keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate X-PLs (if parallel) by 1 pixel</action></keys>
+<keys><key>(</key> <key>)</key> <action>rotate Y-PLs (if parallel) by the angle step</action></keys>
+<keys><key><alt/>(</key> <key><alt/>)</key> <action>rotate Y-PLs (if parallel) by 1 pixel</action></keys>
+<keys><key>{</key> <key>}</key> <action>rotate Z-PLs (if parallel) by the angle step</action></keys>
+<keys><key><alt/>{</key> <key><alt/>}</key> <action>rotate Z-PLs (if parallel) by 1 pixel</action></keys>
+</group>
+
+<group>
+<title>Visual appearance</title>
+<keys><key>L</key> <action>toggle visibility of PLs</action></keys>
+<keys><key>A</key> <action>toggle PLs to all corners/only front corners</action></keys>
+</group>
+
</section>
*<section title="Ellipse tool" color="ffece8">
<group>
-<title>Drawing</title>
+<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>
-<title>Editing</title>
-<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
+<title>Select</title>
+<mouse><key><left-click/></key> <action>click to select</action></mouse>
<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
-<mouse><key><left-drag/></key> <action>drag a handle to resize, make arc or segment</action></mouse>
-<note>Initially, the two arc/segment handles are in the rightmost point; two resize handles are at the topmost and leftmost points.</note>
+<note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
+<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
+</group>
+
+<group>
+<title>Edit by handles</title>
+<mouse><key><left-drag/></key> <action>resize, make arc or segment</action></mouse>
+<note>Initially, the two resize handles are at the topmost and leftmost points; the two arc/segment handles are in the rightmost point.</note>
<mouse><key><ctrl/><left-drag/></key> <action>lock circle (resize handles)</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>snap to angle steps (arc/segment handles)</action></mouse>
<note>Resize handles change the width and height of the ellipse in its own coordinate system, before any transforms are applied.</note>
<note>The default angle step is 15 degrees.</note>
-<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
+<mouse><key><shift/><left-click/></key> <action>make whole (arc/segment handles)</action></mouse>
</group>
</section>
*<section title="Star tool" color="f8f7d5">
<group>
-<title>Drawing</title>
+<title>Draw</title>
<mouse><key><left-drag/></key> <action>draw a star</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>snap star to angle steps</action></mouse>
<note>The default angle step is 15 degrees.</note>
</group>
+
<group>
-<title>Editing</title>
-<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
-<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
+<title>Select</title>
+<mouse><key><left-click/></key> <action>click to select</action></mouse>
+<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+<note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
+<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
+</group>
+
+<group>
+<title>Edit by handles</title>
<mouse><key><left-drag/></key> <action>drag a handle to vary the star shape</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>keep star rays radial (no skew)</action></mouse>
<mouse><key><shift/><left-drag/></key> <action>round the star</action></mouse>
<mouse><key><shift/><left-click/></key> <action>remove rounding</action></mouse>
<mouse><key><alt/><left-drag/></key> <action>randomize the star</action></mouse>
<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>remove randomization</action></mouse>
-<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
</group>
</section>
*<section title="Spiral tool" color="f3f3f3">
<group>
-<title>Drawing</title>
+<title>Draw</title>
<mouse><key><left-drag/></key> <action>draw a spiral</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>snap spiral to angle steps</action></mouse>
<note>The default angle step is 15 degrees.</note>
</group>
+
<group>
-<title>Editing</title>
-<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
-<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
+<title>Select</title>
+<mouse><key><left-click/></key> <action>click to select</action></mouse>
+<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>select under</action></mouse>
<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+<note>In this tool, selecting by click disregards any grouping (i.e. acts as clicking with Ctrl in Selector)</note>
+<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
+</group>
+
+<group>
+<title>Edit by handles</title>
<mouse><key><left-drag/></key> <action>roll/unroll from inside (inner handle)</action></mouse>
<note>Dragging the inner handle adjusts the "inner radius" parameter.</note>
<mouse><key><alt/><left-drag/></key> <action>converge/diverge (inner handle)</action></mouse>
<mouse><key><ctrl/><left-drag/></key> <action>snap handles to angle steps</action></mouse>
<note>The default angle step is 15 degrees. This works for both handles.</note>
-
-<keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
</group>
</section>
<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>
</section>
<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>
</group>
</section>
-*<section title="Calligraphy" color="e9dfef">
+*<section title="Calligraphy tool" color="e9dfef">
<group>
<mouse><key><left-drag/></key> <action>draw a calligraphic line</action></mouse>
<mouse><key><shift/><left-drag/></key> <action>add to selected path</action></mouse>
<note>Drawing with Shift unions the newly created stroke with the previous selection</note>
<mouse><key><ctrl/><left-drag/></key> <action>track a guide path</action></mouse>
<note>Drawing with Ctrl tracks a selected guide path at the constant distance</note>
-<mouse><key><alt/><left-drag/></key> <action>thin selected paths</action></mouse>
-<mouse><key><shift/><alt/><left-drag/></key> <action>thicken selected paths</action></mouse>
-<note>Dragging with Alt or Shift+Alt over selected paths makes them thinner/thicker where you drag</note>
<mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust pen width by 1</action></mouse>
<mouse><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>set pen width to 1 or 100</action></mouse>
<mouse><key><up/></key> <key><down/></key> <action>adjust pen angle</action></mouse>
<mouse><key><left-click/></key> <action>fill a bounded area</action></mouse>
<mouse><key><shift/><left-click/></key> <action>add to selected path</action></mouse>
<note>Clicking with Shift unions the newly created fill with the previous selection</note>
+<mouse><key><left-drag/></key> <action>fill from each point</action></mouse>
+<note>From each point, the fill spreads to the neighbors with the colors similar to that point.</note>
+<note>This can be used to fill an area currently filled with a gradient or blur.</note>
+<mouse><key><alt/><left-drag/></key> <action>fill from each point same as initial point</action></mouse>
+<note>From each point, the fill spreads to the neighbors with the colors similar to the initial point of the drag.</note>
+<note>This can be used to fill several disjoint bounded areas by starting in one and dragging over all of the areas.</note>
<mouse><key><ctrl/><left-click/></key> <action>set fill color</action></mouse>
<mouse><key><shift/><ctrl/><left-click/></key> <action>set stroke color</action></mouse>
-<note>Ctrl+clicking an object sets its fill (or stroke with Shift) to the tool's current style</note>
+<note>Ctrl+clicking an object sets its fill (or stroke with Shift) to the tool's current style; the object need not be selected</note>
</group>
</section>
*<section title="Gradient tool" color="e9f3e7">
+
<group>
-<title>Creating gradients</title>
+<title>Select objects</title>
+<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
+<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
+<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+</group>
+
+<group>
+<title>Create gradients</title>
<mouse><key><left-drag/></key> <action>create gradient</action></mouse>
<note>This creates gradient on selected objects. The Controls bar lets you select linear/radial and fill/stroke for the new gradient.</note>
<mouse><key><left-click/><left-click/></key> <action>create default gradient</action></mouse>
</group>
<group>
-<title>Handles</title>
+<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>
+<keys><key><misc f="Esc"/></key> <action>deselect all handles</action></keys>
+<note>Single click outside all handles also deselects all handles.</note>
+</group>
+
+<group>
+<title>Create/delete intermediate stops</title>
+<mouse><key><ctrl/><alt/><left-click/></key> <action>create a stop</action></mouse>
+<mouse><key><left-click/><left-click/></key> <action>create a stop</action></mouse>
+<note>Ctrl+Alt+click or double click on a gradient line creates a new intermediate stop</note>
+<mouse><key><ctrl/><alt/><left-click/></key> <action>delete stop</action></mouse>
+<note>Ctrl+Alt+click on a stop's handle deletes the stop; if it was an end stop, gradient shortens or disappears</note>
+<keys><key><misc f="Ins"/></key> <action>insert new stop(s)</action></keys>
+<note>This adds new stop(s) in the middle(s) of selected segment(s), so it requires that more than two adjacent handles be selected.</note>
+<keys><key><misc f="Del"/></key> <action>delete selected stops</action></keys>
+</group>
+
+<group>
+<title>Move handles/stops</title>
+<mouse><key><left-drag/></key> <action>move selected handle(s)</action></mouse>
+<mouse><key><ctrl/><left-drag/></key> <action>move stops in 1/10 range increments</action></mouse>
+<note>Ctrl+dragging selected intermediate stops moves them snapping to 1/10 steps of the available range</note>
+<mouse><key><alt/><left-drag/></key> <action>sculpt selected stops</action></mouse>
+<note>Sculpting moves the selected intermediate stops depending on how close each one is to the stop being dragged, using a smooth bell-like curve similar to the node sculpting feature in Node tool.</note>
<mouse><key><arrows/></key> <action>move selected handle by the nudge distance</action></mouse>
<mouse><key><shift/><arrows/></key> <action>move selected handle by 10x nudge distance</action></mouse>
<note>The default nudge distance is 2 px (SVG pixel units, not screen pixels).</note>
<mouse><key><alt/><arrows/></key> <action>move selected handle by 1 pixel</action></mouse>
<mouse><key><alt/><shift/><arrows/></key> <action>move selected handle by 10 pixels</action></mouse>
+<note>If at least one end handle is selected, arrow keys move the end handle to move or resize the gradient line.</note>
+<note>If only mid stops are selected, arrow keys move the selected stops along the gradient line.</note>
<note>The actual distance for pixel movements depends on zoom level. Zoom in for finer movement.</note>
-<keys><key><misc f="Esc"/></key> <action>deselect handle</action></keys>
-<mouse><key><left-click/><left-click/></key> <action>open gradient editor</action></mouse>
-<note>Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list.</note>
</group>
<group>
-<title>Reversing</title>
+<title>Reverse</title>
<keys><key><shift/>r</key> <action>reverse gradient definition</action></keys>
<note>This mirrors the stop positions of the current gradient without moving the gradient handles.</note>
</group>
+<!-- TODO: remove! -->
<group>
-<title>Mouse select</title>
-<mouse><key><left-click/></key> <action>click an object to select</action></mouse>
-<mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
-<mouse><key><shift/><left-click/></key> <action>toggle selection</action></mouse>
+<title>Gradient editor</title>
+<mouse><key><left-click/><left-click/></key> <action>open gradient editor</action></mouse>
+<note>Double clicking a gradient handle opens the Gradient Editor with that gradient and the clicked handle chosen in the stops list.</note>
</group>
+
</section>
*<section title="Text tool" color="eefdf3">
<group>
-<title>Selecting/creating</title>
+<title>Select/create</title>
<mouse><key><left-click/></key> <action>create/select a text object</action></mouse>
<!--<keys><key>letters, digits, space, ...</key> <action>type text in a text object</action></keys>-->
<note>Clicking in an empty space or on a non-text creates a text object; now you can type your text.</note>
</group>
<group>
-<title>Text navigation</title>
+<title>Navigate in text</title>
<mouse><key><arrows/></key> <action>move cursor by one character</action></mouse>
<mouse><key><ctrl/><left-arrow/></key> <key><ctrl/><right-arrow/></key> <action>move cursor by one word</action></mouse>
<mouse><key><ctrl/><up-arrow/></key> <key><ctrl/><down-arrow/></key> <action>move cursor by one paragraph</action></mouse>
</group>
<group>
-<title>Editing text</title>
+<title>Edit text</title>
<note>To type + and - characters, use the main keyboard; keypad + and - are reserved for zoom (unless NumLock is on).</note>
<keys><key><misc-wide f="Enter"/></key> <action>start a new line or paragraph</action></keys>
<note>Enter in regular text creates new line; in flowed text it creates a new paragraph</note>
</group>
<group>
-<title>Selecting text</title>
+<title>Select text</title>
<mouse><key><left-drag/></key> <action>select text</action></mouse>
<note>Left-dragging over a text object selects a text span.</note>
<mouse><key><shift/><arrows/></key> <action>select text by character</action></mouse>
</group>
<group>
-<title>Styling selection</title>
+<title>Style selection</title>
<keys><key><ctrl/>B</key> <action>make selection bold</action></keys>
<keys><key><ctrl/>I</key> <action>make selection italic</action></keys>
<note>Also, you can use the Text&Font or Fill&Stroke dialogs to assign any style to text selection.</note>
</group>
<group>
-<title>Rotating</title>
+<title>Rotate</title>
<keys><key><ctrl/>[</key> <key><ctrl/>]</key> <action>rotate character(s) by 90 degrees</action></keys>
<keys><key><alt/>[</key> <key><alt/>]</key> <action>rotate character(s) by 1 pixel</action></keys>
<note>These commands rotate the next character (without selection) or all characters in the selection (with selection).</note>