[gimp-help] Fix issue #126 : rearrange floating selection

[Julien Hardlin <jhardlin src gnome org>]

commit 5a77d54553a2ee415bb523832f85ca9181e4a921
Author: Julien Hardelin <jhardlin orange fr>
Date:   Mon May 27 07:51:54 2019 +0200

    Fix issue #126 : rearrange floating selection

 src/glossary/glossary.xml     |  4 ++++
 src/menus/layer/anchor.xml    | 54 ++++---------------------------------------
 src/menus/select/float.xml    | 22 ++++++++++++------
 src/using/getting-unstuck.xml |  2 +-
 4 files changed, 25 insertions(+), 57 deletions(-)
---
diff --git a/src/glossary/glossary.xml b/src/glossary/glossary.xml
index 4bb8044b2..49b00f2d1 100644
--- a/src/glossary/glossary.xml
+++ b/src/glossary/glossary.xml
@@ -801,6 +801,10 @@ https://gitlab.gnome.org/GNOME/gimp-help/tree/master/docs/xcf images folder-->
         <link linkend="gimp-layer-anchor">anchored</link> before you can
         resume working on any other layers in the image.
       </para>
+      <para>
+        Floating selections are described in 
+        <xref linkend="gimp-selection-float"/>.
+      </para>
       <para>
         In early versions of <acronym>GIMP</acronym>, when
         <acronym>GIMP</acronym> did not use layers, floating selections were
diff --git a/src/menus/layer/anchor.xml b/src/menus/layer/anchor.xml
index 2010094d0..fbd471d83 100644
--- a/src/menus/layer/anchor.xml
+++ b/src/menus/layer/anchor.xml
@@ -2,15 +2,8 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-     2009-02-20 ude: added alternative ways
-     2009-01-25 j.h: v2.6 reviewed
-     2007-12-01 j.h: v2.4 update
-     2007-05-24 Added Spanish translation by AntI
-     2007-02-21 KoSt: added no
-     2006-08-03 scb: revised 'en'
-     2006-07-28 note added
-     2005-11-03 split of from menu-layer.xml by axel.wernicke
-     -->
+  2019-05-27 j.h fix issue #126: delete doublet
+-->
 <sect2 id="gimp-layer-anchor">
   <title>Anchor layer</title>
 
@@ -18,10 +11,6 @@
     <primary>Layer</primary>
     <secondary>Anchor the floating layer</secondary>
   </indexterm>
-  <indexterm>
-    <primary>Selection</primary>
-    <secondary>Anchor the floating selection</secondary>
-  </indexterm>
   <indexterm>
     <primary>Anchor Layer</primary>
   </indexterm>
@@ -64,43 +53,10 @@
     </itemizedlist>
   </sect3>
 
-  <!-- Mostly the same as in "menus/select/float.xml" -->
   <sect3>
     <title>Alternative Ways of Anchoring a Floating Selection</title>
-    <para>There are more ways to anchor a floating selection:</para>
-    <itemizedlist>
-      <listitem>
-        <para>
-          You can anchor the floating selection to the current layer that the
-          selection is originating from by clicking anywhere on the image
-          except on the floating selection.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          You can also anchor the floating selection to the current layer by
-          clicking on the anchor button
-          <guiicon>
-            <inlinemediaobject>
-              <imageobject>
-                <imagedata
-                  fileref="images/dialogs/stock-anchor-16.png"/>
-              </imageobject>
-              <textobject>
-                <phrase>Anchor the floating Layer</phrase>
-              </textobject>
-            </inlinemediaobject>
-          </guiicon>
-          of the <link linkend="gimp-layer-dialog">Layers dialog</link>.
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          If you create a <link linkend="gimp-layer-new">New Layer</link>
-          while there is a floating selection, the floating selection is
-          anchored to this newly created layer.
-        </para>
-      </listitem>
-    </itemizedlist>
+    <para>
+      Please refer to <xref linkend="anchor-floating-selection"/>
+    </para>
   </sect3>
 </sect2>
diff --git a/src/menus/select/float.xml b/src/menus/select/float.xml
index 0215a5b30..f5f9dfaca 100644
--- a/src/menus/select/float.xml
+++ b/src/menus/select/float.xml
@@ -2,9 +2,7 @@
 <!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!-- section history:
-  2009-02-20 ude: rearranged, especially moved some glossary paras here
-  2009-01-10 j.h: reviewed for v2.6
-
+  2019-05-27 j.h fix issue #126: rearrange floating selection
 -->
 <sect2 id="gimp-selection-float">
   <title>Float</title>
@@ -121,8 +119,7 @@
     </itemizedlist>
   </sect3>
 
-  <!-- Mostly the same as in "menus/layer/anchor.xml" -->
-  <sect3>
+  <sect3 id="anchor-floating-selection">
     <title>Anchor a Floating Selection</title>
     <para>You can anchor a floating selection in various ways:</para>
     <itemizedlist>
@@ -144,8 +141,19 @@
       <listitem>
         <para>
           You can also anchor the floating selection to the current layer by
-          clicking on the anchor button of the
-          <link linkend="gimp-layer-dialog">Layers dialog</link>.
+          clicking on the anchor button
+          <guiicon>
+            <inlinemediaobject>
+              <imageobject>
+                <imagedata
+                  fileref="images/dialogs/stock-anchor-16.png"/>
+              </imageobject>
+              <textobject>
+                <phrase>Anchor the floating Layer</phrase>
+              </textobject>
+            </inlinemediaobject>
+          </guiicon>
+          of the <link linkend="gimp-layer-dialog">Layers dialog</link>.
         </para>
       </listitem>
       <listitem>
diff --git a/src/using/getting-unstuck.xml b/src/using/getting-unstuck.xml
index 63f3e44fa..5865444d6 100644
--- a/src/using/getting-unstuck.xml
+++ b/src/using/getting-unstuck.xml
@@ -63,7 +63,7 @@
         <emphasis>How to solve:</emphasis>
         Either anchor the floating selection, or convert it into an
         ordinary (non-floating) layer. If you need help on how to do this,
-        see <link linkend="glossary-floatingselection">
+        see <link linkend="anchor-floating-selection">
           Floating Selections
         </link>.
       </para>