Document #332 in the user help manual

maoschanz · Jun 9, 2021 · 741ad3d · 741ad3d
1 parent f02d5ca
commit 741ad3d
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 9 deletions.
diff --git a/help/C/tools_classic.page b/help/C/tools_classic.page
@@ -40,6 +40,11 @@
         <p>Eraser: Ignore the current color settings and just erase to get fully
         transparent pixels. Optionally, the erased pixels can be changed to the
         initial color of the canvas, or to the secondary color.</p>
+        <p>Another option of this tool is its behavior: it can erase according
+        to the line you draw with it, or according to a rectangular shape you
+        define. Using this rectangle mode, you have more available options:
+        blur, mosaic, randomly shuffle pixels, etc. so you can — for example —
+        quickly censor text over wide areas of the image.</p>
       </item>
       <item>
         <p>Highlighter: Ignore the transparency of the current color, and draw
@@ -63,14 +68,18 @@
       </item>
     </list>
 
-    <p>Aside of the colors, a common option for classic tools is whether or not
+    <p>Aside of the colors, a usual option for classic tools is whether or not
     you want to use anti-aliasing. If you use anti-aliasing, the lines will look
     smoother, but it may negatively affect any following use of the <gui
     style="menuitem">Paint</gui> tool, as well as several options of the <link
     xref="tools_selection">selection</link>.</p>
     <p>With several tools, you can change the ends of the line: it can be
     rounded or square. You can also draw various patterns of dashed lines with a
     few tools.</p>
+    <p>The <gui style="menuitem">Outline</gui> option adds an outline around the
+    line you draw. This outline uses the secondary color, and is available with
+    the <gui style="menuitem">Pencil</gui>, <gui style="menuitem">Line</gui>,
+    and <gui style="menuitem">Curve</gui> tools.</p>
   </section>
 
   <section id="brushes">

diff --git a/help/C/tools_selection.page b/help/C/tools_selection.page
@@ -71,6 +71,29 @@
     color and it would look good.</p>
   </section>
 
+  <section>
+    <title>Define an image from the selection</title>
+
+    <p>If the selected area interests you more than the rest of the image,
+    several actions — in the <gui style="menuitem">More actions</gui> submenu of
+    the right-click — may help you:</p>
+    <list>
+      <item>
+        <p>Define the selection as the current image.</p>
+      </item>
+      <item>
+        <p>Reshape the current image so its size should match the size of the
+        selection (for example if you import or paste a big image).</p>
+      </item>
+      <item>
+        <p>Open the selection as a new image.</p>
+      </item>
+      <item>
+        <p>Export the selection as a new file.</p>
+      </item>
+    </list>
+  </section>
+
   <section>
     <title>Using the selection</title>
 
@@ -80,23 +103,17 @@
       <item>
         <p>Move it on the canvas.</p>
       </item>
-      <item>
-        <p>Copy it (or cut it) to the clipboard.</p>
-      </item>
       <item>
         <p>Transform it with tools. <link xref="tools_transform">The compatible
         tools</link> can be accessed with a right-click on the selection.</p>
         <media type="image" mime="image/png" width="80%" its:translate="no"
                src="figures/screenshot_selection.png" />
       </item>
       <item>
-        <p>Delete it.</p>
-      </item>
-      <item>
-        <p>Open it as a new image.</p>
+        <p>Copy it (or cut it) to the clipboard.</p>
       </item>
       <item>
-        <p>Export it as a new file.</p>
+        <p>Delete it.</p>
       </item>
     </list>
     <p>Click outside of the selected area to unselect, or use the <gui