mir/libreoffice
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

documented BCP 47 semantics

Browse Source 
Change-Id: Ia2fad8e79833a66bb3e95047fc5885880d6da17c
This commit is contained in:
Eike Rathke
2013-11-21 14:14:43 +01:00
parent deb249e1b3
commit e3f30efe9f
1 changed files with 32 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
udkapi/com/sun/star/lang/Locale.idl
View File

@@ -51,27 +51,34 @@ module com { module sun { module star { module lang {
*/ */
published struct Locale published struct Locale
{ {
/** specifies an <strong>ISO Language Code</strong>. /** specifies an <strong>ISO 639 Language Code</strong>.
<p>These codes are the lower-case two-letter codes as defined by <p>These codes are preferably the lower-case two-letter codes as
ISO-639. You can find a full list of these codes at a number of defined by ISO 639-1, or three-letter codes as defined by ISO
639-3. You can find a full list of these codes at a number of
sites, such as: <br/> sites, such as: <br/>
<a href="http://www.chemie.fu-berlin.de/diverse/doc/ISO_639.html"> <a href="http://sil.org/iso639-3/codes.asp">
<code>http://www.chemie.fu-berlin.de/diverse/doc/ISO_639.html</code></a>. <code>http://sil.org/iso639-3/codes.asp</code></a>.
</p> </p>
<p>If this field contains an empty string, the meaning depends on the <p>If this field contains an empty string, the meaning depends on the
context.</p> context.</p>
<p>Since LibreOffice 4.2, if the locale can not be represented
using only ISO 639 and ISO 3166 codes this field contains the
ISO 639-3 reserved for local use code "<strong>qlt</strong>" and
a <strong>BCP 47</strong> language tag is present in the Variant
field. </p>
*/ */
string Language; string Language;
/** specifies an <strong>ISO Country Code</strong>. /** specifies an <strong>ISO 3166 Country Code</strong>.
<p>These codes are the upper-case two-letter codes as <p>These codes are the upper-case two-letter codes as
defined by ISO-3166. You can find a full list of these codes at a defined by ISO 3166-1. You can find a full list of these codes
number of sites, such as: <br/> at a number of sites, such as: <br/>
<a href="http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html"> <a href="http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm">
<code>http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html</code></a>. <code>http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm</code></a>.
</p> </p>
<p>If this field contains an empty string, the meaning depends on the <p>If this field contains an empty string, the meaning depends on the
@@ -79,14 +86,22 @@ published struct Locale
*/ */
string Country; string Country;
/** contains a variant of the locale; codes are vendor and /** specifies a <strong>BCP 47</strong> Language Tag.
browser-specific.
<p>For example, use WIN for Windows, MAC for Macintosh, and POSIX <p>Since LibreOffice 4.2, <strong>if</strong> the Language field
for POSIX. Wherever there are two variants, separate them with an is the code "<strong>qlt</strong>" this field contains the full
underscore, and put the most important one first. For example, a BCP 47 language tag. If the Language field is not "qlt" this
traditional Spanish collation might construct a locale with parameters field is empty. </p>
for language, country and variant as: "es", "ES", "Traditional_WIN".</p>
<p>You can find BCP 47 language tag resources at <br/>
<a href="http://www.langtag.net/">
<code>http://www.langtag.net/</code></a>. </p>
<p>Earlier versions of the documentation mentioned "vendor and
browser-specific" codes but that was never supported. Use of any
arbitrary strings in the Variant field that do not form a valid
BCP 47 language tag is <strong>strongly deprecated</strong>.
</p>
*/ */
string Variant; string Variant;