Skip to main content

[JIRA] Issue Comment Edited: (PORTLETSPEC3-6) Errata: Clarification for section "PLT.25.8.2 Locales supported by the Portlet"

  • From: "msnicklous (JIRA)" < >
  • To:
  • Subject: [JIRA] Issue Comment Edited: (PORTLETSPEC3-6) Errata: Clarification for section "PLT.25.8.2 Locales supported by the Portlet"
  • Date: Tue, 30 Jul 2013 09:35:34 +0000 (UTC)
  • Auto-submitted: auto-generated


    [ 
https://java.net/jira/browse/PORTLETSPEC3-6?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=366936#action_366936
 ] 

msnicklous edited comment on PORTLETSPEC3-6 at 7/30/13 9:35 AM:
----------------------------------------------------------------

In light of the the new Locale support in Java 7, it seems that we should 
move in that direction also. A description similar to the following might be 
appropriate:

{panel}
The supported locales declared in the deployment descriptor must be specified 
as a valid language tag according to IETF BCP 47, "Tags for Identifying 
Languages".  A valid language tag is composed of subtags separated by hyphens 
("-", ABNF [RFC4234] %x2D) as delimiters. The language tag must begin with 
the primary language subtag and may be followed by subsequent optional 
subtags. If specified, the subtags must appear in the order shown below. 

* language - ISO 639 alpha-2 or alpha-3 language code, or registered language 
subtags up to 8 alpha letters (for future enhancements).
* script - ISO 15924 alpha-4 script code. You can find a full list of valid 
script codes in the IANA Language Subtag Registry (search for "Type: script").
* country (region) - ISO 3166 alpha-2 country code or UN M.49 numeric-3 area 
code. You can find a full list of valid country and region codes in the IANA 
Language Subtag Registry (search for "Type: region").
* variant - Any arbitrary value used to indicate a variation of a Locale.
* extensions - A map from single character keys to string values, indicating 
extensions apart from language identification. The extensions in Locale 
implement the semantics and syntax of BCP 47 extension subtags and private 
use subtags.

A valid language tag example would be "ja-JP-SJIS". This tag contains "ja" as 
the mandatory primary language tag, followed by the "JP" country and the 
"SJIS" variant subtags.  The optional script and extensions subtags are not 
specified.

See IETF BCP 47, "Tags for Identifying Languages" for a complete description. 
See the descriptions of the Java SE 7 Locale, Locale.Builder, and 
ResourceBundle classes for additional information on how Java processes IETF 
BCP 47 language tag information.

To allow for backward compatibility, an underscore character ("_", ABNF 
[RFC4234] %x5F) is allowed as delimiter character between subtags instead of 
a hyphen.
{panel}

      was (Author: msnicklous):
    In light of the the new Locale support in Java 7, it seems that we should 
move in that direction also. A description similar to the following might be 
appropriate:

{panel}
The supported locales declared in the deployment descriptor must be specified 
as a valid language tag according to IETF BCP 47, "Tags for Identifying 
Languages".  A valid language tag is composed of subtags separated by hyphens 
("-", ABNF [RFC4234] %x2D) as delimiters. The language tag must begin with 
the primary language subtag and may be followed by subsequent optional 
subtags. The subtags must appear in the order shown below. 

* language - ISO 639 alpha-2 or alpha-3 language code, or registered language 
subtags up to 8 alpha letters (for future enhancements).
* script - ISO 15924 alpha-4 script code. You can find a full list of valid 
script codes in the IANA Language Subtag Registry (search for "Type: script").
* country (region) - ISO 3166 alpha-2 country code or UN M.49 numeric-3 area 
code. You can find a full list of valid country and region codes in the IANA 
Language Subtag Registry (search for "Type: region").
* variant - Any arbitrary value used to indicate a variation of a Locale.
* extensions - A map from single character keys to string values, indicating 
extensions apart from language identification. The extensions in Locale 
implement the semantics and syntax of BCP 47 extension subtags and private 
use subtags.

A valid language tag example would be "ja-JP-SJIS". This tag contains "ja" as 
the mandatory primary language tag, followed by the "JP" country and the 
"SJIS" variant subtags.  The optional script and extensions subtags are not 
specified.

See IETF BCP 47, "Tags for Identifying Languages" for a complete description. 
See the descriptions of the Java SE 7 Locale, Locale.Builder, and 
ResourceBundle classes for additional information on how Java processes IETF 
BCP 47 language tag information.

To allow for backward compatibility, an underscore character ("_", ABNF 
[RFC4234] %x5F) is allowed as delimiter character between subtags instead of 
a hyphen.
{panel}
  
> Errata: Clarification for section "PLT.25.8.2 Locales supported by the 
> Portlet"
> -------------------------------------------------------------------------------
>
>                 Key: PORTLETSPEC3-6
>                 URL: https://java.net/jira/browse/PORTLETSPEC3-6
>             Project: portletspec3
>          Issue Type: Improvement
>          Components: JSR 286 Portlet Specification Errata
>            Reporter: msnicklous
>            Assignee: msnicklous
>            Priority: Minor
>
> Referring to the working document "JavaTM Portlet Specification, working 
> document 3 (22.04.13)",
> there is a mistake under section PLT.25.8.2 at line 15. RFC 1766 specifies 
> the locale format 
> as a language tag that is composed of subtags separated by hyphens, rather 
> than underscore 
> characters. The text should be corrected as follows:
> Original:
> -------------------------
> The supported locales declared in the deployment descriptor should follow 
> the
> lang_COUNTRY_variant format as defined by RFC 1766
> (http://www.faqs.org/rfcs/rfc1766.html).
> -------------------------
> Corrected:
> -------------------------
> The supported locales declared in the deployment descriptor should follow 
> the
> lang-COUNTRY-variant format as defined by RFC 1766
> (http://www.faqs.org/rfcs/rfc1766.html).
> -------------------------

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
https://java.net/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[JIRA] Issue Comment Edited: (PORTLETSPEC3-6) Errata: Clarification for section "PLT.25.8.2 Locales supported by the Portlet"

msnicklous (JIRA) 07/30/2013
 
 
Close
loading
Please Confirm
Close