From 90a7a6dfeb80526c29edea6754c803abbdd5d6f8 Mon Sep 17 00:00:00 2001
From: William Kendrick <wkendrick@users.sourceforge.net>
Date: Thu, 26 Apr 2007 23:32:56 +0000
Subject: [PATCH] Explained (as best I could) flags in IM files. Noted that IM
 and PO additions require code and Makefile updates, too!

---
 docs/EXTENDING.txt       | 19 +++++++++++++++----
 docs/html/EXTENDING.html | 22 ++++++++++++++++++----
 2 files changed, 33 insertions(+), 8 deletions(-)

diff --git a/docs/EXTENDING.txt b/docs/EXTENDING.txt
index 64ddea066..c9e3c3139 100644
--- a/docs/EXTENDING.txt
+++ b/docs/EXTENDING.txt
@@ -572,6 +572,11 @@ Translations
      to the CVS source code repository so that you may commit your changes
      directly.
 
+     Note: Additional locale support requires additions to Tux Paint's source
+     code (/src/i18n.h and /src/i18n.c), and requires updates to the
+     Makefile, to have the ".po" gettext catalog source files compiled into
+     ".mo" files, and installed, for use at runtime.
+
 Alternative Input Methods
 
      As of version 0.9.17, Tux Paint's "Text" tool can provide alternative
@@ -615,8 +620,14 @@ Alternative Input Methods
        30AD   ki   -
        30AE   gi   -
 
-     Note: Blank lines will be ignored, as will any text following a "#"
-     (pound/hash) character -- they can be used to denote comments, as seen
-     in the example above.
+     Note: Blank lines within the ".im" file will be ignored, as will any
+     text following a "#" (pound/hash) character -- it can be used to denote
+     comments, as seen in the example above.
 
-     Note: Flags need to be explained here.
+     Note: Flags must be set up on a per-locale basis (within the source
+     code, in "src/im.c"). For example, "b" is used in Korean to handle
+     Batchim, which may carry over to the next character.
+
+     Note: Additional input method support requires additions to Tux Paint's
+     source code (/src/im.c), and requires updates to the Makefile, to have
+     the ".im" files installed, for use at runtime.
diff --git a/docs/html/EXTENDING.html b/docs/html/EXTENDING.html
index 3f3cab5e8..fd8a951cd 100644
--- a/docs/html/EXTENDING.html
+++ b/docs/html/EXTENDING.html
@@ -738,6 +738,12 @@ effect.</p>
   to the CVS source code repository so that you may commit your changes
   directly.</p>
 
+  <p><i>Note:</i> Additional locale support requires additions
+  to Tux&nbsp;Paint's source code (<code>/src/i18n.h</code> and
+  <code>/src/i18n.c</code>), and requires updates to the <code>Makefile</code>,
+  to have the "<code>.po</code>" gettext catalog source files compiled into
+  "<code>.mo</code>" files, and installed, for use at runtime.</p>
+
 </blockquote>
 
 <h2>Alternative Input Methods</h2>
@@ -790,12 +796,20 @@ effect.</p>
   </code></p>
   </blockquote>
 
-  <p><i>Note:</i> Blank lines will be ignored, as will any text following
-  a "<code>#</code>" (pound/hash) character &mdash; they can be used to
-  denote comments, as seen in the example above.</p>
+  <p><i>Note:</i> Blank lines within the "<code>.im</code>" file
+  will be ignored, as will any text following a "<code>#</code>"
+  (pound/hash) character &mdash; it can be used to denote comments,
+  as seen in the example above.</p>
 
-  <p><i>Note:</i> Flags need to be explained here.</p>
+  <p><i>Note:</i> Flags must be set up on a per-locale basis
+  (within the source code, in "<code>src/im.c</code>").
+  For example, "<code>b</code>" is used in Korean to handle
+  Batchim, which may carry over to the next character.</p>
 
+  <p><i>Note:</i> Additional input method support requires additions
+  to Tux&nbsp;Paint's source code (<code>/src/im.c</code>), and requires
+  updates to the <code>Makefile</code>,
+  to have the "<code>.im</code>" files installed, for use at runtime.</p>
 </blockquote>
 
 </body></html>