Syncing docs & updating appdata re: Brush descriptions

docs/gl_ES.UTF-8/EXTENDING.txt

@@ -14,6 +14,7 @@
 |       + Ficheiros estándar                                  |
 |       + Ficheiros persoais                                  |
 |   * Pinceis                                                 |
+|       + Brush Descriptive Text                              |
 |       + Opcións de pinceis                                  |
 |   * Selos                                                   |
 |       + Imaxes de selos                                     |
@@ -159,8 +160,8 @@ brushes/» en Linux ou Unix.)
 
 Pinceis
 
-Os pinceis empregados para debuxar coas ferramentas «Pincel» e «Liñas» en Tux
-Paint son simplemente ficheiros de imaxe PNG.
+The brushes used for drawing with the 'Paint' and 'Lines' tools in Tux Paint
+are simply PNG image files.
 
 A alfa (transparencia) da imaxe PNG úsase para determinar a forma do pincel, o
 que significa que a forma pode ser «alisado» e incluso parcialmente
@@ -169,6 +170,47 @@ transparente.
 Os píxeles de escala de grises no pincel PNG debuxaranse empregando a cor
 seleccionada actualmente en Tux Paint. Os píxeles de cor tinguiranse.
 
+Brush Descriptive Text
+
+Tux Paint will display descriptive text when a brush is selected. These are
+placed in plain text files with the same name as the PNG, but with a ".txt"
+filename extension. (e.g., "brush.png"'s description is stored in "brush.txt"
+in the same directory.)
+
+The first line of the text file will be used as the US English description of
+the brush's image. It must be encoded in UTF-8.
+
+Compatibilidade da localización
+
+    Pódense engadir liñas adicionais ao ficheiro de texto para fornecer
+    traducións da descrición, que se amosarán cando Tux Paint estea a
+    executarse nun idioma diferente (como o francés ou o español).
+
+    O comezo da liña debería corresponder ao código de idioma do idioma en
+    cuestión (por exemplo, «fr» para o francés e «zh_TW» para o chinés
+    tradicional), seguido de «.utf8=» e a descrición traducida (Unicode,
+    codificado en UTF-8).
+
+    Para os desenvolvedores de Tux Paint: Hai scripts no directorio
+    «brushes-po» para converter os ficheiros de texto ao formato PO (e
+    posterior) para facilitar a tradución a diferentes idiomas. Polo tanto,
+    nunca debería engadir nin cambiar traducións directamente nos ficheiros
+    «.txt».
+
+    Se non hai tradución dispoñíbel para o idioma en que se está a executar Tux
+    Paint, utilízase o texto en inglés dos EUA.
+
+
+
+Usuarios de Windows
+
+    Use NotePad ou WordPad para editar/crear estes ficheiros. Asegúrese de
+    gardalos como texto simple e asegúrese de que teñen unha extensión «.txt»
+    ao final do nome do ficheiro.
+
+
+
+
 Opcións de pinceis
 
 Ademais de a graphical shape, a brushes tamén se lle poden dar outros

docs/gl_ES.UTF-8/README.txt

@@ -103,6 +103,10 @@ D. What's New in Tux Paint version 0.9.33?
 Transparent Erasers
     Erasers that lightly expose more and more of the background.
 
+Brush descriptions
+    Brushes (used by Paint and Line tools) can now include descriptions that
+    appear when the brush is selected.
+
 Dither magic tools
     Transform parts of an image into a dithered pattern of dots.
 

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

@@ -121,7 +121,7 @@
                   <li><a href="#standard_files">Ficheiros estándar</a></li>                  <li><a href="#personal_files">Ficheiros persoais</a></li>                </ul>
               </li>
               <li><a href="#brushes">Pinceis</a>                <ul>
