[docs] winedev: Update "Adding New Languages" section

Frédéric Delanoy frederic.delanoy at gmail.com
Mon Sep 9 10:51:01 CDT 2013


---
 en/winedev-coding.sgml | 49 ++++++++++++++-----------------------------------
 1 file changed, 14 insertions(+), 35 deletions(-)

diff --git a/en/winedev-coding.sgml b/en/winedev-coding.sgml
index edc1d87..f450a7f 100644
--- a/en/winedev-coding.sgml
+++ b/en/winedev-coding.sgml
@@ -442,50 +442,29 @@ AC_CHECK_HEADER(foo.h, AC_DEFINE(HAVE_FOO_H))
     <title>Adding New Languages</title>
 
     <para>
-      This file documents the necessary procedure for adding a new
+      This section documents the procedure for adding a new
       language to the list of languages that Wine can display system
       menus and forms in. Adding new translations is not hard as it
       requires no programming knowledge or special skills.
     </para>
 
     <para>
-      Language dependent resources reside in files named
-      <filename><replaceable>somefile</replaceable>_<replaceable>Xx</replaceable>.rc</filename> or
-      <filename><replaceable>Xx</replaceable>.rc</filename>, where <replaceable>Xx</replaceable>
-      is your language  abbreviation (look for it in
-      <filename class="headerfile">include/winnls.h</filename>). These are included
-      in a master file named <filename><replaceable>somefile</replaceable>.rc</filename> or
-      <filename>rsrc.rc</filename>, located in the same
-      directory as the language files.
+      First add the language ID (most often like <replaceable>xx</replaceable>, e.g.
+      <literal>fr</literal> for French, or
+      <replaceable>xx</replaceable>_<replaceable>YY</replaceable> for country-specific variations,
+      e.g. <literal>pt_BR</literal> for Brazilian Portuguese ; look in
+      <filename>tools/wmc/po.c</filename> for a list) in the <literal>LINGUAS</literal> section of
+      <filename>configure.ac</filename>, and in <filename>po/LINGUAS</filename>.
     </para>
 
     <para>
-      To add a new language to one of these resources you
-      need to make a copy of the English resource (located
-      in the <filename><replaceable>somefile</replaceable>_En.rc</filename> file) over to your
-      <filename><replaceable>somefile</replaceable>_<replaceable>Xx</replaceable>.rc</filename>
-      file, include this file in the master
-      <filename><replaceable>somefile</replaceable>.rc</filename> file,
-      and edit the new file to translate the English text.
-      You may also need to rearrange some of the controls
-      to better fit the newly translated strings. Test your changes 
-      to make sure they properly layout on the screen.
-    </para>
-
-    <para>
-      In menus, the character '&' means that the next
-      character will be highlighted and that pressing that
-      letter will select the item. You should place these
-      '&' characters suitably for your language, not just
-      copy the positions from English. In particular,
-      items within one menu should have different highlighted
-      letters.
-    </para>
-
-    <para>
-      To get a list of the files that need translating,
-      run the following command in the root of your Wine tree:
-      <userinput>find -name "*En.rc"</userinput>.
+      Language dependent resources reside in <filename class="extension">.po</filename> files in the
+      <filename class="directory">po/</filename> directory. Simply create the language-specific
+      <filename class="extension">.po</filename> file using the <filename>wine.pot</filename>
+      template:
+      <screen>cp po/wine.pot po/<replaceable>xx</replaceable>.po</screen>
+      and <ulink url="http://wiki.winehq.org/Translating">start translating</ulink> (note the file
+      must use UTF-8 encoding).
     </para>
 
     <para>
-- 
1.8.4




More information about the wine-patches mailing list