[gimp-help/gimp-help-2-10] concepts: revise and update the Script-Fu section

[Jacob Boerema <jboerema src gnome org>]

commit 38ea23e0d113c5adfa30b7482f6df71f4a4b5076
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sun Jul 10 17:39:39 2022 -0400

    concepts: revise and update the Script-Fu section
    
    The last part, handled by MR !81 is not included in the update.
    Removed the section about standalone scripts since those scripts are not
    included with GIMP anymore.
    Also remove the script-fu-exts.png image including translated versions.

 images/C/using/script-fu-exts.png  | Bin 14534 -> 0 bytes
 images/de/using/script-fu-exts.png | Bin 65821 -> 0 bytes
 images/fr/using/script-fu-exts.png | Bin 16182 -> 0 bytes
 images/ja/using/script-fu-exts.png | Bin 42870 -> 0 bytes
 images/nn/using/script-fu-exts.png | Bin 55657 -> 0 bytes
 src/concepts/script-fu.xml         | 256 +++++--------------------------------
 6 files changed, 34 insertions(+), 222 deletions(-)
---
diff --git a/src/concepts/script-fu.xml b/src/concepts/script-fu.xml
index fd6ef00de..9fd220bc7 100644
--- a/src/concepts/script-fu.xml
+++ b/src/concepts/script-fu.xml
@@ -14,13 +14,13 @@
   </indexterm>
 
   <sect2>
-    <title>Script-Fu? </title>
+    <title>Script-Fu?</title>
     <para>
-      Script-Fu is what the Windows world would call "macros". But Script-Fu is
-      more powerful than that. Script-Fu is based on an interpreting language
-      called Scheme, and works by using querying functions to the
-      <acronym>GIMP</acronym>
-      database. You can do all kinds of things with Script-Fu, but an ordinary
+      Script-Fu scripts are similar to very powerful <quote>macros</quote> that
+      you may be familiar with from other programs. Script-Fu is based on an
+      interpreted language called Scheme, and works by using functions that
+      interact with <acronym>GIMP</acronym>'s internal functions.
+      You can do all kinds of things with Script-Fu, but an ordinary
       <acronym>GIMP</acronym> user will probably use it for automating things
       that:
     </para>
@@ -35,10 +35,10 @@
     <para>
       Remember that you can do a whole lot with Script-Fu. The scripts that
       come with <acronym>GIMP</acronym> can be quite useful, but they can also
-      serve as models
-      for learning Script-Fu, or at least as a framework and source of
-      modification when you make your own script. Read the Script-Fu Tutorial
-      in the next section if you want to learn more about how to make scripts.
+      serve as models for learning Script-Fu, or at least as a framework and
+      source of modification when you make your own script. Read the Script-Fu
+      Tutorial in the next section if you want to learn more about how to
+      write your own scripts.
     </para>
     <para>
       We will describe some of the most useful scripts in this chapter, but we
@@ -49,12 +49,12 @@
     <para>
       Script-Fu (a dialect of Scheme) isn't the only scripting language
       available for <acronym>GIMP</acronym>. But Script-Fu is the only
-      scripting language that is installed by default. 
+      scripting language that is installed by default.
     </para>
   </sect2>
 
   <sect2 id="install-script-fu">
-    <title>Installing Script-Fus</title>
+    <title>Installing Script-Fu scripts</title>
     <indexterm>
       <primary>Script-Fu</primary>
       <secondary>Install</secondary>
@@ -63,8 +63,7 @@
       One of the great things about Script-Fu is that you can share your
       script with all your <acronym>GIMP</acronym> friends. There are many
       scripts that come with <acronym>GIMP</acronym> by default, but
-      there are also vast quantities of scripts that are
-      available for download all around the Internet.
+      there are even more available for download online.
     </para>
     <procedure>
       <step>
@@ -116,44 +115,37 @@
         <term>Standalone Script-Fus</term>
         <listitem>
           <para>
-            You will find the standalone variants under
-            <menuchoice>
-              <guimenu>File</guimenu>
-              <guisubmenu>Create</guisubmenu>
-              <guisubmenu>Type of Script</guisubmenu>
-            </menuchoice>
-            in the image menubar (see the figure below).
+            These scripts do not require an existing image. They usually
+            create an image themselves. In the past there were several
+            scripts supplied with <acronym>GIMP</acronym> that belonged to
+            this category. However, the results all looked dated compared to
+            todays standards and they were not well maintained. Which is the
+            reason that they are not installed anymore in
+            <acronym>GIMP</acronym> 2.10.
+          </para>
+          <para>
+            In case you would like to keep using these scripts, they are still
+            available as separate downloads that you have to install yourself.
+            The scripts and other resources can be downloaded from
+            <ulink url="https://gitlab.gnome.org/GNOME/gimp-data-extras";>here</ulink>.
           </para>
-          <figure>
-            <title>Script-Fus by category</title>
-            <mediaobject>
-              <imageobject>
-                <imagedata format="PNG"
-                           fileref="images/using/script-fu-exts.png"/>
-              </imageobject>
-            </mediaobject>
-          </figure>
         </listitem>
       </varlistentry>
       <varlistentry>
         <term>Image-dependent Script-Fus</term>
         <listitem>
           <para>
