[gimp-help] Update tool groups



commit ce991688933bfa6a80e92c088c9507283fb651cf
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon Mar 9 08:08:09 2020 +0100

    Update tool groups

 images/C/preferences/prefs-toolbox.png  | Bin 44252 -> 99084 bytes
 images/C/toolbox/toolbox-icon-group.jpg | Bin 0 -> 12758 bytes
 images/C/toolbox/toolbox-icons.jpg      | Bin 0 -> 28553 bytes
 src/concepts/toolbox.xml                |  24 +++++++-------
 src/toolbox/intro.xml                   |  36 ++++++++++++++++-----
 src/using/preferences/prefs-toolbox.xml |  55 ++++++++++++++++++++++++--------
 6 files changed, 80 insertions(+), 35 deletions(-)
---
diff --git a/images/C/preferences/prefs-toolbox.png b/images/C/preferences/prefs-toolbox.png
index 97933f75a..670a89cdf 100644
Binary files a/images/C/preferences/prefs-toolbox.png and b/images/C/preferences/prefs-toolbox.png differ
diff --git a/images/C/toolbox/toolbox-icon-group.jpg b/images/C/toolbox/toolbox-icon-group.jpg
new file mode 100644
index 000000000..10176466b
Binary files /dev/null and b/images/C/toolbox/toolbox-icon-group.jpg differ
diff --git a/images/C/toolbox/toolbox-icons.jpg b/images/C/toolbox/toolbox-icons.jpg
new file mode 100644
index 000000000..145a1e249
Binary files /dev/null and b/images/C/toolbox/toolbox-icons.jpg differ
diff --git a/src/concepts/toolbox.xml b/src/concepts/toolbox.xml
index c7c31b645..0db126754 100644
--- a/src/concepts/toolbox.xml
+++ b/src/concepts/toolbox.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- Version History:
-  2019-05-18 j.h: some updates, fixing issue #149
+  
 -->
 <sect2 id="gimp-concepts-toolbox">
   <title>The Toolbox</title>
@@ -54,6 +54,12 @@
         tools, and each tool is described systematically in the
         <link linkend="gimp-tools">Tools</link> chapter.
       </para>
+      <note>
+        <para>
+          Since GIMP-2.10.18, these icons can be tools groups. See 
+          <xref linkend="gimp-toolbox-icons"/>.
+        </para>
+      </note>
     </listitem>
     <listitem>
       <para>
@@ -115,18 +121,10 @@
   <tip>
     <para>
       The Toolbox window displays <quote>Wilber's eyes</quote> along the top
-      of the dialog. You can get rid of the <quote>Wilber's eyes</quote>
-      by adding the following line to your <filename>gimprc</filename>
-      file:
-      <code>(toolbox-wilber&nbsp;no)</code>.
-      It only affects the toolbox. The eyes in the Image window are only
-      visible when you do not have an open image.
-    </para>
-  </tip>
-  <tip>
-    <para>
-      Drag and drop an image from a file browser into the Toolbox window to open
-      the image in its own Image window or tab.
+      of the dialog. You can click-drag-and-drop an image from a file browser into 
+      this area to open it. You can get rid of this logo by unchecking the 
+      <guilabel>Show GIMP logo</guilabel> option in the Toolbox page of 
+      Preferences.
     </para>
   </tip>
 </sect2>
diff --git a/src/toolbox/intro.xml b/src/toolbox/intro.xml
index 0336278fe..698c784d7 100644
--- a/src/toolbox/intro.xml
+++ b/src/toolbox/intro.xml
@@ -71,13 +71,35 @@
 
   <sect2 id="gimp-toolbox-icons">
     <title>Tool Icons</title>
-
+    <para>
+      With GIMP-2.10.18, tool icons can be grouped, and this option is enabled  by 
+      default. The group icon displayed is the first icon in the group. Right 
+      click on the group icon to display the list of tools in the group.
+      <mediaobject>
+        <imageobject>
+       <imagedata format="JPEG" fileref="images/toolbox/toolbox-icon-group.jpg"/>
+        </imageobject>
+      </mediaobject>
+    </para>
+    <para>
+      You can get the former display back unchecking the <guilabel>Use tool 
+        groups</guilabel> option in <xref linkend="gimp-prefs-toolbox"/>.
+    </para>
+  
     <figure>
       <title>The Tool Icons in the Toolbox</title>
       <mediaobject>
         <imageobject>
