(file) Return to Globalization_HOWTO.htm CVS log (file) (dir) Up to [Pegasus] / pegasus / doc

Diff for /pegasus/doc/Globalization_HOWTO.htm between version 1.6.38.1 and 1.7

version 1.6.38.1, 2007/01/30 18:59:01 version 1.7, 2006/08/16 13:45:04
Line 31 
Line 31 
       </td>       </td>
     </tr>     </tr>
     <tr>     <tr>
       <td style="vertical-align: top;">01/23/07<br>        <td style="vertical-align: top;">08/04/06<br>
       </td>       </td>
       <td style="vertical-align: top;">Sushma Fernandes<br>        <td style="vertical-align: top;">Marek Szermutzky<br>
       </td>       </td>
       <td style="vertical-align: top;">Section 2.2.5. &nbsp; Added information on special considerations while creating a new message.<br>        <td style="vertical-align: top;">Section 2.2.5. &nbsp; Added information how to write platform specific messages.<br>
       </td>       </td>
     </tr>     </tr>
   </tbody>   </tbody>
Line 612 
Line 612 
   <li> <b>TODO </b>- find a good message writing guide to link to</li>   <li> <b>TODO </b>- find a good message writing guide to link to</li>
 </ul> </ul>
  
 <p><b>Are there any special considerations while creating a new message ? </b></p>  <p><b>When do I create a new message ?</b></p>
  
 <ul>  <p>A new message should be created if a message is needed with a content not
 <li>If a message definition contains text within a single quote  described by any existing message.</p>
 it is not interpreted in any way.  
  
 <p><i>Example:</i></p>  <p>A new message should be created if the number or placement of substitution
 <p> Server.CIMOperationRequestAuthorizer.NOT_IN_AUTHORIZED_GRP:  parameters of an existing message would require an update.</p>
     string {"PGS05202: User '{0}' is not authorized to access CIM data."}  
 </p>  <p>It is not necessary to create a new message if just the text of the message
   is changed, while the meaning is kept. For instance if the
   event(error,warning,whatever) is described more precisely by the new message
   text, it is not necessary to create a new message, but the existing one should
   be updated.</p>
  
 <p><i>Processed message:</i></p>  <p><b>How do I write a platform specific
 <p>  User {0} is not authorized to access CIM data.  </p>  message ? </b></p>
 </li>  
  
 <li> For a single quote to appear in a processed message, it needs to be preceded by  <p>Platform specific messages generate in a non-platform specific source file
 another single quote.  should be formatted with a .&lt;platform&gt; or .STANDARD suffix.</p>
  
 <p><i>Example:</i></p> <p><i>Example:</i></p>
 <p> Server.CIMOperationRequestAuthorizer.NOT_IN_AUTHORIZED_GRP:  <p>Compiler.cmdline.cimmof.cmdline.MENU.PEGASUS_OS_HPUX</p>
     string {"PGS05202: User ''{0}'' is not authorized to access CIM data."}  <p>Compiler.cmdline.cimmof.cmdline.MENU.PEGASUS_OS_OS40</p>
 </p>  <p>Compiler.cmdline.cimmof.cmdline.MENU.STANDARD</p>
  
 <p><i>Processed message:</i></p>  <p>&nbsp;</p>
 <p>  User 'wbemuser' is not authorized to access CIM data.  </p>  
 </li>  
  
 <li> For a double quote to appear in a processed message, it needs to be preceded by  <p><b>Where should I place platform specific
 a back slash.  messages ? </b></p>
  
 <p><i>Example:</i></p>  <p>As described in the message bundle file pegasusServer_en.txt messages belong
 <p>  into the section corresponding the file they are created in. This does account
 ControlProviders.ProviderRegistrationProvider.ProviderRegistrationProvider.  the same to platform specific messages.</p>
 UNSUPPORTED_USERCONTEXT_VALUE:string {"PGS03029: Unsupported UserContext  <p>If a message is generated inside a source file not specific to a single
 value: \"{0}\"."}  platform, the message should be part of the message bundle section of that
 </p>  source file.</p>
   <p>If a new platform specific message is generated inside a platform specific
   source file, the message belongs to the platform specific section of the
   message bundle file.</p>
  
 <p><i>Processed message:</i></p>  <p><i>Examples:</i></p>
 <p>  Unsupported UserContext value: "10".  </p>  
 </li>  <p>ProviderManager.ProviderAgent.ProviderAgent.UNINITIALIZED_SECURITY_SETUP.PEGASUS_OS_ZOS
 </ul>  - this message is and should be part of the section for the ProviderAgent as it
   is generated inside the provider agent and not a z/OS platform specific file</p>
   <p>Common.safCheckzOS_inline.BAD_WBEM_SECURITY_SETUP - this message does and
   should reside inside the platform specific section as the message is generated
   in a z/OS platform only file</p>
  
 <p>&nbsp;</p> <p>&nbsp;</p>
  
 <h4> 2.2.6 Localized Exceptions</h4>  <h4> 2.2.5 Localized Exceptions</h4>
 <p><br> <p><br>
 The base Exception class, and derived classes, have been updated to The base Exception class, and derived classes, have been updated to
 support localization.&nbsp; Constructors have been added that take a support localization.&nbsp; Constructors have been added that take a
Line 1229 
Line 1236 
 &nbsp; </p> &nbsp; </p>
 <p> </p> <p> </p>
 <hr> <hr>
 <p><i>Copyright (c) 2003 BMC Software; Hewlett-Packard Development  <p><i>
 Company, L.P.; IBM Corp.; The Open Group</i> </p>  Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
 <p><i>Permission is hereby granted, free of charge, to any person  Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
 obtaining a copy&nbsp; of this software and associated documentation  Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
 files (the "Software"), to deal in the Software without restriction,  IBM Corp.; EMC Corporation, The Open Group.
 including without limitation the rights to use, copy, modify, merge,  Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
 publish, distribute, sublicense, and/or sell copies of the Software, and  IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
 to permit persons to whom the Software is furnished to do so, subject  Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 to the following conditions:</i> </p>  EMC Corporation; VERITAS Software Corporation; The Open Group.
 <p><i>THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE  Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 INCLUDED IN ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE  EMC Corporation; Symantec Corporation; The Open Group.
 SOFTWARE IS PROVIDED&nbsp; "AS IS", WITHOUT WARRANTY OF ANY KIND,  </i> </p>
 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF  
 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  <p><i>
 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY  Permission is hereby granted, free of charge, to any person obtaining a copy
 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,  of this software and associated documentation files (the "Software"), to
 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE  deal in the Software without restriction, including without limitation the
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</i> <br>  rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 &nbsp; <br>  sell copies of the Software, and to permit persons to whom the Software is
 &nbsp; </p>  furnished to do so, subject to the following conditions:
   </i> </p>
   
   <p><i>
   THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
   ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
   "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
   LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
   PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
   HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
   ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
   </i> <br>
   <br>
   </p>
 </body> </body>
 </html> </html>


Legend:
Removed from v.1.6.38.1  
changed lines
  Added in v.1.7

No CVS admin address has been configured
Powered by
ViewCVS 0.9.2