OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

office message

[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:

    Environment: The resolution is stated for application to OpenDocument-v1.2-cd05-part2-editor-revision-02.odt
In section 1.4:Normative References, remove the [RFC3986] entry. 

Replace the last two paragraphs of section 5.8:References with the following text:

The optional Source expresses 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 optional Source is also used for locating Named Expressions (section 5.11).

The IRI portion of Source shall be an IRI reference [RFC3987] conforming to the general syntax IRI-reference rule (section 2.2 of [RFC3987]) after each pair of consecutive single-quote characters (APOSTROPHE, U+0027) is replaced by one single single-quote character. [Note: The escaping of single-quotes as paired single-quotes is because the IRI is enclosed in single quote characters of the Source.] 

Resolution of the [RFC3987] IRI reference is host-defined behavior (see section 3.4 HOST-RESOLVER). 


IRI references employ a subset of [Unicode] characters (U+0000 to U+007F) found in the ASCII character set as well as specific ranges of Unicode code points beyond U+007F (see the ucschar and iprivate syntax rules in section 2.2 of [RFC3987]). The excluded ASCII characters can only occur in IRI References via escaping in positions where IRI syntax rule pct-encoded applies. There is no means to include other excluded [Unicode] characters in an IRI.

The excluded ASCII characters include the controls, U+0000 through U+001F and U+007F. The remaining excluded ASCII characters are 
   SP SPACE, U+0020 
      " QUOTATION, U+0022 
     < LESS-THAN-MARK, U+003C 
      \ REVERSE SOLIDUS, U+005C 
      ` GRAVE ACCENT, U+0060 
       | VERTICAL LINE, U+007C 

The character "%" (PERCENT SIGN, U+0025) can only be introduced by escaping as "%25" where the rule pct-encoded applies. 

See [RFC3987] for the conditions where escaping of other ASCII characters is unnecessary and where escaping is essential to avoid confusion with the same character's special syntactic use in IRI-reference formats.


Provided specific resolution.  

The wording of the basic text preceding the Notes is streamlined and its appearance in  Named Expressions is also recognized.

The description of allowed IRI characters is simplified.

The first Note, the one about &, &amp; and &apos; is removed because this applies to all of OpenFormula when an expression is carried in an XML document.

The second Note (now the only one) is streamlined somewhat.

The list of excluded ASCII graphic characters is included as a reminder that these familiar characters are not directly allowed in either IRIs or URIs.  The limitation of % is included, since it may only be directly-used as part of the syntax of pct-encoded escapes.

For the cases where allowed characters are sometimes escaped or never require escaping, the reader is referred to [RFC3987] without further discussion.

There is nothing in the note that is not a consequence of [RFC3987].  It is included as a reminder that there are non-obvious limitations and that the full IRI syntax should be consulted for further details.

> 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
>         Environment: The resolution is stated for application to OpenDocument-v1.2-cd05-part2-editor-revision-02.odt
>            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]