harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From apetre...@apache.org
Subject svn commit: r541476 - in /harmony/standard/site: docs/subcomponents/drlvm/developers_guide.html xdocs/subcomponents/drlvm/DeveloperGuide.html
Date Thu, 24 May 2007 23:23:37 GMT
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>&lt;Lang&gt;_&lt;Region&gt;.&lt;Variant&gt;</code>
locale format.
+               You can find a list of localized messages for a certain locale in the
+               <code>&lt;drlvm_trunk&gt;/vm/vmcore/src/init/harmony_&lt;locale_name&gt;.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>&lt;XXXX&gt;&lt;YYY&gt;=&lt;localized_message&gt;</b></code><br>
+              Where:</ br>
+              <ul><li><code>&lt;XXXX&gt;</code> - a set of
four letters; the current implementation contains
+              <code>&lt;ECHO&gt;</code>, <code>&lt;LDIE&gt;</code>
and <code>&lt;WARN&gt;</code> sets;</li>
+              <li><code>&lt;YYY&gt;</code> - the localized message
number, for example <code>&lt;005&gt;</code>;</li>
+              <li><code>&lt;localized_message&gt;</code> - the
message written in the native language
+              (may be UTF8 coded), which can contain some substitution parameters, 
+              for example <code>&lt;message with two parameters {0} and {1}&gt;</code>.</li>
+</ul>
+           </p>
+           <p class="example">Example</p>
+           <p class="exampletext">Here is the example of using the <code><b>&lt;ECHO030=Unknown
option {0}&gt;</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>&lt;Lang&gt;_&lt;Region&gt;.&lt;Variant&gt;</code>
locale format.
+               You can find a list of localized messages for a certain locale in the
+               <code>&lt;drlvm_trunk&gt;/vm/vmcore/src/init/harmony_&lt;locale_name&gt;.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>&lt;XXXX&gt;&lt;YYY&gt;=&lt;localized_message&gt;</b></code><br>
+              Where:</ br>
+              <ul><li><code>&lt;XXXX&gt;</code> - a set of
four letters; the current implementation contains
+              <code>&lt;ECHO&gt;</code>, <code>&lt;LDIE&gt;</code>
and <code>&lt;WARN&gt;</code> sets;</li>
+              <li><code>&lt;YYY&gt;</code> - the localized message
number, for example <code>&lt;005&gt;</code>;</li>
+              <li><code>&lt;localized_message&gt;</code> - the
message written in the native language
+              (may be UTF8 coded), which can contain some substitution parameters, 
+              for example <code>&lt;message with two parameters {0} and {1}&gt;</code>.</li>
+</ul>
+           </p>
+           <p class="example">Example</p>
+           <p class="exampletext">Here is the example of using the <code><b>&lt;ECHO030=Unknown
option {0}&gt;</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>



Mime
View raw message