Sync docs after more template/starters options work

docs/en/EXTENDING.txt

@@ -638,7 +638,7 @@ Starter Options
               * If it's acceptable to crop either the top and bottom or the
                 left and right, use "allowscale=both". Contents from starter
                 will always fill the canvas, regardless of how its aspect
-                ratio compare to that of the canvas.
+                ratio compares to that of the canvas.
               * The default behavior is to not allow cropping. This may be
                 specified explicitly with "allowscale=none".
 
@@ -657,6 +657,9 @@ Starter Options
            136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g.,
            "#ff4488" or "#F48").
 
+           See the "Color Palette File" section of "Options documentation"
+           for further details.
+
    gravity
 
            This option allows you to specify how Tux Paint should position a
@@ -670,7 +673,7 @@ Starter Options
            bottom right is important, specify "gravity=bottom-right".
 
            The available options are:
-
+              * center — prefer the center (the default)
               * top — prefer the top center
               * bottom — prefer the bottom center
               * left — prefer the left center
@@ -679,14 +682,33 @@ Starter Options
               * top-right — prefer the top right
               * bottom-left — prefer the bottom left
               * bottom-right — prefer the bottom right
+
+           [ Landscape-shaped image of a horizon with the sun in the middle
+           and a building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun in the middle
+           and the left side of building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            height of the canvas.
+
+           [ Landscape-shaped image of the sky with the sun at the bottom and
+           the top of building on the right. ]
+
            Focusing on the top of a starter image stretched to fit the width
            of the canvas.
+
+           [ Landscape-shaped image of the ground with the sun at the top. ]
+
            Focusing on the bottom of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun on the left and
+           a building in the center. ]
+
            Focusing on the right of a starter image stretched to fit the
            height of the canvas.
 
@@ -741,8 +763,8 @@ Template Options
                                   Translations
 
    Tux Paint supports numerous languages, thanks to use of the "gettext"
-   localization library. (See "Options documentation" for how to change
+   localization library. (See the "Languages" section of "Options
-   locales in Tux Paint.)
+   documentation" for how to change locales in Tux Paint.)
 
    To translate Tux Paint to a new language, copy the translation template
    file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder

docs/en/html/EXTENDING.html

@@ -786,7 +786,7 @@
               </li><!-- allowscale=vertical -->
 
               <li><!-- allowscale=both -->
-                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas.              </li><!-- allowscale=both -->
+                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compares to that of the canvas.              </li><!-- allowscale=both -->
 
               <li><!-- allowscale=none -->
                 The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>".              </li><!-- allowscale=none -->
@@ -801,6 +801,8 @@
               You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>").            </p>
             <p>
               Colors may be listed using three decimal numbers (e.g., "<code>255 68 136</code>") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "<code>#ff4488</code>" or "<code>#F48</code>").            </p>
+            <p>
+              See the <a href="OPTIONS.html#colorfile">"Color Palette File" section of "Options documentation"</a> for further details.            </p>
           </dd><!-- background -->
 
           <dt><strong>gravity</strong></dt>
@@ -811,8 +813,8 @@
               For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>".  Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>".            </p>
 
             <p>
-              The available options are:            </p>
+              The available options are:              <ul>
-            <ul>
+                <li><code><b>center</b></code> &mdash; prefer the center (the default)</li>
                 <li><code><b>top</b></code> &mdash; prefer the top center</li>
                 <li><code><b>bottom</b></code> &mdash; prefer the bottom center</li>
                 <li><code><b>left</b></code> &mdash; prefer the left center</li>
@@ -822,16 +824,19 @@
                 <li><code><b>bottom-left</b></code> &mdash; prefer the bottom left</li>
                 <li><code><b>bottom-right</b></code> &mdash; prefer the bottom right</li>
               </ul>
+            </p>
 
                           <div style="display: inline-block; border: 1px solid #888; width: 320px;">
                 <figure style="text-align: center;">
                   <img src="../../html/images/gravity-center-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
