pegasus/doc/Globalization_HOWTO.htm - diff

Return to Globalization_HOWTO.htm CVS log

Up to [Pegasus] / pegasus / doc

Diff for /pegasus/doc/Globalization_HOWTO.htm between version 1.8 and 1.10

version 1.8, 2006/08/16 19:34:35

version 1.10, 2008/05/06 21:05:22

Line 38

<td style="vertical-align: top;">Section 2.2.5.   Added information how to write platform specific messages.

</td>

</tr>

<tr>

<td style="vertical-align: top;">01/23/07

</td>

<td style="vertical-align: top;">Sushma Fernandes

</td>

<td style="vertical-align: top;">Section 2.2.5.   Added information on special considerations while creating a new message.

</td>

</tr>

</tbody>

</table>

Line 477

Line 485

details. </td>

</tr>

<tr>

<td>Boolean useICUfallback</td>

<td>Input

Optional

Default = false</td>

<td>If true, use ICU's fallback mechnism to search more general

resource bundles if the msg_id cannot be found.  Note: the

recommended setting is false if you are using an AcceptLanguageList from a

CIM client.  The Accept-Languages HTTP header from the client

contains the fallback specifications.  Using ICU's fallback in this

case may lead to returning a language that the client didn't ask for.</td>

</tr>

<tr>

<td>Formatter::Arg arg0;

Formatter::Arg arg1;

Formatter::Arg arg2;

Line 544

Line 540

MessageLoaderParms that it gets.  The MessageLoader will use the

default process locale, as determined by ICU, in this case.

Important Note:  The MessageLoader defaults to not use

Important Note:  The MessageLoader does not use

the "fallback" mechanism described in the ICU Resource Management

section.  This is because the Accept-Language header itself

describes the fallback that the client wants.  However, the

describes the fallback that the client wants.  If the

MessageLoader does "fallback" to the root resource bundle if none of the

MessageLoader cannot find a message file for any of the languages

languages in AcceptLanguageList can be found.  If the root resource

in the AcceptLanguageList, it will try the default process locale.

bundle cannot be found, then the default_msg is returned.  The

If this fails, the ICU root resource bundle will be tried.

"useICUFallback" flag can be set to have MessageLoader use ICU fallback

on all message load attempts.  However, usage of this flag for

client requests may lead to incorrect results.  For example, a

client sets Accept-Language to french, german, and spanish, in that

order, but there is no french resource bundle.  A call to

MessageLoader with useICUfallback == true would cause the root resource

bundle string to be returned on the attempt to load from the french

bundle.  But the client requested german to be the fallback after

french.

Please refer to the following files for details on the new Pegasus

classes.

Line 621

Line 608

text, it is not necessary to create a new message, but the existing one should

be updated.

Are there any special considerations while creating a new message ?

<ul>

<li>If a message definition contains text within a single quote

it is not interpreted in any way.

Example:

Server.CIMOperationRequestAuthorizer.NOT_IN_AUTHORIZED_GRP:

string {"PGS05202: User '{0}' is not authorized to access CIM data."}

Processed message:

User {0} is not authorized to access CIM data.

</li>

<li> For a single quote to appear in a processed message, it needs to be preceded by

another single quote.

Example:

Server.CIMOperationRequestAuthorizer.NOT_IN_AUTHORIZED_GRP:

string {"PGS05202: User ''{0}'' is not authorized to access CIM data."}

Processed message:

User 'wbemuser' is not authorized to access CIM data.

</li>

<li> For a double quote to appear in a processed message, it needs to be preceded by

a back slash.

Example:

ControlProviders.ProviderRegistrationProvider.ProviderRegistrationProvider.

UNSUPPORTED_USERCONTEXT_VALUE:string {"PGS03029: Unsupported UserContext

value: \"{0}\"."}

Processed message:

Unsupported UserContext value: "10".

</li>

</ul>

How do I write a platform specific

message ?

Legend:

Removed from v.1.8
changed lines
	Added in v.1.10

No CVS admin address has been configured