-          <imagedata format="PNG" fileref="images/toolbox/toolbox-icons.png"/>
+          <imagedata format="JPEG" fileref="images/toolbox/toolbox-icons.jpg"/>
         </imageobject>
+        <caption>
+          <para>
+            <quote>Use tool groups</quote> option unchecked. The default order 
+            of tools in the toolbox is different since GIMP-2.10.8; you can 
+            customize it in the <emphasis>Interface>Toolbox</emphasis> 
+            page of the <emphasis>Preferences</emphasis>.
+          </para>
+        </caption>
       </mediaobject>
     </figure>
     <para>
@@ -100,12 +122,10 @@
       In the default setup, created when <acronym>GIMP</acronym> is first
       installed, not all tools show icons in the Toolbox: the Color tools are
       omitted. You can customize the set of tools that are shown in the
-      Toolbox through
-      <menuchoice>
-        <guimenu>Edit</guimenu>
-        <guisubmenu>Preferences</guisubmenu>
-        <guimenuitem>Toolbox</guimenuitem>
-      </menuchoice>.
+      Toolbox in the <emphasis>Interface > Toolbox</emphasis> page of the 
+      <emphasis>Preferences</emphasis>.
+    </para>
+    <para>
       There are two reasons you might want to do this: first, if you only
       rarely use a tool, it might be easier to find the tools you want if the
       distracting icon is removed; second, if you use the Color tools a lot,
diff --git a/src/using/preferences/prefs-toolbox.xml b/src/using/preferences/prefs-toolbox.xml
index 3d8e6551f..0c3261ef5 100644
--- a/src/using/preferences/prefs-toolbox.xml
+++ b/src/using/preferences/prefs-toolbox.xml
@@ -2,10 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--  Section history:
-  2012-05-02 j.h: update pref-toolbox to v2.8
-  2008-12-10 JPL: updated v2.6
-  2005-11-30 replaced informalfigure by figure  by lexa
-  2008-01-28 jpl: update text & images
+  
 -->
 <sect2 id="gimp-prefs-toolbox">
   <title>Toolbox</title>
@@ -58,6 +55,15 @@
         <primary>Image</primary>
         <secondary>Active Image Thumbnail</secondary>
       </indexterm>
+      <varlistentry>
+        <term>Show GIMP logo (drag-and-drop target</term>
+        <listitem>
+          <para>
+            You can click-drag-and-drop an image from a file browser into 
+            this area to open it.
+          </para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>Show foreground and background color</term>
         <listitem>
@@ -72,8 +78,7 @@
         <listitem>
           <para>
             Controls whether the area in the center (3), with the brush,
-            pattern, and gradient icons, appears in the
-            Toolbox.
+            pattern, and gradient icons, appears in the Toolbox.
           </para>
         </listitem>
       </varlistentry>
@@ -86,6 +91,15 @@
           </para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>Use tool groups</term>
+        <listitem>
+          <para>
+            Since GIMP-2.10.18, tools can be grouped in the toolbox 
+            (see <xref linkend="gimp-toolbox-icons"/>).
+          </para>
+        </listitem>
+      </varlistentry>
     </variablelist>
     
     <variablelist id="prefs-tools-config">
@@ -99,16 +113,29 @@
         <listitem>
           <para>
             In this list, tools with an eye are present in the Toolbox. By
-            default, color tools have no eye: you can add them to the Toolbox by
-            clicking the corresponding checkbox.
-          </para>
-          <para>
-            You can also sort tools by priority using the arrow up and down
-            buttons at the bottom of the dialog.
+            default, color tools have no eye: you can add them to the Toolbox 
+            by clicking the corresponding checkbox to create an eye.
           </para>
           <para>
-            This option replaces the Tools Dialog of former
-            <acronym>GIMP</acronym> versions.
+            Since GIMP-2.10.18, tools are grouped. You can:
+            <itemizedlist>
+              <listitem>
+                <para>
+                  <emphasis role="bold">Move groups</emphasis> by using 
+                  drag-and-drop or the arrow buttons at the bottom of the 
+                  dialog.
+                </para>
+              </listitem>
+              <listitem>
+                <para>
+                  <emphasis role="bold">Create a new group</emphasis> by 
+                    using the <guibutton>Create a new tool group</guibutton> 
+                    at the bottom of the dialog. This tool group is created 
+                    empty.
+                </para>
+              </listitem>
+            </itemizedlist>
+            Changes take effect immediately.
           </para>
         </listitem>
       </varlistentry>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]