[gimp-help] Re-arrange tone-mapping-tutorial

[Julien Hardlin <jhardlin src gnome org>]

commit 9798804b6e68d77701f773483b80c096a71f30a7
Author: Julien Hardelin <jhardlin orange fr>
Date:   Sun Nov 18 08:39:35 2018 +0100

    Re-arrange tone-mapping-tutorial

 .directory                                         |  6 ---
 .../tone-mapping-tutorial.xml                      | 61 ++++++++--------------
 src/gimp.xml                                       |  5 +-
 3 files changed, 24 insertions(+), 48 deletions(-)
---
diff --git a/src/annexes/tone-mapping/tone-mapping-tutorial.xml b/src/appendix/tone-mapping-tutorial.xml
similarity index 97%
rename from src/annexes/tone-mapping/tone-mapping-tutorial.xml
rename to src/appendix/tone-mapping-tutorial.xml
index 2112a5aa2..5f1e7e311 100644
--- a/src/annexes/tone-mapping/tone-mapping-tutorial.xml
+++ b/src/appendix/tone-mapping-tutorial.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                        "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 
-<sect1 id="tone-mapping-tutorial">
+<appendix id="tone-mapping-tutorial">
   <title>
     Tone Mapping and Shadow Recovery Using GIMP’s ‘Colors/Exposure’
   </title>
@@ -22,33 +22,8 @@
     highlight details.
   </para>
 
-  <para>
-    Page Contents
-    <orderedlist>
-      <listitem>
-        <para>
-          <xref linkend="tone-mapping-introduction"/>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <xref linkend="tone-mapping-example"/>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <xref linkend="tone-mapping-notes"/>
-        </para>
-      </listitem>
-      <listitem>
-        <para>
-          <xref linkend="tone-mapping-conclusion"/>
-        </para>
-      </listitem>
-    </orderedlist>
-  </para>
   
-  <sect2 id="tone-mapping-introduction">
+  <sect1 id="tone-mapping-introduction">
     <title>
       High bit depth GIMP’s floating point “Colors/Exposure”: much better than 
       Curves for lightening the shadows and midtones of an image without 
@@ -104,7 +79,8 @@ fileref="images/tutorials/tone-mapping/before-auto-stretch-contrast.jpg"
     <para>
       High bit depth GIMP is my primary image editor, and I’ve used the 
       procedure described below for the last couple of years as my “go to”  
-      way to modify image tonality. The same general procedure can be used to    
+      way to modify image tonality. The same general procedure can be used to   
+ 
       darken as well as lighten portions of an image, again controlling the 
       effect using a layer mask. This isn’t exactly nondestructive editing 
       because at some point you need to make a “New from Visible” layer. But 
@@ -113,9 +89,9 @@ fileref="images/tutorials/tone-mapping/before-auto-stretch-contrast.jpg"
       fine-tune the results by modifying and re-modifying the layer mask 
       until you are completely happy with the resulting tonality.
     </para>
-  </sect2>
+  </sect1>
   
-  <sect2 id="tone-mapping-example">
+  <sect1 id="tone-mapping-example">
     <title>
       A step-by-step example showing how to recover shadow information using 
       high bit depth GIMP’s floating point “Colors/Exposure”
@@ -236,9 +212,11 @@ tree.png</ulink>,
           But the highlights aren’t really blown (that is, clipped to 1.0 in 
           one or more channels). Instead the highlight information is still 
           there, but the RGB channel values fall outside the RGB <ulink url=
-"http://ninedegreesbelow.com/photography/display-referred-scene-referred.html";>  
+"http://ninedegreesbelow.com/photography/display-referred-scene-referred.html";> 
+ 
           display channel value</ulink> range of 0.0f to 1.0f. The sample 
-          points dialog in Figure 4 above shows four sample points that have RGB 
+          points dialog in Figure 4 above shows four sample points that have 
+RGB 
           channel values that are greater than 1.0. As shown in Figure 5 below, 
           adding a mask allows you to recover these highlights by bringing 
           them back down into the display range.
@@ -368,9 +346,9 @@ fileref="images/tutorials/tone-mapping/gegl-exposure-mask-auto-stretched.jpg"
         </para>
       </step>
     </procedure>
-  </sect2>
+  </sect1>
     
-  <sect2 id="tone-mapping-notes">
+  <sect1 id="tone-mapping-notes">
     <title>Use Notes</title>
     <orderedlist>
       <listitem><!--1-->
@@ -393,8 +371,11 @@ fileref="images/tutorials/tone-mapping/gegl-exposure-mask-auto-stretched.jpg"
           using “Colors/Exposure”, Curves, etc. But only modify the mask 
           after using Auto Stretch Contrast on the mask. Otherwise results 
           will be unpredictable: 
-<ulink url="http://ninedegreesbelow.com/photography/unbounded-srgb-levels-gamma-slider.html";>
-Gamma adjustments produce odd results when operating on out of gamut values</ulink>, 
+<ulink 
+url="http://ninedegreesbelow.com/photography/unbounded-srgb-levels-gamma-slider.
+html">
+Gamma adjustments produce odd results when operating on out of gamut 
+values</ulink>, 
          and Curves will summarily clip out of gamut values.
         </para>
       </listitem>
@@ -713,8 +694,8 @@ are also unbounded</ulink>.
         </para>
       </listitem>
     </orderedlist>
-  </sect2>
-  <sect2 id="tone-mapping-conclusion">
+  </sect1>
+  <sect1 id="tone-mapping-conclusion">
     <title>Conclusion</title>
     <para>
       Photographs taken in bright direct sunlight typically are of high 
@@ -757,7 +738,7 @@ are also unbounded</ulink>.
       Stone is licensed under a Creative Commons Attribution-ShareAlike 3.0 
         Unported License.</subscript>
     </para>
-  </sect2>
-</sect1>
+  </sect1>
+</appendix>
 
 
diff --git a/src/gimp.xml b/src/gimp.xml
index fd2149897..93386d4bf 100755
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -203,13 +203,13 @@
       <!-- -->
       </chapter>
   </part>
-  <part id="Annexes">
+  <!--<part id="Annexes">
     <title>Annexes</title>
     <chapter id="Tutorials">
       <title>Tone-mapping</title>
       <xi:include href="annexes/tone-mapping/tone-mapping-tutorial.xml"/>
     </chapter>
-  </part>
+  </part>-->
     
   <xi:include href="key-reference.xml"/>
   <xi:include href="glossary/glossary.xml"/>
@@ -221,6 +221,7 @@
   <xi:include href="appendix/history.xml"/>
   <xi:include href="appendix/bugs.xml"/>
   <xi:include href="appendix/contributing.xml"/>
+  <xi:include href="appendix/tone-mapping-tutorial.xml"/>
   <xi:include href="appendix/fdl.xml"/>
   <xi:include href="help-missing.xml"/>
   <index id="gimp-help-index"/>