+                    title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -839,10 +844,12 @@
                   <img src="../../html/images/gravity-center-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
+                    title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -850,10 +857,12 @@
                   <img src="../../html/images/gravity-top-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
+                    title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the top of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -861,10 +870,12 @@
                   <img src="../../html/images/gravity-bottom-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
+                    title="Landscape-shaped image of the ground with the sun at the top."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the bottom of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -872,10 +883,12 @@
                   <img src="../../html/images/gravity-right-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
+                    title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the right of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                         </dd><!-- gravity -->
@@ -946,7 +959,7 @@
       </header>
 
       <p>
-        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See "Options documentation" for how to change locales in Tux Paint.)      </p>
+        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See <a href="OPTIONS.html#languages">the "Languages" section of "Options documentation"</a> for how to change locales in Tux Paint.)      </p>
 
       <p>
         To translate Tux Paint to a new language, copy the translation template file, "<code>tuxpaint.pot</code>" (found in Tux Paint's source code, in the folder "<code>src/po/</code>"). Rename the copy as a "<code>.po</code>" file, with an appropriate name for the locale you're translating to (e.g., "<code>es.po</code>" for Spanish; or "<code>pt_BR.po</code>" for Brazilian Portuguese, versus "<code>pt.po</code>" or "<code>pt_PT.po</code>" for Portuguese spoken in Portugal.)      </p>

docs/en/html/OPTIONS.html

@@ -1857,7 +1857,7 @@
 
 <section>
   <header>
-    <h3>Color Palette File</h3>
+    <h3 id="colorfile">Color Palette File</h3>
   </header>
 
   <dl>

docs/es_ES.UTF-8/EXTENDING.txt

@@ -638,7 +638,7 @@ Starter Options
               * If it's acceptable to crop either the top and bottom or the
                 left and right, use "allowscale=both". Contents from starter
                 will always fill the canvas, regardless of how its aspect
-                ratio compare to that of the canvas.
+                ratio compares to that of the canvas.
               * The default behavior is to not allow cropping. This may be
                 specified explicitly with "allowscale=none".
 
@@ -657,6 +657,9 @@ Starter Options
            136") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g.,
            "#ff4488" or "#F48").
 
+           See the "Color Palette File" section of "Options documentation"
+           for further details.
+
    gravity
 
            This option allows you to specify how Tux Paint should position a
@@ -670,7 +673,7 @@ Starter Options
            bottom right is important, specify "gravity=bottom-right".
 
            The available options are:
-
+              * center — prefer the center (the default)
               * top — prefer the top center
               * bottom — prefer the bottom center
               * left — prefer the left center
@@ -679,14 +682,33 @@ Starter Options
               * top-right — prefer the top right
               * bottom-left — prefer the bottom left
               * bottom-right — prefer the bottom right
+
+           [ Landscape-shaped image of a horizon with the sun in the middle
+           and a building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun in the middle
+           and the left side of building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            height of the canvas.
+
+           [ Landscape-shaped image of the sky with the sun at the bottom and
+           the top of building on the right. ]
+
            Focusing on the top of a starter image stretched to fit the width
            of the canvas.
+
+           [ Landscape-shaped image of the ground with the sun at the top. ]
+
            Focusing on the bottom of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun on the left and
+           a building in the center. ]
+
            Focusing on the right of a starter image stretched to fit the
            height of the canvas.
 
@@ -741,8 +763,8 @@ Template Options
                                   Translations
 
    Tux Paint supports numerous languages, thanks to use of the "gettext"
