fix unclosed tag

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index 852363fa7fd6595dca703029141f2699e52deffd..ffad4cfbdd0509bf6ff6301483253a13fcbaf36d 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
@@ -24,7 +24,7 @@ RFE</a>).</p>
 <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><alt/><keyf f="F2"/></key><key>w</key>      <action>Tweak 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>
@@ -54,13 +54,14 @@ RFE</a>).</p>
 <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>
 
@@ -160,15 +161,17 @@ RFE</a>).</p>
 </group>
 
 <group>
-<title>Guides and grid</title>
+<title>Guides, grids, snapping</title>
 <mouse><key><left-drag/></key> <action>drag off a ruler to create guide</action></mouse>
 <note>Drag off the horizontal or vertical ruler to create a new guideline. Drag a guideline onto the ruler to delete it.</note>
 <keys><key>|</key> <key><shift/>\</key> <action>toggle guides and snapping to guides</action></keys>
-<note>If you want to have different values for guides visibility and snapping, set them via the Document Options dialog.</note>
+<note>If you want to see the guides but not snap to them, use the global snapping toggle (% key).</note>
 <note>When you create a new guide by dragging off the ruler, guide visibility and snapping are turned on.</note>
-<keys><key>#</key> <key><shift/>3</key> <action>toggle grid and snapping to grid</action></keys>
-<note>If you want to have different values for grid visibility and snapping, set them via the Document Options dialog.</note>
+<keys><key>#</key> <key><shift/>3</key> <action>toggle grids and snapping to grids</action></keys>
+<note>If you want to see the grids but not snap to them, use the global snapping toggle (% key).</note>
 <note>Note that only the 3 key on the main keyboard works, not on the keypad.</note>
+<keys><key>%</key> <action>toggle snapping on and off</action></keys>
+<note>This toggle affects snapping to grids, guides, and objects in all tools.</note>
 </group>
 
 <group>
@@ -274,8 +277,10 @@ RFE</a>).</p>
 <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>
@@ -642,7 +647,7 @@ groups) with the same effect as Alt+click.)</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 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>
@@ -825,17 +830,21 @@ groups) with the same effect as Alt+click.)</note>
 <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 melt mode</action></mouse>
-<mouse><key><ctrl/><shift/><left-drag/></key> <action>act temporarily switching to inflate 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/>m</key> <action>melt (thin) mode</action></keys>
-<keys><key><shift/>i</key> <action>inflate (thicken) 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>
@@ -843,7 +852,7 @@ groups) with the same effect as Alt+click.)</note>
 <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. </note>
+<note>Width and force can be adjusted while drawing. With a pressure-sensitive tablet, force also depends on pen pressure.</note>
 </group>
 
 </section>
@@ -891,7 +900,7 @@ groups) with the same effect as Alt+click.)</note>
 *<section title="3D box tool" color="cff4e2">
 <group>
 <title>Draw</title>
-<mouse><key><left-drag/></key> <action>draw a 3D box</action></mouse>
+<mouse><key><left-drag/></key> <action>draw a 3D box (use shift to extrude in Z direction)</action></mouse>
 </group>
 
 <group>
@@ -902,16 +911,48 @@ groups) with the same effect as Alt+click.)</note>
 <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>
@@ -1024,6 +1065,8 @@ groups) with the same effect as Alt+click.)</note>
 <note>If a path is selected, Shift+dragging anywhere creates a new subpath instead of a new independent path.</note>
 <mouse><key><shift/><left-drag/></key> <action>temporarily disable snapping</action></mouse>
 <note>Shift also temporaily disables snapping to grid or guides when you are drawing with grid or guides on.</note>
+<mouse><key><ctrl/><left-click/></key> <action>create a single dot</action></mouse>
+<note>This creates a single dot, represented by a small circle. The dot size (relative to the current stroke width) can be set in the Preferences dialog. With Shift, the size is doubled. Pressing Alt while creating multiple dots randomly varies their size.</note>
 </group>
 </section>
 
@@ -1063,6 +1106,14 @@ groups) with the same effect as Alt+click.)</note>
 <note>These commands change the last (red) segment of the path to straight line or curve.</note>
 </group>
 
+<group>
+<title>Create dots</title>
+<mouse><key><ctrl/><left-click/></key> <action>create a dot</action></mouse>
+<note>This creates a small circle. Its size (relative to the current stroke width) can be set in Preferences.</note> 
+<mouse><key><shift/><ctrl/><left-click/></key> <action>create a double-sized dot</action></mouse>
+<mouse><key><alt/><ctrl/><left-click/></key> <action>create a random-sized dot</action></mouse>
+</group>
+
 <group>
 <title>Finish</title>
 <keys><key><misc-wide f="Enter"/></key>  <action>finish current line</action></keys>
@@ -1131,36 +1182,41 @@ groups) with the same effect as Alt+click.)</note>
 <title>Select handles</title>
 <mouse><key><left-click/></key> <action>select a handle</action></mouse>
 <mouse><key><shift/><left-click/></key> <action>add handle to selection</action></mouse>
+<mouse><key><shift/><left-drag/></key> <action>select by rubberband</action></mouse>
 <keys><key><misc f="Tab"/></key>  <action>select next handle</action></keys> 
 <keys><key><shift/><misc f="Tab"/></key> <action>select previous handle</action></keys>
+<keys><key><ctrl/>A</key>       <action>select all handles</action></keys>
 <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>