You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@harmony.apache.org by ap...@apache.org on 2007/05/25 01:23:37 UTC
svn commit: r541476 - in /harmony/standard/site:
docs/subcomponents/drlvm/developers_guide.html
xdocs/subcomponents/drlvm/DeveloperGuide.html
Author: apetrenko
Date: Thu May 24 16:23:35 2007
New Revision: 541476
URL: http://svn.apache.org/viewvc?view=rev&rev=541476
Log:
Patch for HARMONY-3935 "Add info about internationalization to DevGuide"
Modified:
harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html
harmony/standard/site/xdocs/subcomponents/drlvm/DeveloperGuide.html
Modified: harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html?view=diff&rev=541476&r1=541475&r2=541476
==============================================================================
--- harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html (original)
+++ harmony/standard/site/docs/subcomponents/drlvm/developers_guide.html Thu May 24 16:23:35 2007
@@ -1729,6 +1729,32 @@
maximum use of its capabilities. See help message <code>ij
-X</code> for details on the logger command-line options.
</p>
+ <p>The current VM logging system supports internationalization,
+ so that VM can print messages in the language of the customer system.
+ To use the internationalization feature, initialize one of the <code>LC_ALL</code>,
+ <code>LC_MESSAGES</code> or <code>LANG</code> system environment variables
+ in the <code><Lang>_<Region>.<Variant></code> locale format.
+ You can find a list of localized messages for a certain locale in the
+ <code><drlvm_trunk>/vm/vmcore/src/init/harmony_<locale_name>.properties.</code>
+ message catalogue. For a convenient set of macros for printing internationalized
+ messages, refer to the <code>cxxlog.h</code> header file.
+ </p>
+ <p>A record from the message catalogue has the following structure:<br>
+ <code><b><XXXX><YYY>=<localized_message></b></code><br>
+ Where:</ br>
+ <ul><li><code><XXXX></code> - a set of four letters; the current implementation contains
+ <code><ECHO></code>, <code><LDIE></code> and <code><WARN></code> sets;</li>
+ <li><code><YYY></code> - the localized message number, for example <code><005></code>;</li>
+ <li><code><localized_message></code> - the message written in the native language
+ (may be UTF8 coded), which can contain some substitution parameters,
+ for example <code><message with two parameters {0} and {1}></code>.</li>
+</ul>
+ </p>
+ <p class="example">Example</p>
+ <p class="exampletext">Here is the example of using the <code><b><ECHO030=Unknown option {0}></b></code>
+ record from the message catalogue in VM code:</p>
+<pre>LECHO(30, "Unknown option {0}" << option);</pre>
+
</dd>
</dl>
<p class="note">
@@ -2291,8 +2317,8 @@
Note
</p>
<p class="notetext">
- The <code>vm.other_natives_dlls</code> property defines the list
- of libraries to be loaded.
+ The private <code>vm.other_natives_dlls</code> property defines
+ the list of libraries to be loaded.
</p>
</li>
<li>
Modified: harmony/standard/site/xdocs/subcomponents/drlvm/DeveloperGuide.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/xdocs/subcomponents/drlvm/DeveloperGuide.html?view=diff&rev=541476&r1=541475&r2=541476
==============================================================================
--- harmony/standard/site/xdocs/subcomponents/drlvm/DeveloperGuide.html (original)
+++ harmony/standard/site/xdocs/subcomponents/drlvm/DeveloperGuide.html Thu May 24 16:23:35 2007
@@ -1553,6 +1553,32 @@
maximum use of its capabilities. See help message <code>ij
-X</code> for details on the logger command-line options.
</p>
+ <p>The current VM logging system supports internationalization,
+ so that VM can print messages in the language of the customer system.
+ To use the internationalization feature, initialize one of the <code>LC_ALL</code>,
+ <code>LC_MESSAGES</code> or <code>LANG</code> system environment variables
+ in the <code><Lang>_<Region>.<Variant></code> locale format.
+ You can find a list of localized messages for a certain locale in the
+ <code><drlvm_trunk>/vm/vmcore/src/init/harmony_<locale_name>.properties.</code>
+ message catalogue. For a convenient set of macros for printing internationalized
+ messages, refer to the <code>cxxlog.h</code> header file.
+ </p>
+ <p>A record from the message catalogue has the following structure:<br>
+ <code><b><XXXX><YYY>=<localized_message></b></code><br>
+ Where:</ br>
+ <ul><li><code><XXXX></code> - a set of four letters; the current implementation contains
+ <code><ECHO></code>, <code><LDIE></code> and <code><WARN></code> sets;</li>
+ <li><code><YYY></code> - the localized message number, for example <code><005></code>;</li>
+ <li><code><localized_message></code> - the message written in the native language
+ (may be UTF8 coded), which can contain some substitution parameters,
+ for example <code><message with two parameters {0} and {1}></code>.</li>
+</ul>
+ </p>
+ <p class="example">Example</p>
+ <p class="exampletext">Here is the example of using the <code><b><ECHO030=Unknown option {0}></b></code>
+ record from the message catalogue in VM code:</p>
+<pre>LECHO(30, "Unknown option {0}" << option);</pre>
+
</dd>
</dl>
<p class="note">
@@ -2115,8 +2141,8 @@
Note
</p>
<p class="notetext">
- The <code>vm.other_natives_dlls</code> property defines the list
- of libraries to be loaded.
+ The private <code>vm.other_natives_dlls</code> property defines
+ the list of libraries to be loaded.
</p>
</li>
<li>