-   localization library. (See "Options documentation" for how to change
+   localization library. (See the "Languages" section of "Options
-   locales in Tux Paint.)
+   documentation" for how to change locales in Tux Paint.)
 
    To translate Tux Paint to a new language, copy the translation template
    file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder

docs/es_ES.UTF-8/html/EXTENDING.html

@@ -786,7 +786,7 @@
               </li><!-- allowscale=vertical -->
 
               <li><!-- allowscale=both -->
-                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas.              </li><!-- allowscale=both -->
+                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compares to that of the canvas.              </li><!-- allowscale=both -->
 
               <li><!-- allowscale=none -->
                 The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>".              </li><!-- allowscale=none -->
@@ -801,6 +801,8 @@
               You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>").            </p>
             <p>
               Colors may be listed using three decimal numbers (e.g., "<code>255 68 136</code>") or a 6- or 3-digit-long hexadecimal 'triplet' (e.g., "<code>#ff4488</code>" or "<code>#F48</code>").            </p>
+            <p>
+              See the <a href="OPTIONS.html#colorfile">"Color Palette File" section of "Options documentation"</a> for further details.            </p>
           </dd><!-- background -->
 
           <dt><strong>gravity</strong></dt>
@@ -811,8 +813,8 @@
               For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>".  Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>".            </p>
 
             <p>
-              The available options are:            </p>
+              The available options are:              <ul>
-            <ul>
+                <li><code><b>center</b></code> &mdash; prefer the center (the default)</li>
                 <li><code><b>top</b></code> &mdash; prefer the top center</li>
                 <li><code><b>bottom</b></code> &mdash; prefer the bottom center</li>
                 <li><code><b>left</b></code> &mdash; prefer the left center</li>
@@ -822,16 +824,19 @@
                 <li><code><b>bottom-left</b></code> &mdash; prefer the bottom left</li>
                 <li><code><b>bottom-right</b></code> &mdash; prefer the bottom right</li>
               </ul>
+            </p>
 
                           <div style="display: inline-block; border: 1px solid #888; width: 320px;">
                 <figure style="text-align: center;">
                   <img src="../../html/images/gravity-center-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
+                    title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -839,10 +844,12 @@
                   <img src="../../html/images/gravity-center-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
+                    title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -850,10 +857,12 @@
                   <img src="../../html/images/gravity-top-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
+                    title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the top of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -861,10 +870,12 @@
                   <img src="../../html/images/gravity-bottom-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
+                    title="Landscape-shaped image of the ground with the sun at the top."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the bottom of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -872,10 +883,12 @@
                   <img src="../../html/images/gravity-right-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
+                    title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the right of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                         </dd><!-- gravity -->
@@ -946,7 +959,7 @@
       </header>
 
       <p>
-        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See "Options documentation" for how to change locales in Tux Paint.)      </p>
+        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See <a href="OPTIONS.html#languages">the "Languages" section of "Options documentation"</a> for how to change locales in Tux Paint.)      </p>
 
       <p>
         To translate Tux Paint to a new language, copy the translation template file, "<code>tuxpaint.pot</code>" (found in Tux Paint's source code, in the folder "<code>src/po/</code>"). Rename the copy as a "<code>.po</code>" file, with an appropriate name for the locale you're translating to (e.g., "<code>es.po</code>" for Spanish; or "<code>pt_BR.po</code>" for Brazilian Portuguese, versus "<code>pt.po</code>" or "<code>pt_PT.po</code>" for Portuguese spoken in Portugal.)      </p>

docs/es_ES.UTF-8/html/OPTIONS.html

@@ -1857,7 +1857,7 @@
 
 <section>
   <header>
-    <h3>Color Palette File</h3>
+    <h3 id="colorfile">Color Palette File</h3>
   </header>
 
   <dl>

docs/fr_FR.UTF-8/EXTENDING.txt

@@ -684,7 +684,7 @@ Starter Options
               * If it's acceptable to crop either the top and bottom or the
                 left and right, use "allowscale=both". Contents from starter
                 will always fill the canvas, regardless of how its aspect
-                ratio compare to that of the canvas.
+                ratio compares to that of the canvas.
               * The default behavior is to not allow cropping. This may be
                 specified explicitly with "allowscale=none".
 
@@ -703,6 +703,9 @@ Starter Options
            décimaux (par exemple, "255 68 136") ou un 'triplet' hexadécimal
            de 6 ou 3 chiffres (par exemple, " #ff4488" ou "#F48").
 
+           See the "Color Palette File" section of "Options documentation"
+           for further details.
+
    gravity
 
            This option allows you to specify how Tux Paint should position a
@@ -716,7 +719,7 @@ Starter Options
            bottom right is important, specify "gravity=bottom-right".
 
            The available options are:
-
+              * center — prefer the center (the default)
               * top — prefer the top center
               * bottom — prefer the bottom center
               * left — prefer the left center
@@ -725,14 +728,33 @@ Starter Options
               * top-right — prefer the top right
               * bottom-left — prefer the bottom left
               * bottom-right — prefer the bottom right
+
+           [ Landscape-shaped image of a horizon with the sun in the middle
+           and a building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun in the middle
+           and the left side of building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            height of the canvas.
+
+           [ Landscape-shaped image of the sky with the sun at the bottom and
+           the top of building on the right. ]
+
            Focusing on the top of a starter image stretched to fit the width
            of the canvas.
+
+           [ Landscape-shaped image of the ground with the sun at the top. ]
+
            Focusing on the bottom of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun on the left and
+           a building in the center. ]
+
            Focusing on the right of a starter image stretched to fit the
            height of the canvas.
 
@@ -789,9 +811,9 @@ Template Options
 
                                   Traductions
 
-   Tux Paint supporte de nombreux langages, grâce à l'utilisation de la
+   Tux Paint supports numerous languages, thanks to use of the "gettext"
-   bibliothèque de localisation "gettext". (Voir OPTIONS pour savoir comment
+   localization library. (See the "Languages" section of "Options
-   changer les paramètres régionaux dans Tux Paint .)
+   documentation" for how to change locales in Tux Paint.)
 
    Pour traduire Tux Paint dans une nouvelle langue, copiez le fichier de
    modèle de traduction, "tuxpaint.pot" (trouvé avec le code source de Tux

docs/fr_FR.UTF-8/html/EXTENDING.html

@@ -786,7 +786,7 @@
               </li><!-- allowscale=vertical -->
 
               <li><!-- allowscale=both -->
-                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas.              </li><!-- allowscale=both -->
+                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compares to that of the canvas.              </li><!-- allowscale=both -->
 
               <li><!-- allowscale=none -->
                 The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>".              </li><!-- allowscale=none -->
@@ -801,6 +801,8 @@
               You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>").            </p>
             <p>
               Les couleurs peuvent être listées en utilisant trois nombres décimaux (par exemple, "<code>255 68 136</code>") ou un 'triplet' hexadécimal de 6 ou 3 chiffres (par exemple, " <code>#ff4488</code>" ou "<code>#F48</code>").            </p>
+            <p>
+              See the <a href="OPTIONS.html#colorfile">"Color Palette File" section of "Options documentation"</a> for further details.            </p>
           </dd><!-- background -->
 
           <dt><strong>gravity</strong></dt>
@@ -811,8 +813,8 @@
               For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>".  Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>".            </p>
 
             <p>
-              The available options are:            </p>
+              The available options are:              <ul>
-            <ul>
+                <li><code><b>center</b></code> &mdash; prefer the center (the default)</li>
                 <li><code><b>top</b></code> &mdash; prefer the top center</li>
                 <li><code><b>bottom</b></code> &mdash; prefer the bottom center</li>
                 <li><code><b>left</b></code> &mdash; prefer the left center</li>
@@ -822,16 +824,19 @@
                 <li><code><b>bottom-left</b></code> &mdash; prefer the bottom left</li>
                 <li><code><b>bottom-right</b></code> &mdash; prefer the bottom right</li>
               </ul>
+            </p>
 
                           <div style="display: inline-block; border: 1px solid #888; width: 320px;">
                 <figure style="text-align: center;">
                   <img src="../../html/images/gravity-center-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
+                    title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -839,10 +844,12 @@
                   <img src="../../html/images/gravity-center-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
+                    title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -850,10 +857,12 @@
                   <img src="../../html/images/gravity-top-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
+                    title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the top of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -861,10 +870,12 @@
                   <img src="../../html/images/gravity-bottom-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
+                    title="Landscape-shaped image of the ground with the sun at the top."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the bottom of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -872,10 +883,12 @@
                   <img src="../../html/images/gravity-right-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
+                    title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the right of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                         </dd><!-- gravity -->
@@ -946,7 +959,7 @@
       </header>
 
       <p>
-        Tux Paint supporte de nombreux langages, grâce à l'utilisation de la bibliothèque de localisation "gettext". (Voir OPTIONS pour savoir comment changer les paramètres régionaux dans Tux Paint .)      </p>
+        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See <a href="OPTIONS.html#languages">the "Languages" section of "Options documentation"</a> for how to change locales in Tux Paint.)      </p>
 
       <p>
         Pour traduire Tux Paint dans une nouvelle langue, copiez le fichier de modèle de traduction, "<code>tuxpaint.pot</code>" (trouvé avec le code source de Tux Paint , dans le dossier "<code>src/po/</code>"). Renommez la copie en tant que  "<code>.po</code>", avec le nom approprié aux paramètres régionaux de votre traduction (par exemple, "<code>es.po</code>" pour l'espagnol; ou "<code>pt_BR.po</code>" pour le portugais brésilien , contre "<code>pt.po</code>" ou "<code>pt_PT.po</code>" pour le portugais parlé au Portugal).      </p>

docs/fr_FR.UTF-8/html/OPTIONS.html

@@ -1857,7 +1857,7 @@
 
 <section>
   <header>
-    <h3>Fichier de palette de couleur</h3>
+    <h3 id="colorfile">Fichier de palette de couleur</h3>
   </header>
 
   <dl>

docs/gl_ES.UTF-8/EXTENDING.txt

@@ -654,7 +654,7 @@ Starter Options
               * If it's acceptable to crop either the top and bottom or the
                 left and right, use "allowscale=both". Contents from starter
                 will always fill the canvas, regardless of how its aspect
-                ratio compare to that of the canvas.
+                ratio compares to that of the canvas.
               * The default behavior is to not allow cropping. This may be
                 specified explicitly with "allowscale=none".
 
@@ -673,6 +673,9 @@ Starter Options
            exemplo, «255 68 136») ou un «triplete» hexadecimal de 6 ou 3
            díxitos de longo (por exemplo, «#ff4488» ou «#F48»).
 
+           See the "Color Palette File" section of "Options documentation"
+           for further details.
+
    gravity
 
            This option allows you to specify how Tux Paint should position a
@@ -686,7 +689,7 @@ Starter Options
            bottom right is important, specify "gravity=bottom-right".
 
            The available options are:
-
+              * center — prefer the center (the default)
               * top — prefer the top center
               * bottom — prefer the bottom center
               * left — prefer the left center
@@ -695,14 +698,33 @@ Starter Options
               * top-right — prefer the top right
               * bottom-left — prefer the bottom left
               * bottom-right — prefer the bottom right
+
+           [ Landscape-shaped image of a horizon with the sun in the middle
+           and a building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun in the middle
+           and the left side of building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            height of the canvas.
+
+           [ Landscape-shaped image of the sky with the sun at the bottom and
+           the top of building on the right. ]
+
            Focusing on the top of a starter image stretched to fit the width
            of the canvas.
+
+           [ Landscape-shaped image of the ground with the sun at the top. ]
+
            Focusing on the bottom of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun on the left and
+           a building in the center. ]
+
            Focusing on the right of a starter image stretched to fit the
            height of the canvas.
 
@@ -758,9 +780,9 @@ Template Options
 
                                    Traducións
 
-   Tux Paint admite numerosos idiomas grazas ao uso da biblioteca de
+   Tux Paint supports numerous languages, thanks to use of the "gettext"
-   localización «gettext». (Vexa a «Documentación de opcións» para saber como
+   localization library. (See the "Languages" section of "Options
-   cambiar a configuración local en Tux Paint.)
+   documentation" for how to change locales in Tux Paint.)
 
    Para traducir Tux Paint a un novo idioma, copie o ficheiro de modelo de
    tradución, «tuxpaint.pot» (atopado no código fonte de Tux Paint, no

docs/gl_ES.UTF-8/html/EXTENDING.html

@@ -786,7 +786,7 @@
               </li><!-- allowscale=vertical -->
 
               <li><!-- allowscale=both -->
-                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas.              </li><!-- allowscale=both -->
+                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compares to that of the canvas.              </li><!-- allowscale=both -->
 
               <li><!-- allowscale=none -->
                 The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>".              </li><!-- allowscale=none -->
@@ -801,6 +801,8 @@
               You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>").            </p>
             <p>
               As cores pódense enumerar usando tres números decimais (por exemplo, «<code>255 68 136</code>») ou un «triplete» hexadecimal de 6 ou 3 díxitos de longo (por exemplo, «<code>#ff4488</code>» ou «<code>#F48</code>»).            </p>
+            <p>
+              See the <a href="OPTIONS.html#colorfile">"Color Palette File" section of "Options documentation"</a> for further details.            </p>
           </dd><!-- background -->
 
           <dt><strong>gravity</strong></dt>
@@ -811,8 +813,8 @@
               For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>".  Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>".            </p>
 
             <p>
-              The available options are:            </p>
+              The available options are:              <ul>
-            <ul>
+                <li><code><b>center</b></code> &mdash; prefer the center (the default)</li>
                 <li><code><b>top</b></code> &mdash; prefer the top center</li>
                 <li><code><b>bottom</b></code> &mdash; prefer the bottom center</li>
                 <li><code><b>left</b></code> &mdash; prefer the left center</li>
@@ -822,16 +824,19 @@
                 <li><code><b>bottom-left</b></code> &mdash; prefer the bottom left</li>
                 <li><code><b>bottom-right</b></code> &mdash; prefer the bottom right</li>
               </ul>
+            </p>
 
                           <div style="display: inline-block; border: 1px solid #888; width: 320px;">
                 <figure style="text-align: center;">
                   <img src="../../html/images/gravity-center-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
+                    title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -839,10 +844,12 @@
                   <img src="../../html/images/gravity-center-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
+                    title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -850,10 +857,12 @@
                   <img src="../../html/images/gravity-top-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
+                    title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the top of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -861,10 +870,12 @@
                   <img src="../../html/images/gravity-bottom-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
+                    title="Landscape-shaped image of the ground with the sun at the top."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the bottom of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -872,10 +883,12 @@
                   <img src="../../html/images/gravity-right-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
+                    title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the right of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                         </dd><!-- gravity -->
@@ -946,7 +959,7 @@
       </header>
 
       <p>
-        Tux Paint admite numerosos idiomas grazas ao uso da biblioteca de localización «gettext». (Vexa a «Documentación de opcións» para saber como cambiar a configuración local en Tux Paint.)      </p>
+        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See <a href="OPTIONS.html#languages">the "Languages" section of "Options documentation"</a> for how to change locales in Tux Paint.)      </p>
 
       <p>
         Para traducir Tux Paint a un novo idioma, copie o ficheiro de modelo de tradución, «<code>tuxpaint.pot</code>» (atopado no código fonte de Tux Paint, no cartafol «<code>src/po/</code>»). Cambie o nome da copia como un ficheiro «<code>.po</code>», cun nome apropiado para o idioma ao que está a traducir (p. ex.: «<code>es.po</code>» para o español; ou «<code>pt_BR.po</code>» para o portugués brasileiro fronte a «<code>pt.po</code>» ou «<code>pt_PT.po</code>» para o portugués falado en Portugal.)      </p>

docs/gl_ES.UTF-8/html/OPTIONS.html

@@ -1857,7 +1857,7 @@
 
 <section>
   <header>
-    <h3>Color Palette File</h3>
+    <h3 id="colorfile">Color Palette File</h3>
   </header>
 
   <dl>

docs/ja_JP.UTF-8/EXTENDING.txt

@@ -638,7 +638,7 @@ Starter Options
               * If it's acceptable to crop either the top and bottom or the
                 left and right, use "allowscale=both". Contents from starter
                 will always fill the canvas, regardless of how its aspect
-                ratio compare to that of the canvas.
+                ratio compares to that of the canvas.
               * The default behavior is to not allow cropping. This may be
                 specified explicitly with "allowscale=none".
 
@@ -656,6 +656,9 @@ Starter Options
            各行の色は、３つの十進数の組み（例: "255 68 136"）、あるいは、3つの16 進数の組からなる6桁または3桁の表記（例:
            "#ff4488" または "#F48”）で指定します。
 
+           See the "Color Palette File" section of "Options documentation"
+           for further details.
+
    gravity
 
            This option allows you to specify how Tux Paint should position a
@@ -669,7 +672,7 @@ Starter Options
            bottom right is important, specify "gravity=bottom-right".
 
            The available options are:
-
+              * center — prefer the center (the default)
               * top — prefer the top center
               * bottom — prefer the bottom center
               * left — prefer the left center
@@ -678,14 +681,33 @@ Starter Options
               * top-right — prefer the top right
               * bottom-left — prefer the bottom left
               * bottom-right — prefer the bottom right
+
+           [ Landscape-shaped image of a horizon with the sun in the middle
+           and a building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun in the middle
+           and the left side of building on the right. ]
+
            Focusing on the center of a starter image stretched to fit the
            height of the canvas.
+
+           [ Landscape-shaped image of the sky with the sun at the bottom and
+           the top of building on the right. ]
+
            Focusing on the top of a starter image stretched to fit the width
            of the canvas.
+
+           [ Landscape-shaped image of the ground with the sun at the top. ]
+
            Focusing on the bottom of a starter image stretched to fit the
            width of the canvas.
+
+           [ Portrait-shaped image of a horizon with the sun on the left and
+           a building in the center. ]
+
            Focusing on the right of a starter image stretched to fit the
            height of the canvas.
 
@@ -740,8 +762,8 @@ Template Options
                                   Translations
 
    Tux Paint supports numerous languages, thanks to use of the "gettext"
-   localization library. (See "Options documentation" for how to change
+   localization library. (See the "Languages" section of "Options
-   locales in Tux Paint.)
+   documentation" for how to change locales in Tux Paint.)
 
    To translate Tux Paint to a new language, copy the translation template
    file, "tuxpaint.pot" (found in Tux Paint's source code, in the folder

docs/ja_JP.UTF-8/html/EXTENDING.html

@@ -786,7 +786,7 @@
               </li><!-- allowscale=vertical -->
 
               <li><!-- allowscale=both -->
-                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compare to that of the canvas.              </li><!-- allowscale=both -->
+                If it's acceptable to crop either the top and bottom or the left and right, use "<code><b>allowscale=both</b></code>". Contents from starter will always fill the canvas, regardless of how its aspect ratio compares to that of the canvas.              </li><!-- allowscale=both -->
 
               <li><!-- allowscale=none -->
                 The default behavior is to not allow cropping. This may be specified explicitly with "<code><b>allowscale=none</b></code>".              </li><!-- allowscale=none -->
@@ -801,6 +801,8 @@
               You can instead specify a solid background color (e.g., white for a 'coloring-book' style starter, with "<code><b>background=#fff</b></code>").            </p>
             <p>
               各行の色は、３つの十進数の組み（例: "<code>255 68 136</code>"）、あるいは、3つの16 進数の組からなる6桁または3桁の表記（例: "<code>#ff4488</code>" または "<code>#F48</code>”）で指定します。            </p>
+            <p>
+              See the <a href="OPTIONS.html#colorfile">"Color Palette File" section of "Options documentation"</a> for further details.            </p>
           </dd><!-- background -->
 
           <dt><strong>gravity</strong></dt>
@@ -811,8 +813,8 @@
               For example, if the top center of the starter contains the most important content, you can specify "<code><b>gravity=top</b></code>".  Or, if the bottom right is important, specify "<code><b>gravity=bottom-right</b></code>".            </p>
 
             <p>
-              The available options are:            </p>
+              The available options are:              <ul>
-            <ul>
+                <li><code><b>center</b></code> &mdash; prefer the center (the default)</li>
                 <li><code><b>top</b></code> &mdash; prefer the top center</li>
                 <li><code><b>bottom</b></code> &mdash; prefer the bottom center</li>
                 <li><code><b>left</b></code> &mdash; prefer the left center</li>
@@ -822,16 +824,19 @@
                 <li><code><b>bottom-left</b></code> &mdash; prefer the bottom left</li>
                 <li><code><b>bottom-right</b></code> &mdash; prefer the bottom right</li>
               </ul>
+            </p>
 
                           <div style="display: inline-block; border: 1px solid #888; width: 320px;">
                 <figure style="text-align: center;">
                   <img src="../../html/images/gravity-center-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of a horizon with the sun in the middle and a building on the right. ]"
+                    title="Landscape-shaped image of a horizon with the sun in the middle and a building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -839,10 +844,12 @@
                   <img src="../../html/images/gravity-center-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right. ]"
+                    title="Portrait-shaped image of a horizon with the sun in the middle and the left side of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the center of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the center of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -850,10 +857,12 @@
                   <img src="../../html/images/gravity-top-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right. ]"
+                    title="Landscape-shaped image of the sky with the sun at the bottom and the top of building on the right."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the top of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the top of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -861,10 +870,12 @@
                   <img src="../../html/images/gravity-bottom-landscape.png"
                     width="160"
                     height="72"
-                  alt=""
+                    alt="[ Landscape-shaped image of the ground with the sun at the top. ]"
+                    title="Landscape-shaped image of the ground with the sun at the top."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the bottom of a starter image stretched to fit the width of the canvas.                </figcaption>
+                    <p>Focusing on the bottom of a starter image stretched to fit the width of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                             <div style="display: inline-block; border: 1px solid #888; width: 320px;">
@@ -872,10 +883,12 @@
                   <img src="../../html/images/gravity-right-portrait.png"
                     width="84"
                     height="160"
-                  alt=""
+                    alt="[ Portrait-shaped image of a horizon with the sun on the left and a building in the center. ]"
+                    title="Portrait-shaped image of a horizon with the sun on the left and a building in the center."
                     valign="middle" />
                   <figcaption style="font-size: smaller;">
-                  Focusing on the right of a starter image stretched to fit the height of the canvas.                </figcaption>
+                    <p>Focusing on the right of a starter image stretched to fit the height of the canvas.<p/>
+                  </figcaption>
                 </figure>
               </div>
                         </dd><!-- gravity -->
@@ -946,7 +959,7 @@
       </header>
 
       <p>
-        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See "Options documentation" for how to change locales in Tux Paint.)      </p>
+        Tux Paint supports numerous languages, thanks to use of the "gettext" localization library. (See <a href="OPTIONS.html#languages">the "Languages" section of "Options documentation"</a> for how to change locales in Tux Paint.)      </p>
 
       <p>
         To translate Tux Paint to a new language, copy the translation template file, "<code>tuxpaint.pot</code>" (found in Tux Paint's source code, in the folder "<code>src/po/</code>"). Rename the copy as a "<code>.po</code>" file, with an appropriate name for the locale you're translating to (e.g., "<code>es.po</code>" for Spanish; or "<code>pt_BR.po</code>" for Brazilian Portuguese, versus "<code>pt.po</code>" or "<code>pt_PT.po</code>" for Portuguese spoken in Portugal.)      </p>

docs/ja_JP.UTF-8/html/OPTIONS.html

@@ -1857,7 +1857,7 @@
 
 <section>
   <header>
-    <h3>カラーパレットファイル</h3>
+    <h3 id="colorfile">カラーパレットファイル</h3>
   </header>
 
   <dl>