-                  <li><a href="#brush_options">Opcións de pinceis</a></li>                </ul>
+                  <li><a href="#brush_description_text">Brush Descriptive Text</a></li>                  <li><a href="#brush_options">Opcións de pinceis</a></li>                </ul>
               </li>
               <li><a href="#stamps">Selos</a>                <ul>
                   <li><a href="#stamps_images">Imaxes de selos</a></li>                  <li><a href="#description_text">Texto descritivo do selo</a></li>                  <li><a href="#sound_effects">Efectos de son dos selos</a></li>                  <li><a href="#descriptive_sound">Son descritivo do selo</a></li>                  <li><a href="#stamp_options">Opcións de selos</a></li>                  <li><a href="#pre_mirroed_and_flipped_images">Selos prereflectidos e invertidos</a></li>                </ul>
@@ -277,7 +277,7 @@
       </header>
 
       <p>
-        Os pinceis empregados para debuxar coas ferramentas «Pincel» e «Liñas» en Tux Paint son simplemente ficheiros de imaxe PNG.      </p>
+        The brushes used for drawing with the 'Paint' and 'Lines' tools in Tux Paint are simply PNG image files.      </p>
       <img src="../../html/images/brush_edit.png"
                   width="123"
                   height="147"
@@ -289,6 +289,41 @@
       <p>
         Os píxeles de escala de grises no pincel PNG debuxaranse empregando a cor seleccionada actualmente en Tux Paint. Os píxeles de cor tinguiranse.      </p>
 
+      <section><!-- H2: Brush Descriptive Text -->
+        <header>
+          <h2>
+            <a name="brush_bescription_text"
+                id="brush_description_text">Brush Descriptive Text</a>
+          </h2>
+        </header>
+
+        <p>
+          Tux Paint will display descriptive text when a brush is selected. These are placed in plain text files with the same name as the PNG, but with a "<code>.txt</code>" filename extension. (e.g., "<code>brush.png</code>"'s description is stored in "<code>brush.txt</code>" in the same directory.)        </p>
+
+        <p>
+          The first line of the text file will be used as the US English description of the brush's image. It must be encoded in UTF-8.        </p>
+
+        <dl>
+          <dt><strong>Compatibilidade da localización</strong></dt>
+          <dd>
+            <p>
+              Pódense engadir liñas adicionais ao ficheiro de texto para fornecer traducións da descrición, que se amosarán cando Tux Paint estea a executarse nun idioma diferente (como o francés ou o español).            </p>
+            <p>
+              O comezo da liña debería corresponder ao código de idioma do idioma en cuestión (por exemplo, «<code>fr</code>» para o francés e «<code>zh_TW</code>» para o chinés tradicional), seguido de «<code>.utf8=</code>» e a descrición traducida (Unicode, codificado en UTF-8).            </p>
+            <p>
+              <b>Para os desenvolvedores de Tux Paint:</b> Hai scripts no directorio «<code>brushes-po</code>» para converter os ficheiros de texto ao formato PO (e posterior) para facilitar a tradución a diferentes idiomas. Polo tanto, nunca debería engadir nin cambiar traducións directamente nos ficheiros «<code>.txt</code>».            </p>
+            <p>
+              Se non hai tradución dispoñíbel para o idioma en que se está a executar Tux Paint, utilízase o texto en inglés dos EUA.            </p>
+          </dd>
+
+          <dt><strong>Usuarios de Windows</strong></dt>
+          <dd>
+            <p>
+              Use <cite>NotePad</cite> ou <cite>WordPad</cite> para editar/crear estes ficheiros. Asegúrese de gardalos como texto simple e asegúrese de que teñen unha extensión «<code>.txt</code>» ao final do nome do ficheiro.            </p>
+          </dd>
+        </dl>
+      </section><!-- H2: Stamp Descriptive Text -->
+
       <section><!-- H2: Brush Options -->
         <header>
           <h2>

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

@@ -231,6 +231,9 @@
   <dt>Transparent Erasers</dt>
   <dd>Erasers that lightly expose more and more of the background.</dd>
 
+  <dt>Brush descriptions</dt>
+  <dd>Brushes (used by Paint and Line tools) can now include descriptions that appear when the brush is selected.</dd>
+
   <dt>Dither magic tools</dt>
   <dd>Transform parts of an image into a dithered pattern of dots.</dd>