Frédéric Delanoy : winedev: Update " Adding New Languages" section.

[Alexandre Julliard]

Module: docs
Branch: master
Commit: 616a0bf86fe91e992bda11193de9cec3a4d5cceb
URL:    http://source.winehq.org/git/docs.git/?a=commit;h=616a0bf86fe91e992bda11193d...

Author: Frédéric Delanoy <frederic.delanoy(a)gmail.com>
Date:   Mon Sep  9 17:51:01 2013 +0200

winedev: Update "Adding New Languages" section.

---

 en/winedev-coding.sgml |   49 +++++++++++++----------------------------------
 1 files 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>