[gimp-help/gimp-help-2-10] Add several missing path help id's

From: Jacob Boerema <jboerema src gnome org>
To: commits-list gnome org
Cc:
Subject: [gimp-help/gimp-help-2-10] Add several missing path help id's
Date: Wed, 13 Jul 2022 18:39:43 +0000 (UTC)
commit 057a52c6772144f0e56b8503ec789ac6e9269332
Author: Jacob Boerema <jgboerema gmail com>
Date:   Wed Jul 13 14:39:15 2022 -0400

    Add several missing path help id's
    
    Added id's for:
    - gimp-path-merge-visible
    - gimp-path-visible
    - gimp-path-linked
    - gimp-path-fill (in edit menu, similar to gimp-path-stroke, was mistakenly
    called gimp-edit-path-fill)
    - gimp-path-lock-strokes
    - gimp-path-lock-position
    - gimp-path-color-tag
    - gimp-path-export
    
    This way these topics can be found when searching for it in GIMP with F1.
    
    Added description for Fill Path, changed menu entry from Path Tool to
    Edit Path.
    
    Updated the Paths dialog and Paths context menu images. Decided not to add
    an image for the "Lock" icons at the top of the dialog, since they will
    be gone in 3.0.

 images/C/dialogs/paths-dialog.png | Bin 5666 -> 7084 bytes
 images/C/dialogs/paths-menu.png   | Bin 13399 -> 17265 bytes
 src/dialogs/path-dialog.xml       | 174 +++++++++++++++++++++++++++++---------
 src/menus/edit/fill-path.xml      |   2 +-
 4 files changed, 135 insertions(+), 41 deletions(-)
---
diff --git a/images/C/dialogs/paths-dialog.png b/images/C/dialogs/paths-dialog.png
index f5755f404..9ba91399f 100644
Binary files a/images/C/dialogs/paths-dialog.png and b/images/C/dialogs/paths-dialog.png differ
diff --git a/images/C/dialogs/paths-menu.png b/images/C/dialogs/paths-menu.png
index 39cc18d28..558742b70 100644
Binary files a/images/C/dialogs/paths-menu.png and b/images/C/dialogs/paths-menu.png differ
diff --git a/src/dialogs/path-dialog.xml b/src/dialogs/path-dialog.xml
index 03b7f2bdb..39003d6ab 100644
--- a/src/dialogs/path-dialog.xml
+++ b/src/dialogs/path-dialog.xml
@@ -99,8 +99,43 @@
     </para>
     <para>
       If you are familiar with the Layers dialog, you have a head start,
-      because the Paths dialog is in several ways similar. It shows a list of
-      all paths that exist in the image, with four items for each path:
+      because the Paths dialog is in several ways similar.
+    </para>
+    <para>
+      At the top, there are two <quote>Lock</quote> icons:
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term>
+          Lock Path Strokes
+        </term>
+        <listitem>
+          <anchor id="gimp-path-lock-strokes"/>
+          <para>
+            A <quote>path</quote> icon tells us whether editing the current
+            path is locked (disabled) or not. Clicking the icon toggles between
+            enabled and disabled.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>
+          Lock Path Position
+        </term>
+        <listitem>
+          <anchor id="gimp-path-lock-position"/>
+          <para>
+            A <quote>cross with arrows</quote> icon tells us whether the current
+            path position is locked (disabled) or not. When the path position
+            is locked, the path can't be moved. Clicking the icon toggles
+            between enabled and disabled.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <para>
+      The Paths dialog itself shows a list of all paths that exist in the
+      image, with four items for each path:
     </para>
     <variablelist>
       <mediaobject>
@@ -116,10 +151,11 @@
           <phrase condition="tag-is-required">Path visibility</phrase>
         </term>
         <listitem>
+          <anchor id="gimp-path-visible"/>
           <para>
             An <quote>open eye</quote> icon if the path is visible, or a
-            blank space if it is not.  <quote>Visible</quote> means that a
-            trace of the path is drawn on the image display.  The path is not
+            blank space if it is not. <quote>Visible</quote> means that a
+            trace of the path is drawn on the image display. The path is not
             actually shown in the image pixel data unless it has been stroked
             or otherwise rendered.  Clicking in the eye-symbol-space
             toggles the visibility of the path.
@@ -134,6 +170,7 @@
           <phrase condition="tag-is-required">Chain paths</phrase>
         </term>
         <listitem>
+          <anchor id="gimp-path-linked"/>
           <para>
             A <quote>chain</quote> symbol is shown to the right of the
             eye-symbol-space if the path is transform-locked, or a blank
