<?xml version="1.0" encoding="UTF-8"?>
<sect1 id="Locales">
  <title>Locale support</title>

  <para>WinMerge allows translating the user interface to other languages than
  English. Several translations have been contributed. At the time of this
  writing, translations are available from <ulink
  url="http://www.winmerge.org/">WinMerge.org</ulink> for the following
  languages:</para>

  <itemizedlist>
    <listitem>
      <para>Portuguese (Brazilian)</para>
    </listitem>

    <listitem>
      <para>Bulgarian</para>
    </listitem>

    <listitem>
      <para>Catalan</para>
    </listitem>

    <listitem>
      <para>Chinese (both Simplified and Traditional)</para>
    </listitem>

    <listitem>
      <para>Czech</para>
    </listitem>

    <listitem>
      <para>Danish</para>
    </listitem>

    <listitem>
      <para>Dutch</para>
    </listitem>

    <listitem>
      <para>French</para>
    </listitem>

    <listitem>
      <para>German</para>
    </listitem>

    <listitem>
      <para>Hungarian</para>
    </listitem>

    <listitem>
      <para>Italian</para>
    </listitem>

    <listitem>
      <para>Japanese</para>
    </listitem>

    <listitem>
      <para>Korean</para>
    </listitem>

    <listitem>
      <para>Norwegian</para>
    </listitem>

    <listitem>
      <para>Polish</para>
    </listitem>

    <listitem>
      <para>Russian</para>
    </listitem>

    <listitem>
      <para>Slovak</para>
    </listitem>

    <listitem>
      <para>Spanish</para>
    </listitem>

    <listitem>
      <para>Swedish</para>
    </listitem>

    <listitem>
      <para>Turkish</para>
    </listitem>
  </itemizedlist>

  <note>
    <para>The translations cover interface content, including menus,
      dialogs, tooltips, and messages -- essentially the translation of
      of all strings displayed. However, they do not provide areas
      outside of string translation; they do not handle how numbers 
      are divided, or how words are alphabetized. (These issues should
      be addressed in the conventional Windows manner, which is
      via the Regional settings in the Control Panel.)
  </para></note>

  <sect2>
    <title>Selecting language</title>

    <para>In order to change the current user interface language, do the
    following:</para>

    <orderedlist>
      <listitem>
        <para>Run WinMerge</para>
      </listitem>

      <listitem>
        <para>Select <guimenuitem>Language</guimenuitem> from the
        <guimenu>View</guimenu> menu</para>
      </listitem>

      <listitem>
        <para>Select your language and click <guibutton>OK</guibutton></para>
      </listitem>
    </orderedlist>

    <para>Note that the WinMerge user interface instantly updates to the
    selected language.</para>
  </sect2>

  <sect2>
    <title>Installing translation</title>

    <para>The easiest way to install translations is to select them in the installer.
    Translations are selected in the 4th installer dialog (<guilabel>Select
    components</guilabel>). The default install (<guilabel>Typical
    Installation</guilabel>) does not install translations, but they can be
    individually selected from the list.</para>

    <para>If you don't want to re-run installer, or didn't install WinMerge
    with the installer in the first place, then WinMerge translation files are
    available in zipped versions and translation updates. To install new
    translation file:</para>

    <para><orderedlist>
        <listitem>
          <para>Download the zipped release from <ulink
          url="http://sourceforge.net/project/showfiles.php?group_id=13216&amp;package_id=11403&amp;release_id=283717">WinMerge
          download</ulink> site or updated translation file from <ulink
          url="http://sourceforge.net/project/showfiles.php?group_id=13216&amp;package_id=11403&amp;release_id=283717">Languages
          download</ulink>.</para>
        </listitem>

        <listitem>
          <para>If the <filename class="directory">Languages</filename>
          subdirectory does not exist under the WinMerge directory (where
          <filename>WinMerge.exe</filename> and/or
          <filename>WinMergeU.exe</filename> is located) create it.</para>
        </listitem>

        <listitem>
          <para>a) If you downloaded just the language files, unzip them into the
          <filename class="directory">Languages</filename> directory.</para>

          <para>b) If you downloaded an entire WinMerge release, then search for
          <filename>Merge*.lang</filename> files, where * is a language name
          (<filename>MergeSwedish.lang</filename> for Swedish translation).
          Unzip that file to the <filename>Languages</filename>
          directory.</para>
        </listitem>

        <listitem>
          <para>Run WinMerge</para>
        </listitem>

        <listitem>
          <para>Select <guimenuitem>Language</guimenuitem> from the
          <guimenu>View</guimenu> menu</para>
        </listitem>

        <listitem>
          <para>Select your language and click
          <guibutton>OK</guibutton></para>
        </listitem>
      </orderedlist></para>
  </sect2>

  <sect2>
    <title>Reporting error in translation</title>

    <para>Please submit errors you find in translations as bugs to our <ulink
    url="http://sourceforge.net/tracker/?group_id=13216&amp;atid=113216">bug-list</ulink>.
    It would be great if you can provide a corrected version of the translated text
    also.</para>
  </sect2>

  <sect2>
    <title>Submitting a new translation</title>

    <para>If you would like to add your language to the list, look at the
    <ulink url="http://www.winmerge.org/developer/l10n/index.php">on-line
    documentation</ulink> for the details on how to do it. All translations
    are not complete so it would be nice if you can help improving them too.
    Translating (or improving translation) does not require you to have all
    compile tools or knowledge of WinMerge internals. Just read instructions
    from above link. And if you have problems ask help from us in one of
    <ulink url="http://sourceforge.net/forum/?group_id=13216">WinMerge
    forums</ulink>.</para>
  </sect2>
</sect1>