i18n improvements by Michael Koch

build.xml

@@ -170,11 +170,11 @@
     </path>
 
     <path id="project.class.path">
-		<pathelement location="${lib}"/>
+        <pathelement location="${lib}"/>
 
         <!-- Add this bundle to the global class path as we need
              the ScLogFormatter there-->
-		<pathelement location="${bundles.dest}/util.jar"/>
+        <pathelement location="${bundles.dest}/util.jar"/>
         <!-- for mac specific plugins -->
         <pathelement location="/System/Library/Java"/>
 
@@ -272,7 +272,6 @@
                 <include name="**/*.png"/>
                 <include name="**/*.PNG"/>
                 <include name="**/*.jpg"/>
-                <include name="**/*.properties"/>
                 <include name="**/*.xml"/>
                 <include name="**/*.themerc"/>
                 <include name="**/gtkrc"/>
@@ -290,6 +289,15 @@
         </copy>
     </target>
 
+    <target name="native2ascii">
+        <!-- internal target -
+             convert property file encoding from UTF-8 to ASCII,
+             save converted files in ${dest} dir -->
+        <native2ascii src="${src}" dest="${dest}" encoding="UTF-8"
+            includes="**/*.properties*" />
+
+    </target>
+
     <!-- JAVADOC -->
     <target name="javadoc"
       description="Generates project javadoc.">
@@ -306,8 +314,7 @@
 
     <!--PACKAGE-->
     <!--Copy resource files and update bundles jars. -->
-    <target name="package" depends="resource,bundles"/>
-
+    <target name="package" depends="resource,native2ascii,bundles"/>
 
     <!--MAKE-->
     <target name="make" depends="clean-bundle-repositories,compile,package"
@@ -762,6 +769,13 @@
             <!-- Setting properties necessary for dependencies on native libs.-->
             <sysproperty key="java.library.path"
                 path="${ld.library.path}:${path}:${dyld.library.path}"/>
+
+            <!-- pass l10n properties from ant call for
+                 easy translation debugging -->
+            <sysproperty key="user.language" value="${user.language}" />
+            <sysproperty key="user.country" value="${user.country}" />
+            <sysproperty key="user.variant" value="${user.variant}" />
+
             <env key="LD_LIBRARY_PATH" path="${ld.library.path}"/>
             <env key="PATH" path="${path}"/>
             <env key="DYLD_LIBRARY_PATH" path="${dyld.library.path}"/>

src/net/java/sip/communicator/impl/gui/i18n/messages.properties

@@ -1,3 +1,30 @@
+# SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
+#
+# Distributable under LGPL license.
+# See terms of license at gnu.org.
+
+# Note to translators:
+# To translate SIP Communicator to your language
+# - copy messages.properties to messages_xx.properties
+#   (where xx is the ISO 639-1 language code of your language)
+# - the file must use UTF-8 encoding
+# - all entries are of the form key=translation, where only the
+#   translation part has to be changed
+# - {0}, {1}... are parameters which will be replaced by the
+#   actual text at runtime, place them as you wish
+# - you don't have to translate all entries, if an entry is not
+#   found in your translation, the text in messages.properties will
+#   be used
+# - \ at the end of a line means that the translation is continued
+#   in the next line
+#
+# To start SIP Communicator with a language that is different
+# from your system's language, pass the language code to ant:
+# ant -Duser.language=xx run
+#
+# The same rules apply to the properties files found in the other
+# directories.
+
 about=&About
 accept=&Accept
 account=Account