@@ -198,8 +235,8 @@
         <listitem>
           <para>
             See <link linkend="gimp-path-new">New Path</link>. Holding down
-            the <keycap>Shift</keycap> key brings up a dialog that allows you
-            to assign a name to the new (empty) path.
+            <keycap>Shift</keycap> makes a new (empty) path with the last
+            used values, without opening the New Path dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -207,7 +244,8 @@
         <term>Raise Path</term>
         <listitem>
           <para>
-            See <link linkend="gimp-path-raise">Raise Path</link>.
+            See <link linkend="gimp-path-raise">Raise Path</link>. Holding down
+            <keycap>Shift</keycap> moves the path to the top of the list.
           </para>
         </listitem>
       </varlistentry>
@@ -215,7 +253,8 @@
         <term>Lower Path</term>
         <listitem>
           <para>
-            See <link linkend="gimp-path-lower">Lower Path</link>.
+            See <link linkend="gimp-path-lower">Lower Path</link>. Holding down
+            <keycap>Shift</keycap> moves the path to the bottom of the list.
           </para>
         </listitem>
       </varlistentry>
@@ -273,7 +312,7 @@
         <term>Selection to Path</term>
         <listitem>
           <para>
-            Holding down the <keycap>Shift</keycap> key brings up the
+            Holding down <keycap>Shift</keycap> brings up the
             <guilabel>Advanced Options</guilabel> dialog, which
             probably is only useful to GIMP developers.
           </para>
@@ -283,7 +322,9 @@
         <term>Paint along the path</term>
         <listitem>
           <para>
-            See <link linkend="gimp-path-stroke">Stroke Path</link>.
+            See <link linkend="gimp-path-stroke">Stroke Path</link>. Holding
+            down <keycap>Shift</keycap> strokes the path based on the
+            last used values without opening the Stroke Path dialog.
           </para>
         </listitem>
       </varlistentry>
@@ -291,7 +332,7 @@
         <term>Delete Path</term>
         <listitem>
           <para>
-            <guilabel>Delete Path</guilabel> deletes the current selected
+            <guilabel>Delete Path</guilabel> deletes the currently selected
             path.
           </para>
         </listitem>
@@ -317,14 +358,14 @@
     </para>
     <variablelist>
       <varlistentry>
-        <term>Path Tool</term>
+        <term>Edit Path</term>
         <listitem>
           <para>
-            <guilabel>Path Tool</guilabel> is an alternative way to
-            activate the <link linkend="gimp-tool-path">Path tool</link>,
-            used for creating and manipulating paths.  It can also be
+            <guilabel>Edit Path</guilabel> is an alternative way to
+            activate the <link linkend="gimp-tool-path">Paths tool</link>,
+            used for creating and manipulating paths. It can also be
             activated from the Toolbox, or by using the keyboard shortcut
-            <keycap>B</keycap> (for <emphasis>Bézier</emphasis>).
+            <keycap>B</keycap>.
           </para>
         </listitem>
       </varlistentry>
@@ -340,6 +381,17 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Color Tag</term>
+        <listitem>
+          <anchor id="gimp-path-color-tag"/>
+          <para>
+            <guilabel>Color Tag</guilabel> brings up a sub menu, similar to
+            the one in the Layers Dialog, that allows you to select a color
+            tag for the selected layer.
+          </para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>New Path</term>
         <listitem>
@@ -383,7 +435,7 @@
         <listitem>
           <anchor id="gimp-path-duplicate"/>
           <para>
-            <quote>Duplicate Path</quote> creates a copy of the active path,
+            <guilabel>Duplicate Path</guilabel> creates a copy of the active path,
             assigns it a unique name, adds it to the list in the Paths dialog,
             and makes it the active path for the image.  The copy will
             be visible only if the original path was visible.
@@ -403,6 +455,7 @@
       <varlistentry>
         <term>Merge Visible Paths</term>
         <listitem>
