diff --git a/doc/keys.xml b/doc/keys.xml
index 8367eecba621cb96fd91e92d26d6ba2b419cb90d..aaa8adc9805e750d503d82a94aa153b33921de40 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.47"
+>
-<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>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 handles</title>
+<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>Rotation/skew handles</title>
+<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>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>
<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>
</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 (X/Y plane)</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>draw a 3D box (extrude in Z)</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>
<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>
</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>