![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/doc/keys.xml b/doc/keys.xml
index f3f0d87459da8da8c7508d91d4d2e5ec585c8077..20258dcf5b96c2a299df2e0764812c2ffc15ec37 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
<root xmlns="http://www.inkscape.org/namespaces/keys"
title="Inkscape keyboard and mouse reference"
- ver ="0.46"
+ ver ="0.47"
>
<p>This document describes the default keyboard and mouse shortcuts of Inkscape, corresponding to the
<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><keyf f="F6"/></key><key>p</key> <action>Pencil (Freehand) tool</action></keys>
+<keys><key><shift/><keyf f="F6"/></key><key>b</key> <action>Pen (Bezier) tool</action></keys>
<keys><key><ctrl/><keyf f="F6"/></key><key>c</key> <action>Calligraphy tool</action></keys>
+<keys><key><shift/><keyf f="E"/></key><key>c</key> <action>Eraser tool</action></keys>
<keys><key><shift/><keyf f="F7"/></key><key>u</key> <action>Paint Bucket tool</action></keys>
<keys><key><ctrl/><keyf f="F1"/></key><key>g</key> <action>Gradient tool</action></keys>
<keys><key><keyf f="F7"/></key><key>d</key> <action>Dropper tool</action></keys>
<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>
+<note>The zoom field in the lower right corner of the window allows you to specify zoom level precisely.</note>
</group>
<group>
</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>
+<mouse><key><left-drag/></key> <action>drag a guide to move it</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>drag a guide (not near anchor) to rotate it</action></mouse>
+<mouse><key><ctrl/><shift/><left-drag/></key> <action>rotate guide with angle snapping</action></mouse>
+<mouse><key><ctrl/><left-click/></key> <action>delete guide</action></mouse>
<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><right-click/></key> <action>open pop-up menu</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>
<group>
<keys><key><ctrl/>N</key> <action>create new document</action></keys>
-<keys><key><ctrl/>O</key> <action>open an SVG document</action></keys>
+<keys><key><ctrl/>O</key> <action>open a document</action></keys>
<keys><key><shift/><ctrl/>E</key> <action>export to PNG</action></keys>
-<keys><key><ctrl/>I</key> <action>import bitmap or SVG</action></keys>
+<keys><key><ctrl/>I</key> <action>import bitmap or vector</action></keys>
<keys><key><ctrl/>P</key> <action>print document</action></keys>
<keys><key><ctrl/>S</key> <action>save document</action></keys>
<keys><key><shift/><ctrl/>S</key> <action>save under a new name</action></keys>
</section>
*<section title="Layers" color="f6f9d9">
+
+<group>
+<keys><key><shift/><ctrl/><misc f="N"/></key> <action>create new layer</action></keys>
+</group>
+
<group>
<keys><key><shift/><misc f="PgUp"/></key> <action>move to layer above</action></keys>
<keys><key><shift/><misc f="PgDn"/></key> <action>move to layer below</action></keys>
<group>
<title>Clipboard</title>
<keys><key><ctrl/>C</key> <action>copy selection</action></keys>
-<note>This places a copy of the selection to the Inkscape clipboard. Text from text objects is also placed onto the system clipboard.</note>
<keys><key><ctrl/>X</key> <action>cut selection</action></keys>
-<note>This works the same as "copy selection" followed by deleting the selection.</note>
<keys><key><ctrl/>V</key> <action>paste clipboard</action></keys>
<note>This places the clipboard objects at the mouse cursor, or at the center of the window if mouse is outside the canvas.</note>
-<note>When editing text with the text tool, this pastes the text from the system clipboard into the current text object.</note>
+<note>When editing text with the text tool, this pastes the text from the clipboard into the current text object.</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>
+<note>This places the clipboard objects into 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) 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>
<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>
+<note>For groups, double clicking performs the "Enter group" command (the group becomes a temporary layer).</note>
+<note>Double clicking in empty space switches to the parent layer in the hierarchy, if any.</note>
</group>
<group>
<note>On Linux, Alt+click and Alt+drag may be reserved by the window manager. Reconfigure it so you can use them in Inkscape.</note>
<mouse><key><ctrl/><left-drag/></key> <action>restrict movement to horizontal or vertical</action></mouse>
<mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
-<note>This temporaily disables snapping to grid or guides when you are dragging with grid or guides on.</note>
+<note>This temporarily disables snapping to grid or guides when you are dragging with grid or guides on.</note>
<mouse><key><left-drag/><misc-wide f="Space"/></key> <action>drop a copy</action></mouse>
<note>When dragging or transforming 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>
<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>
+<keys><key><shift/>A</key> <action>make auto</action></keys>
+<mouse><key><ctrl/><left-click/></key> <action>toggle smooth/cusp/symmetric/auto</action></mouse>
</group>
<group>
<note>See the corresponding shape tools for their editing shortcuts, all of which also work in node tool.</note>
</group>
+<group>
+<title>Edit fills and path effects</title>
+<note>Node tool can also edit the handles of a pattern fill, gradient fill, and the editable handles of path effects.</note>
+</group>
+
<group>
<title>Cancel</title>
<keys><key><misc f="Esc"/></key> <action>cancel rubberband or move</action></keys>
<group>
<title>Operation</title>
<mouse><key><left-drag/></key> <action>act on selected paths in the current mode</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>reverse current mode (when applicable)</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>
<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/>m</key><key><shift/>0</key> <action>move mode</action></keys>
+<keys><key><shift/>i</key><key><shift/>1</key> <action>move in/out mode</action></keys>
+<note>Drag moves objects inwards to cursor, drag with Shift moves outwards from cursor</note>
+<keys><key><shift/>z</key><key><shift/>2</key> <action>move jitter mode</action></keys>
+<keys><key><shift/><</key><key><shift/>></key><key><shift/>3</key> <action>scale mode</action></keys>
+<note>Drag scales objects down, drag with Shift scales up</note>
+<keys><key><shift/>[</key><key><shift/>]</key><key><shift/>4</key> <action>rotate mode</action></keys>
+<note>Drag rotates objects clockwise, drag with Shift, counterclockwise</note>
+<keys><key><shift/>d</key><key><shift/>5</key> <action>duplicate/delete mode</action></keys>
+<note>Drag randomly duplicates objects, drag with Shift randomly deletes</note>
+<keys><key><shift/>p</key><key><shift/>6</key> <action>push path mode</action></keys>
+<keys><key><shift/>s</key><key><shift/>7</key> <action>shrink/grow path mode</action></keys>
+<note>Drag insets paths, drag with Shift outsets</note>
+<keys><key><shift/>a</key><key><shift/>8</key> <action>attract/repel path mode</action></keys>
+<note>Drag attracts paths to cursor, drag with Shift repels</note>
+<keys><key><shift/>r</key><key><shift/>9</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>
+<keys><key><shift/>b</key> <action>blur mode</action></keys>
</group>
<group>
*<section title="3D box tool" color="cff4e2">
<group>
<title>Draw</title>
-<mouse><key><left-drag/></key> <action>draw a 3D box (use shift to extrude in Z direction)</action></mouse>
+<mouse><key><left-drag/></key> <action>draw a 3D box (X/Y plane)</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>draw a 3D box (extrude in Z)</action></mouse>
</group>
<group>
<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>
+<note>All editing operations occur "in perspective", i.e., either along perspective lines 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>
+<note>The four front handles and the center normally move within 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>
<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 and 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>add to selected path</action></mouse>
<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>
+<note>Shift also temporarily disables snapping to grid or guides when you are drawing with grid or guides on.</note>
+<mouse><key><alt/><left-drag/></key> <action>averaging draw (sketch mode)</action></mouse>
+</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>
<note>If no path is being created, this starts a new path.</note>
<mouse><key><shift/><left-click/></key> <action>add to selected path</action></mouse>
<note>If a path is selected, Shift+clicking anywhere starts a new subpath instead of a new independent path.</note>
-<mouse><key><left-drag/></key> <action>create a bezier node with two handles</action></mouse>
+<mouse><key><left-drag/></key> <action>create a Bezier node with two handles</action></mouse>
<mouse><key><shift/><left-drag/></key> <action>move only one handle</action></mouse>
<!-- FIXME: also disables snapping! another conflict -->
<note>This moves only one handle (instead of both) while creating a node, making it cusp.</note>
<note>These commands change the last (red) segment of the path to straight line or curve.</note>
</group>
+<group>
+<title>Create dots</title>
+<mouse><key><ctrl/><left-click/></key> <action>create a dot</action></mouse>
+<note>This creates a small circle. Its size (relative to the current stroke width) can be set in Preferences.</note>
+<mouse><key><shift/><ctrl/><left-click/></key> <action>create a double-sized dot</action></mouse>
+<mouse><key><alt/><ctrl/><left-click/></key> <action>create a random-sized dot</action></mouse>
+</group>
+
<group>
<title>Finish</title>
<keys><key><misc-wide f="Enter"/></key> <action>finish current line</action></keys>
<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><alt/><left-drag/></key> <action>subtract from selected path</action></mouse>
+<note>Drawing with Alt subtracts the newly created stroke from 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><left-arrow/></key> <key><right-arrow/></key> <action>adjust pen width by 1</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><left-drag/></key> <action>select by rubberband</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>select by rubberband</action></mouse>
<keys><key><misc f="Tab"/></key> <action>select next handle</action></keys>
<keys><key><shift/><misc f="Tab"/></key> <action>select previous handle</action></keys>
<keys><key><ctrl/>A</key> <action>select all handles</action></keys>
<mouse><key><alt/><left-click/></key> <key><alt/><left-drag/></key> <key><ctrl/><alt/><left-click/></key> <key><ctrl/><alt/><left-drag/></key> <action>pick inverse color</action></mouse>
<note>If Alt is pressed, picking color (with or without Shift, by click or by drag) picks the inverse of the color.</note>
<keys><key><ctrl/>C</key> <action>copy color</action></keys>
-<note>This copies the color under cursor to the system clipboard, as text in RRGGBBAA format (8 hex digits).</note>
+<note>This copies the color under cursor to the clipboard, as text in RRGGBBAA format (8 hex digits).</note>
</group>
</section>
<mouse><key><ctrl/><up-arrow/></key> <key><ctrl/><down-arrow/></key> <action>move cursor by one paragraph</action></mouse>
<keys><key><misc f="Home"/></key> <key><misc f="End"/></key> <action>go to beginning/end of line</action></keys>
<keys><key><ctrl/><misc f="Home"/></key> <key><ctrl/><misc f="End"/></key> <action>go to beginning/end of text</action></keys>
-<note>All these commands cancel current text selection, if any.</note>
+<keys><key><misc f="PgUp"/></key> <key><misc f="PgDn"/></key> <action>move cursor by one screen</action></keys>
+<note>All these commands cancel current text selection, if any. Use them with Shift to extend selection instead.</note>
</group>
<group>
<mouse><key><ctrl/><shift/><arrows/></key> <action>select text by word</action></mouse>
<keys><key><shift/><misc f="Home"/></key> <key><shift/><misc f="End"/></key> <action>select to beginning/end of line</action></keys>
<keys><key><ctrl/><shift/><misc f="Home"/></key> <key><ctrl/><shift/><misc f="End"/></key> <action>select to beginning/end of text</action></keys>
+<keys><key><shift/><misc f="PgUp"/></key> <key><shift/><misc f="PgDn"/></key> <action>select one screen up/down</action></keys>
<mouse><key><left-click/><left-click/></key> <action>select word</action></mouse>
<mouse><key><left-click/><left-click/><left-click/></key> <action>select line</action></mouse>
<keys><key><ctrl/>A</key> <action>select all text</action></keys>