+          <anchor id="gimp-path-merge-visible"/>
           <para>
             <guilabel>Merge Visible Paths</guilabel> takes all the paths
             in the image that are visible (that is, all that show
@@ -427,7 +480,7 @@
             These commands all convert the active path into a selection, and
             then combine it with the existing selection in the specified
             ways.
-            (<quote>Path to Selection</quote> discards the existing selection
+            (<guilabel>Path to Selection</guilabel> discards the existing selection
             and replaces it with one formed from the path.) If necessary, any
             unclosed components of the path are closed by connecting the last
             anchor point to the first anchor point with a straight line. The
@@ -498,6 +551,45 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Fill Path</term>
+        <listitem>
+          <anchor id="gimp-path-dialog-fill"/>
+          <para>
+            This operation can be accessed in several ways:
+          </para>
+          <itemizedlist>
+            <listitem>
+              <para>
+                From an the main menu, as
+                <menuchoice>
+                  <guimenu>Edit</guimenu>
+                  <guimenuitem>Fill Path</guimenuitem>
+                </menuchoice>
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                From the Paths dialog menu, as <guimenuitem>Fill
+                Path</guimenuitem>.
+              </para>
+            </listitem>
+            <listitem>
+              <para>
+                From the <guilabel>Fill Path</guilabel> button in the
+                Tool Options for the Paths tool.
+              </para>
+            </listitem>
+          </itemizedlist>
+          <para>
+            <guilabel>Fill Path</guilabel> fills all areas delimited by the path with
+            the current foreground color or currently selected pattern.
+            See the section about
+            <link linkend="gimp-path-fill">Fill Path</link> for more
+            information.
+          </para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Stroke Path</term>
         <listitem>
@@ -534,14 +626,15 @@
             <listitem>
               <para>
                 From the <guilabel>Stroke Path</guilabel> button in the
-                Tool Options for the Path tool.
+                Tool Options for the Paths tool.
               </para>
             </listitem>
           </itemizedlist>
           <para>
-            <quote>Stroke Path</quote> renders the active path on the active
+            <guilabel>Stroke Path</guilabel> renders the active path on the active
             layer of the image, permitting a wide variety of line styles and
-            stroking options.  See the section on
+            stroking options. See the sections about
+            <link linkend="gimp-path-stroke">Stroke Path</link> and
             <link linkend="gimp-selection-stroke">Stroking</link> for more
             information.
           </para>
@@ -564,7 +657,7 @@
           <note>
             <para>
               When you copy a path to an image, it is not visible. You have
-              to make it visible in the Path dialog.
+              to make it visible in the Paths dialog.
             </para>
           </note>
         </listitem>
@@ -582,37 +675,38 @@
           </para>
         </listitem>
       </varlistentry>
-      <varlistentry>
-        <term>Import Path</term>
-        <listitem>
-          <anchor id="gimp-path-import"/>
-          <para>
-            <guilabel>Import Path</guilabel> creates a new path from an SVG
-            file: it pops up a file chooser dialog that allows you to navigate
-            to the file.  See the <link linkend="gimp-concepts-paths">Paths
-            </link> section for information on SVG files and how they relate
-            to GIMP paths.
-          </para>
-        </listitem>
-      </varlistentry>
       <varlistentry>
         <term>Export Path</term>
         <listitem>
+          <anchor id="gimp-path-export"/>
           <para>
             <guilabel>Export Path</guilabel> allows you to save a path to
-            a file:  it pops up a file save dialog that allows you to
-            specify the file name and location.  You can later add this
+            a file: it pops up a file save dialog that allows you to
+            specify the file name and location. You can later add this
             path to any GIMP image using the <guilabel>Import
-            Path</guilabel> command.  The format used for saving paths is
-            SVG:  this means that vector-graphics programs such as
+            Path</guilabel> command. The format used for saving paths is
+            SVG: this means that vector-graphics programs such as
             <application>Sodipodi</application> or
             <application>Inkscape</application> will also be able to
-            import the paths you save.  See the
+            import the paths you save. See the
             <link linkend="gimp-concepts-paths">Paths</link> section for more
             information on SVG files and how they relate to GIMP paths.
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Import Path</term>
+        <listitem>
+          <anchor id="gimp-path-import"/>
+          <para>
+            <guilabel>Import Path</guilabel> creates a new path from an SVG
+            file: it pops up a file chooser dialog that allows you to navigate
+            to the file. See the <link linkend="gimp-concepts-paths">Paths
+            </link> section for information on SVG files and how they relate
+            to GIMP paths.
+          </para>
+        </listitem>
+      </varlistentry>
     </variablelist>
   </sect3>
 </sect2>
diff --git a/src/menus/edit/fill-path.xml b/src/menus/edit/fill-path.xml
index 1099acd96..0498aa3d3 100644
--- a/src/menus/edit/fill-path.xml
+++ b/src/menus/edit/fill-path.xml
@@ -4,7 +4,7 @@
 <!-- section history:
    2007-10-15 j.h : created (inspired from the GIMP Developers site)
 -->
-<sect2 id="gimp-edit-fill-path">
+<sect2 id="gimp-path-fill">
   <title>Fill Path</title>
 
   <indexterm>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]