touch selection update

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index 0c4dc91991cb4d959545ea81afd0174227ed9a35..8367eecba621cb96fd91e92d26d6ba2b419cb90d 100644 (file)
--- a/doc/keys.xml
+++ b/doc/keys.xml
@@ -25,7 +25,8 @@ RFE</a>).</p>
 <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><ctrl/><keyf f="F6"/></key><key>c</key>      <action>Calligraphic tool</action></keys>
+<keys><key><ctrl/><keyf f="F6"/></key><key>c</key>      <action>Calligraphy 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>
 <keys><key><keyf f="F8"/></key><key>t</key>     <action>Text tool</action></keys>
@@ -43,8 +44,10 @@ RFE</a>).</p>
 <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/>M</key> <action>Transform</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/>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>
@@ -152,6 +155,11 @@ RFE</a>).</p>
 <note>If you want to have different values for grid visibility and snapping, set them via the Document Options dialog.</note>
 <note>Note that only the 3 key on the main keyboard works, not on the keypad.</note>
 </group>
+
+<group>
+<title>Display mode</title>
+<keys><key><ctrl/><misc-wide f="keypad 5"/></key>  <action>toggle normal/outline mode</action></keys>
+</group>
 </section>
 
 *<section title="Palette" color="efcfdf">
@@ -185,6 +193,7 @@ RFE</a>).</p>
 <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>
+<keys><key><shift/><ctrl/><alt/>S</key>         <action>save a copy</action></keys>
 <keys><key><ctrl/>Q</key>       <action>exit Inkscape</action></keys>
 </group>
 
@@ -455,7 +464,12 @@ RFE</a>).</p>
 <mouse><key><alt/><left-click/></key> <action>select under</action></mouse>
 <note>Alt+click selects the object at click point which is beneath (in z-order) the lowest selected object at click point.</note>
 <note>If the bottom object is reached, Alt+click again selects the top object. So, several Alt+clicks cycle through z-order stack at point.</note>
-<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>
+<note>On Linux, Alt+click and Alt+drag may be reserved by the window manager.  If you reconfigure your window manager </note>
+<note>to not map Alt+click, then it will be free for Inkscape to use.  </note>
+<note>If your keyboard has a Meta key, you may wish to set your "Modifier
+key" to use it instead of Alt.</note>
+<note>(Sometimes you can also use Ctrl+Alt+click (select under in
+groups) with the same effect as Alt+click.)</note>
 <mouse><key><shift/><alt/><left-click/></key> <action>toggle under</action></mouse>
 <mouse><key><ctrl/><alt/><left-click/></key> <action>select under, in groups</action></mouse>
 <mouse><key><shift/><ctrl/><alt/><left-click/></key> <action>toggle under, in groups</action></mouse>
@@ -464,12 +478,16 @@ RFE</a>).</p>
 </group>
 
 <group>
-<title>Rubberband</title>
-<mouse><key><left-drag/></key> <action>select multiple objects</action></mouse>
+<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>
@@ -519,6 +537,8 @@ RFE</a>).</p>
 <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>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>
 <note>Resetting rotation center moves it back to the geometric center of the object's or selection's bounding box.</note>
 </group>
@@ -782,7 +802,7 @@ RFE</a>).</p>
 <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>
+<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>
@@ -807,7 +827,7 @@ RFE</a>).</p>
 <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>
+<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>
@@ -836,7 +856,7 @@ RFE</a>).</p>
 <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> <action>remove randomization</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>
@@ -856,7 +876,7 @@ RFE</a>).</p>
 <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><alt/><left-click/></key> <action>reset divergence (inner handle)</action></mouse>
+<mouse><key><alt/><left-click/></key> <key><ctrl/><alt/><left-click/></key> <action>reset divergence (inner handle)</action></mouse>
 <note>Vertical Alt+drag of the inner handle adjusts the "divergence" parameter, Alt+click resets it to 1.</note>
 <mouse><key><shift/><left-click/></key> <action>zero inner radius (inner handle)</action></mouse>
 <note>Shift+click on inner handle makes the spiral start from the center.</note>
@@ -954,13 +974,32 @@ RFE</a>).</p>
 *<section title="Calligraphy" color="e9dfef">
 <group>
 <mouse><key><left-drag/></key> <action>draw a calligraphic line</action></mouse>
-<mouse><key><left-arrow/></key> <key><right-arrow/></key> <action>adjust pen width</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>
 <note>Width and angle can be adjusted while drawing. </note>
 <keys><key><misc f="Esc"/></key> <action>deselect</action></keys>
 </group>
 </section>
 
+*<section title="Paint Bucket" color="f2f9da">
+<group>
+<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><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>
+</group>
+</section>
+
 *<section title="Gradient tool" color="e9f3e7">
 <group>
 <title>Creating gradients</title>
@@ -1009,7 +1048,7 @@ RFE</a>).</p>
 <mouse><key><shift/><left-drag/></key> <action>average stroke color</action></mouse>
 <note>Click applies the color under cursor to the current selection. Dragging a radius calculates the average color of a circular area.</note>
 <note>If a gradient handle (in Gradient tool) is selected, it gets the color instead of the entire object.</note>
-<mouse><key><alt/><left-click/></key><key><alt/><left-drag/></key> <action>pick inverse color</action></mouse>
+<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>
@@ -1077,7 +1116,7 @@ RFE</a>).</p>
 <note>Enter in regular text creates new line; in flowed text it creates a new paragraph</note>
 <keys><key><ctrl/>U</key> <action>toggle Unicode entry</action></keys> 
 <note>To insert an arbitrary Unicode character, type Ctrl+U, then the hexadecimal code point, then Enter.</note>
-<note>For example, Ctrl+U 2 0 1 4 Enter inserts an em-dash.</note>
+<note>For example, type Ctrl+U 2 0 1 4 Enter for an em-dash; Ctrl+U a 9 Enter for a copyright sign.</note>
 <note>To stay in Unicode mode after inserting the character, press Space instead of Enter.</note>
 <note>Press Esc or another Ctrl+U to cancel Unicode mode without inserting the character.</note>
 <keys><key><ctrl/><misc-wide f="Space"/></key> <action>insert no-break space</action></keys>