touch selection update

[inkscape.git] / doc / keys.xml

diff --git a/doc/keys.xml b/doc/keys.xml
index 028d14ab0d9b49b79c7f788b00ec02283b875489..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>
@@ -477,12 +478,16 @@ groups) with the same effect as Alt+click.)</note>
 </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>
@@ -532,6 +537,8 @@ groups) with the same effect as Alt+click.)</note>
 <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>
@@ -967,13 +974,32 @@ groups) with the same effect as Alt+click.)</note>
 *<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>