[gimp-help] Add show-all.xml

[Julien Hardlin <jhardlin src gnome org>]

commit 8c7a56e4b631b21a4866df0ffc2e20d84f5587df
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Nov 24 15:41:08 2019 +0100

    Add show-all.xml

 images/C/menus/view/show_all-ex-clone.jpg  | Bin 0 -> 35278 bytes
 images/C/menus/view/show_all-ex-newimg.jpg | Bin 0 -> 30372 bytes
 images/C/menus/view/show_all-ex-no.jpg     | Bin 0 -> 21756 bytes
 images/C/menus/view/show_all-ex-with.jpg   | Bin 0 -> 33750 bytes
 src/menus/view.xml                         |   1 +
 src/menus/view/show-all.xml                | 150 +++++++++++++++++++++++++++++
 6 files changed, 151 insertions(+)
---
diff --git a/images/C/menus/view/show_all-ex-clone.jpg b/images/C/menus/view/show_all-ex-clone.jpg
new file mode 100644
index 000000000..022544569
Binary files /dev/null and b/images/C/menus/view/show_all-ex-clone.jpg differ
diff --git a/images/C/menus/view/show_all-ex-newimg.jpg b/images/C/menus/view/show_all-ex-newimg.jpg
new file mode 100644
index 000000000..7a8efaeb6
Binary files /dev/null and b/images/C/menus/view/show_all-ex-newimg.jpg differ
diff --git a/images/C/menus/view/show_all-ex-no.jpg b/images/C/menus/view/show_all-ex-no.jpg
new file mode 100644
index 000000000..0ff2e1811
Binary files /dev/null and b/images/C/menus/view/show_all-ex-no.jpg differ
diff --git a/images/C/menus/view/show_all-ex-with.jpg b/images/C/menus/view/show_all-ex-with.jpg
new file mode 100644
index 000000000..a1de76cdc
Binary files /dev/null and b/images/C/menus/view/show_all-ex-with.jpg differ
diff --git a/src/menus/view.xml b/src/menus/view.xml
index 667c94fb4..8b481ce35 100644
--- a/src/menus/view.xml
+++ b/src/menus/view.xml
@@ -16,6 +16,7 @@
 
   <xi:include href="view/introduction.xml"/>
   <xi:include href="view/new.xml"/>
+  <xi:include href="view/show-all.xml"/>
   <xi:include href="view/dot-for-dot.xml"/>
   <xi:include href="view/zoom.xml"/>
   <xi:include href="view/flip-rotate.xml"/>
diff --git a/src/menus/view/show-all.xml b/src/menus/view/show-all.xml
new file mode 100644
index 000000000..7c0ea18e7
--- /dev/null
+++ b/src/menus/view/show-all.xml
@@ -0,0 +1,150 @@
+<?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";>
+<!-- section history:
+  2019-11-21 j.h: initial version
+-->
+<sect2 id="gimp-view-show-all">
+  <title>Show All</title>
+  
+  <indexterm>
+    <primary>Show All</primary>
+  </indexterm>
+
+  <para>
+    The <guimenuitem>Show All</guimenuitem> command appeared in GIMP-2.10.14. 
+    It makes visible all pixels that are spilling off the canvas boundary and 
+    that are normally cut off the image. This allow you to drag new layers, new 
+    images outside the canvas temporarily to work with them.
+  </para>
+
+  <sect3>
+    <title>Activating the Command</title>
+    <para>
+      You can access this command from the image menubar through
+      <menuchoice>
+        <guimenu>View</guimenu>
+        <guimenuitem>Show All</guimenuitem>
+      </menuchoice>,
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Basic principles about the <quote>Show All</quote> Command</title>
+    <para>
+      When you just open an image, the canvas size is the same as the image 
+      size, and applying the <quote>Show all</quote> command, of course, gives 
+      nothing since there is no pixel outside the canvas. So, enlarge the 
+      layer using the <link linkend="gimp-tool-scale">Scale tool</link>.
+    </para>
+    <figure>
+      <title>Show All</title>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/menus/view/show_all-ex-no.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Layer enlarged. Command not checked.
+          </para>
+        </caption>
+      </mediaobject>
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/menus/view/show_all-ex-with.jpg"/>
+        </imageobject>
+        <caption>
+          <para>
+            Layer enlarged. Command checked. 
+          </para>
+        </caption>
+      </mediaobject>
+    </figure>
+    <para>
+      When the <quote>Show all</quote> command is unchecked, pixels spilling 
+      off the canvas boundary are not visible.
+    </para>
+    <para>
+      When the command is checked, all pixels outside the canvas are visible 
+      (if the layer size is enough).You can see:
+      <itemizedlist>
+        <listitem>
+          <para>
+            The canvas boundary as a <emphasis>red dotted line</emphasis>. 
+            You can paint outside the canvas, in the limit of the layer. 
+            Changes made outside the canvas are not exported with the image, 
+            unless you enlarge the canvas size using <link 
+            linkend="gimp-image-resize">Canvas Size</link>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            The layer boundary as a <emphasis>yellow dotted line</emphasis>.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            A large <emphasis>checkerboard area</emphasis> indicating there is 
+            no pixel.
+          </para>
+          <para>
+            The checkerboard area is infinite: whatever the image window size, 
+            it persists.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </para>
+  </sect3>
+  
+  <sect3>
+    <title>Using the <quote>Show All</quote> command</title>
+    <para>
+      We will clone from a new image onto the image.
+    </para>
+    <para>
+      <itemizedlist>
+        <listitem>
+          <para>
+            Open your image, check <quote>Show All</quote>, and enlarge layer.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Open the new image. A new layer is created for this new image. 
+            Click and drag this new layer onto your image. Use Move tool to 
+            put the new image outside canvas.
+          </para>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="JPG"
+                fileref="images/menus/view/show_all-ex-newimg.jpg"/>
+            </imageobject>
+          </mediaobject>
+        </listitem>
+        <listitem>
+          <para>
+            Make new layer active. Use Clone tool and 
+            <keycap>Ctrl</keycap>-click on the new image to make it the 
+            source.
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Make image layer active. Paint on your image to clone the source. 
+            You see that pixels in checkerboard area are cloned.
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <mediaobject>
+        <imageobject>
+          <imagedata format="JPG"
+            fileref="images/menus/view/show_all-ex-clone.jpg"/>
+        </imageobject>
+      </mediaobject>
+
+    </para>
+  </sect3>
+</sect2>
\ No newline at end of file