[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Updated: (OFFICE-3432) ODF 1.2 Part 2 MustUse "IRI" and "IRI-Reference" Consistently
[ http://tools.oasis-open.org/issues/browse/OFFICE-3432?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dennis Hamilton updated OFFICE-3432:
------------------------------------
Proposal:
Handle (2-3) with separate JIRA issues.
For (1), make the following adjustments:
In section 1.4:Normative References, remove the [RFC3986] entry.
Remove the last two paragraphs of section 5.8:References
Add the following text at the end of section 5.8:References
"""
The optional Source specifies that the reference is to sheets and/or cells in a different location (possibly in a same-document fragment) than that for the formula in which the reference occurs. The Source IRI shall be an IRI reference [RFC3987] conforming to the general syntax IRI-reference rule (section 2.2 of [RFC3987]) after each occurrence of paired single-quote characters (APOSTROPHE, U+0027) in the Source is unescaped to a single unescaped (not %-encoded) single-quote character in the IRI reference. [Note: The escaping of single-quotes as paired single-quotes in the Source is because the Source is delimited by solitary single-quote characters in the Reference.]
Resolution of the IRIs of Sources to absolute IRIs, acceptable IRI schemes, and additional scheme- and application-specific constraints are host-defined behaviors (see section 3.4 HOST-RESOLVER).
[NOTE: Except where the Reference is expressed in a CDATA section, any direct occurrence of "&" (AMPERSAND, U+0026) in the IRI reference can be introduced by use of a character entity or the pre-defined general entity "&" [XML1.0]. When the full Reference is expressed in an XML attribute where the AttValue form has surrounding single-quote characters, all occurrences of the single-quote "'" (APOSTROPHE, U+0027) in the Reference, including the doubled occurrences, can be introduced by character entity or the pre-defined general entity "'" [XML1.0].]
[BEGIN NOTE:
IRI references allow use of specific ranges of Unicode code points beyond U+007F (see the uschar and iprivate syntax rules in section 2.2 of [RFC3987]). The IRI syntax allows only a subset of code points corresponding to ASCII characters in the range U+0000 through U+007F. The excluded ASCII characters can only occur in IRI References via escaping in positions where IRI syntax rule pct-encoded applies. The excluded characters include the controls, U+0000 through U+001F and U+007F. The remaining excluded characters are
SP SPACE, U+0020
" QUOTATION, U+0022
< LESS-THAN-MARK, U+003C
> GREATER-THAN-MARK, U+003E
\ REVERSE SOLIDUS, U+005C
^ CIRCUMFLEX ACCENT, U+005E
` GRAVE ACCENT, U+0060
{ LEFT CURLY BRACKET, U+007B
| VERTICAL LINE, U+007C
} RIGHT CURLY BRACKET, U+007D
The character "%" (PERCENT SIGN, U+0025) can only be introduced as other than the first character from the pct-encoded rule by escaping as "%25" where the rule pct-encoded applies. Those non-excluded ASCII characters that have no reserved purpose in [RFC3987] do not benefit from escaping. See [RFC3987] for the conditions where escaping of the individual reserved ASCII characters is important.
END NOTE]
"""
was:
Handle (2-3) with separate JIRA issues.
For (1), make the following adjustments:
In section 1.4:Normative References, remove the [RFC3986] entry.
Remove the last two paragraphs of section 5.8:References
Add the following text at the end of section 5.8:References
"""
The optional Source specifies that the reference is to sheets and/or cells in a different location (possibly in a same-document fragment) than that for the formula in which the reference occurs. The Source IRI shall be an IRI reference [RFC3987] conforming to the general syntax IRI-reference rule (section 2.2 of [RFC3987]) after each occurrence of paired single-quote characters (APOSTROPHE, U+0027) in the Source is unescaped to a single unescaped single-quote character in the IRI reference. [Note: The escaping of single-quotes as paired single-quotes in the Source is because the Source is delimited by solitary single-quote characters in the Reference.]
Resolution of the IRIs of Sources to absolute IRIs, acceptable IRI schemes, and additional scheme- and application-specific constraints are host-defined behaviors (see section 3.4 HOST-RESOLVER).
[NOTE: Except where the Reference is expressed in a CDATA section, any direct occurrence of "&" (AMPERSAND, U+0026) in the IRI reference can be introduced by use of a character entity or the pre-defined general entity "&" [XML1.0]. When the full Reference is expressed in an XML attribute where the AttValue form has surrounding single-quote characters, all occurrences of the single-quote "'" (APOSTROPHE, U+0027) in the Reference, including the doubled occurrences, can be introduced by character entity or the pre-defined general entity "'" [XML1.0].]
[BEGIN NOTE:
IRI references allow use of specific ranges of Unicode code points beyond U+007F (see the uschar and iprivate syntax rules in section 2.2 of [RFC3987]). The IRI syntax allows only a subset of code points corresponding to ASCII characters in the range U+0000 through U+007F. The excluded ASCII characters can only occur in IRI References via escaping in positions where IRI syntax rule pct-encoded applies. The excluded characters include the controls, U+0000 through U+001F and U+007F. The remaining excluded characters are
SP SPACE, U+0020
" QUOTATION, U+0022
< LESS-THAN-MARK, U+003C
> GREATER-THAN-MARK, U+003E
\ REVERSE SOLIDUS, U+005C
^ CIRCUMFLEX ACCENT, U+005E
` GRAVE ACCENT, U+0060
{ LEFT CURLY BRACKET, U+007B
| VERTICAL LINE, U+007C
} RIGHT CURLY BRACKET, U+007D
The character "%" (PERCENT SIGN, U+0025) can only be introduced as other than the first character from the pct-encoded rule by escaping as "%25" where the rule pct-encoded applies. Those non-excluded ASCII characters that have no reserved purpose in [RFC3987] do not benefit from escaping. See [RFC3987] for the conditions where escaping of the individual reserved ASCII characters is important.
END NOTE]
"""
Component/s: (was: Needs Discussion)
The double use of unescaped in the sentence of the first text paragraph is clarified that one escaping is a paired APOSTROPHE into a single unescaped (in the IRI sense) APOSTROPHE in the IRI.
> ODF 1.2 Part 2 Must Use "IRI" and "IRI-Reference" Consistently
> --------------------------------------------------------------
>
> Key: OFFICE-3432
> URL: http://tools.oasis-open.org/issues/browse/OFFICE-3432
> Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
> Issue Type: Sub-task
> Components: OpenFormula, Part 2 (Formulas)
> Affects Versions: ODF 1.2 CD 05
> Reporter: Dennis Hamilton
> Assignee: Dennis Hamilton
> Fix For: ODF 1.2 CD 06
>
>
> 1. In ODF 1.2 CD05 Part 2, 5.8 References, there is mention of IRI, along with some recommendations that are imprecisely stated concerning absolute IRIs, relative IRIs, the use of "./", and other matters that are imprecise. The rules for IRI references in [RFC3987] are sufficient. Notes might be useful in pointing to limitations that apply to IRIs in terms of excluded characters and in dealing with single-quote and "&" occurrences that may be part of the IRI itself.
> 2. In ODF 1.2 CD05 Part 2 there is also mention of IRI as a text operand to the HYPERLINK function (sectin 6.11.3). The relationship of that use of IRI needs to be clarified.
> 3. There may be similar clarification required in treatment of IRI in the context of the FILENAME Info_Type in the CELL function (section 6.13.3).
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]