documentation/languages

   1 ADDING LANGUAGES TO WINE
   2
   3 This file documents the necessary procedure for adding a new language
   4 to the list of languages that Wine can display system menus and forms
   5 in. Currently at least the following languages are still missing:
   6 Bulgarian, Chinese, Greek, Icelandic, Japanese, Romanian,
   7 Russian, Croatian, Slovak, Turkish, and Slovanian.
   8
   9 To add a new language you need to be able to translate the relatively
  10 few texts, of course.  You will need very little knowledge of
  11 programming, so you have almost no excuses for not adding your language,
  12 right?  We should easily be able to support 20 languages within a few
  13 months, get going!  Apart from re-compilation it'll take you about an
  14 hour or two.
  15
  16 To add a new language to the list of languages that Wine can handle
  17 you must...
  18
  19 0.  Find the language ID in /include/winnls.h .
  20
  21 1.  Look in ole/ole2nls.c if your language is already incorporated in
  22     the "static const struct NLS_langlocale". If not: find the
  23     appropriate entries in /include/winnls.h and add them to the list.
  24
  25 2.  Edit the parameters defined in /ole/nls/*.nls to fit your local
  26     habits and language.
  27
  28 3.  Edit documentation/wine.man (search for -language) to show the new
  29     language abbreviation.
  30
  31 4.  Edit misc/main.c variable "Languages" to contain the new language
  32     abbreviation and language ID.  Also edit macro "USAGE" to show the
  33     new abbreviation.
  34
  35 5.  Edit include/options.h enum "WINE_LANGUAGE" to have a member called
  36     LANG_XX where XX is the new abbreviation.
  37
  38 6.  Edit resources/sysres.c variable "SYSRES_Resources" to contain an
  39     entry for your language.
  40
  41 7.  Create a new file, resources/sysres_XX.rc, where XX is the
  42     abbreviation that you chose.  Your best bet is to copy sysres_En.rc
  43     and start translating.  [Warning: the author of this file does not
  44     know the details of the structure of these files.
  45     There seems to be no need to, however.]
  46
  47     In menus, the character "&" means that the next character will
  48     be highlighted and that pressing that letter will select the item.
  49     You should place these "&"s suitably for your language, not just
  50     copy the positions from (say) English.  In particular, items within
  51     one menu should have different highlighted letters.
  52
  53 8.  Edit resources/Makefile.in to add the name of the new file to the
  54     SYSRES_SRCS variable.
  55
  56 9.  Re-configure, re-make dependencies, and re-make Wine.
  57
  58 10. Check your new menus and forms; when they're not ok,
  59     go back to 7) and adapt the sizes, etc.
  60
  61 11. Edit /resources/TODO if necessary.
  62
  63 12. Submit patches for inclusion in the next Wine release,
  64     see file ./ANNOUNCE for details about where to submit.
  65
  66
  67 January 1996
  68 Morten Welinder
  69
  70 [I hope I got all the places where changes are needed.  If you see any
  71 place missing from the above list, submit a patch to this file please.
  72 Also note that re-organization of the source code might change the list
  73 of places.]
  74
  75 Therefore revised Februari 1999 by Klaas van Gend