[gimp-help/gimp-help-2-10] Add documentation for merge layer group

[Jacob Boerema <jboerema src gnome org>]

commit 70c7c43c6888c0b34404da882462fe04f5cd4a9d
Author: Jacob Boerema <jgboerema gmail com>
Date:   Fri Oct 7 15:29:42 2022 -0400

    Add documentation for merge layer group

 src/menus/layer.xml                   |  3 ++-
 src/menus/layer/merge-layer-group.xml | 50 +++++++++++++++++++++++++++++++++++
 2 files changed, 52 insertions(+), 1 deletion(-)
---
diff --git a/src/menus/layer.xml b/src/menus/layer.xml
index ca2d99641..402d8268a 100644
--- a/src/menus/layer.xml
+++ b/src/menus/layer.xml
@@ -13,11 +13,12 @@
 
   <xi:include href="layer/introduction.xml"/>
   <xi:include href="layer/new.xml"/>
-  <xi:include href="layer/new-layer-group.xml"/>
   <xi:include href="layer/new-from-visible.xml"/>
+  <xi:include href="layer/new-layer-group.xml"/>
   <xi:include href="layer/duplicate.xml"/>
   <xi:include href="layer/anchor.xml"/>
   <xi:include href="layer/merge-down.xml"/>
+  <xi:include href="layer/merge-layer-group.xml"/>
   <xi:include href="layer/delete.xml"/>
   <!-- separator -->
   <xi:include href="layer/text-commands.xml"/>
diff --git a/src/menus/layer/merge-layer-group.xml b/src/menus/layer/merge-layer-group.xml
new file mode 100644
index 000000000..546e84cc5
--- /dev/null
+++ b/src/menus/layer/merge-layer-group.xml
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+
+<sect2 id="gimp-layer-merge-group">
+  <title>Merge Layer Group</title>
+
+  <indexterm>
+    <primary>Layer</primary>
+    <secondary>Stack managing</secondary>
+    <tertiary>Merge all layers in the current layer group</tertiary>
+  </indexterm>
+  <indexterm>
+    <primary>Merge Layer Group</primary>
+  </indexterm>
+
+  <para>
+    The <guimenuitem>Merge Layer Group</guimenuitem>
+    command merges all the layers in the active
+    <link linkend="gimp-layer-groups">layer group</link>, taking into
+    account the various properties of this group, such as its opacity and layer
+    <link linkend="gimp-concepts-layer-modes">mode</link>.
+  </para>
+  <para>
+    The resulting merged layer will be in Normal mode, and will inherit the
+    opacity of the layer group. If the layers inside the group are not opaque,
+    or if they are in some mode other than Normal, then this command will
+    generally change the appearance of the image.
+  </para>
+
+  <sect3>
+    <title>Activating the Command</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          You can access this command from the menu:
+          <menuchoice>
+            <guimenu>Layer</guimenu>
+            <guimenuitem>Merge Layer Group</guimenuitem>
+          </menuchoice>.
+        </para>
+        <note>
+          <para>
+            This command is only visible if the active layer is a layer group.
+          </para>
+        </note>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+</sect2>