[ 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]) except that the single-quote character, "'" (APOSTROPHE, U+0027) is expressed by two consecutive single-quote characters in the Source form of the IRI.
Resolution of Source IRIs 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].]
"""
OPTIONAL NOTE (simply emphasizing what [RFC3987 involves]:
"""
[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
^ CURCUMFLEX 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 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]) except that the single-quote character, "'" (APOSTROPHE, U+0027) is expressed by two consecutive single-quote characters in the Source form of the IRI.
Resolution of Source IRIs 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].]
"""
OPTIONAL NOTE (simply emphasizing what [RFC3987 involves]:
"""
[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
^ CURCUMFLEX 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. For treatment of non-excluded characters and when their introduction in pct-encoded form is useful, see [RFC3987].
END NOTE]
"""
Expanded the situation with reserved characters in IRI references a little.
> NEEDS-DISCUSSION: 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