-            Menus have been reorganized. A new Colors-menu appears. It groups
-            together all scripts that work on colors, for example tools that
-            adjust hue, saturation, lightness..., filters...etc. Filters-menu
-            and Script-Fu-menu are merged in one Filters-menu and it is
-            organized according to new categories. Image-dependent Plug-ins and
-            Script-Fus are now disseminated in the image-menus. For example,
-            Color to Alpha filter is in Colors-menu. At the beginning, it's
-            disconcerting, but you finish to get used to this because it's more
-            logical.
+            In the past there was a dedicated Script-Fu menu. Nowadays most
+            scripts and plugins are logically categorized and added to the
+            menu that closely resembles their function. Most of the scripts
+            appear in the <guimenu>Filters</guimenu> menu, but there are
+            also several in the <guimenu>Colors</guimenu> and in other places.
           </para>
           <para>
-            The figure below show where you can find them in the image-menu.
+            The figure below shows where you can find them in the image-menu.
           </para>
           <figure>
-            <title>Where find Image-dependent scripts</title>
+            <title>Where to find Image-dependent scripts</title>
             <mediaobject>
               <imageobject>
                 <imagedata format="PNG"
@@ -166,187 +158,7 @@
     </variablelist>
   </sect2>
 
-  <sect2 id="standalone-script-fu">
-    <title>Standalone Scripts</title>
-    <indexterm>
-      <primary>Script-Fu</primary>
-      <secondary>Standalone</secondary>
-    </indexterm>
-    <indexterm>
-      <primary>Patterns</primary>
-      <secondary>Script-Fu-generated</secondary>
-    </indexterm>
-
-    <para>
-      We will not try to describe every script in depth. Most Script-Fus are
-      very easy to understand and use. At the time of this writing, the
-      following types are installed by default:
-    </para>
-    <itemizedlist>
-      <listitem>
-        <para>Patterns</para>
-      </listitem>
-      <listitem>
-        <para>Web page themes</para>
-      </listitem>
-      <listitem>
-        <para>Logos</para>
-      </listitem>
-      <listitem>
-        <para>Buttons</para>
-      </listitem>
-    </itemizedlist>
-    <variablelist>
-      <varlistentry>
-        <term>Patterns</term>
-        <listitem>
-          <para>
-            You will find all kinds of pattern-generating scripts here.
-            Generally, they are quite useful because you can add many
-            arguments to your own patterns.
-          </para>
-          <para>
-            We'll take a look at the Land script. In this script you have to
-            set the image/pattern size, and specify what levels of random to
-            use for your land creation. The colors used to generate the land
-            map are taken from the currently selected gradient in the gradient
-            editor. You must also supply values for the level of detail, land
-            and sea height/depth and the scale. Scale refers to the scale of
-            your map, just as in an ordinary road map, 1:10 will be typed as
-            10.
-          </para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Web Page Themes</term>
-        <listitem>
-          <para>
-            Here is clearly a practical use for scripts. By creating a script
-            for making custom text, logos, buttons arrows, etc., for your web
-            site, you will give them all the same style and shape. You will
-            also be saving a lot of time, because you don't have to create
-            every logo, text or button by hand.
-          </para>
-          <para>
-            Most of the scripts are quite self-explanatory, but here are some
-            hints:
-          </para>
-          <itemizedlist>
-            <listitem>
-              <para>
-                Leave all strange characters like ' and " intact.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Make sure that the pattern specified in the script exists.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Padding refers to the amount of space around your text.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                A high value for bevel width gives the illusion of a higher
-                button.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                If you type TRUE for "Press", the button will look pushed
-                down.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                Choose transparency if you don't want a solid background. If
-                you choose a solid background, make sure it is the same color
-                as the web page background.
-              </para>
-            </listitem>
-          </itemizedlist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Logos</term>
-        <listitem>
-          <indexterm>
-            <primary>Script-Fu</primary>
-            <secondary>Logo</secondary>
-          </indexterm>
-          <indexterm>
-            <primary>Logo</primary>
-            <secondary>Script-Fu-generated</secondary>
-          </indexterm>
-          <para>
-            Here you will find all kinds of logo-generating scripts. This is
-            nice, but use it with care, as people might recognize your logo as
-            being made by a known <acronym>GIMP</acronym> script. You should
-            rather regard it as
-            a base that you can modify to fit your needs. The dialog for
-            making a logo is more or less the same for all such scripts:
-          </para>
-          <orderedlist>
-            <listitem>
-              <para>
-                In the Text String field, type your logo name, like
-                Frozenriver.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                In the Font Size text field, type the size of your logo in
-                pixels.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                In the Font text field, type the name of the font that you
-                want to use for your logo.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                To choose the color of your logo, just click on the color
-                button. This brings up a color dialog.
-              </para>
-            </listitem>
-            <listitem>
-              <para>
-                If you look at the current command field, you can watch the
-                script run.
-              </para>
-            </listitem>
-          </orderedlist>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term>Make Buttons</term>
-        <listitem>
-          <indexterm>
-            <primary>Script-Fu</primary>
-            <secondary>Button</secondary>
-          </indexterm>
-          <indexterm>
-            <primary>Button</primary>
-            <secondary>Script-Fu-generated</secondary>
-          </indexterm>
-          <para>
-            Under this headline you'll find two scripts that makes rectangular
-            beveled buttons, with or without round corners (Round Button or
-            Simple Beveled Button). They have a dozen parameters or so, and
-            most of them are similar to those in the logo scripts. You can
-            experiment with different settings to come up with a button you
-            like.
-          </para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </sect2>
-
-  <sect2 id="image-independent-script-fu">
+  <sect2 id="image-dependent-script-fu">
     <title>Image-Dependent Scripts</title>
     <para>
       Now, scripts and filters that perform operations on an existing image are