![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/doc/keys.xml b/doc/keys.xml
index f2900908db9d084990fe43f9dc37f883608492cc..977ff4ba7f295a30f51d3dc31e4b7ba85f325fa5 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
<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>
<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>
+<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>
<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>
<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>
<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>
<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 nodes</action></mouse>
+<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>
<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>
</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>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>
<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>
-<note>The amount of thinning/thickening is the greatest at the center of the area and drops off smoothly towards the edges.</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>
<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 stops</title>
+<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;</note>
-<note>if it was an end stop, gradient shortens or disappears</note>
+<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</title>
-<!-- TODO: restore! -->
+<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>
-<!-- TODO:
-<mouse><key><alt/><left-drag/></key> <action>sculpt handles</action></mouse>
-<note>Sculpting moves the selected handles so that the dragged handle moves all the way, the farthest handles stay put, and the intermediate handles move intermediate distances, governed by a bell-like curve</note>
- -->
</group>
<group>