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] Commented: (OFFICE-2313) Public Comment:Comments from Jacques D. on ODF Part3: Packages

    [ http://tools.oasis-open.org/issues/browse/OFFICE-2313?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=19118#action_19118 ] 

Michael Brauer commented on OFFICE-2313:

In OpenDocumemt-v1.2-part3-cd01-rev03, the clauses PD1.2.4 to PD 1.2.7 have been moved back to section 2.2. PD 1.2.8 has been removed. The constrains that alternative algorithms shall not be used by conforming packages already exists in the attribute descriptions.

All sub clauses of PD 1.3 have been moved back into section 2.3

> Public Comment: Comments from Jacques D. on ODF Part3: Packages
> ---------------------------------------------------------------
>                 Key: OFFICE-2313
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-2313
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Packaging
>    Affects Versions: ODF 1.2 Part 3 CD 1
>            Reporter: Robert Weir 
>            Assignee: Michael Brauer
>             Fix For: ODF 1.2 Part 1 CD 5
> Copied from office-comment list
> Original author: "Jacques R. Durand" <JDurand@us.fujitsu.com> 
> Original date: 13 Jan 2010 20:12:36 -0000
> Original URL: http://lists.oasis-open.org/archives/office-comment/201001/msg00007.html
> This is a copy of the comment:
> 1-Introduction:
> - I would not characterize the gray boxes as "non-normative", since they
> often re-state or re-word normative material they cross-reference.
> That could be confusing to readers.
> Instead, why not introduce them as "mark-up reminders" or "mark-up user notes"
> 2- Editorial:  Section 2.7
> Update:
> "then the relative IRI shall interpreted as a package file entry reference."
> as:
> "then the relative IRI shall be interpreted as a package file entry reference."
> 3- Editorial: Section 2.7
> Update:
> "Note: File whose relative path starts with "META-INF/ are..."
> as:
> "Note: Files the relative path of which starts with "META-INF/ are..."
> 4- Section 5: it looks like at the end of each subsection, a gray box
> should wrap up almost every last sentence.
> 5- Conformance Clause:
> - correctly identifies the Conformance targets (packages, producer, consumer)
> - unclear meaning of the labeling "PD1", "PD1.1", etc.
> - general comment: many COnf clause statements appear to just be repeats
> of what the normative specification already says, e.g:
> (PD1.1) It shall be a ZIP file, as defined by [ZIP].
> This is already made clear in Section 2.1 which says: "This package is a Zip file [ZIP]",
> (which probably should be reworded more formally as "An ODF package shall be a Zip file [ZIP]")
> Everything under PD1.2 should not need be restated in the conformance clause and should belong
> to the main spec body. Instead, the conf clause should make meta-level statements about which
> sections in the specification the "ODF package" is particularly concerned with, and must adhere to.
> (see conformance guidelines http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html).
> - the conf clause may not have much to say for "package" besides meta-level references to normative
> body, and is more useful for Producer and Consumer.
> - what is the relationship between "conforming producer" and "conforming extended producer"?
> does conformance to producer implies automatically conformance to extended producer (if yes, say so).

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]