-
Type:
Bug
-
Status: Applied
-
Priority:
Major
-
Resolution: Fixed
-
Affects Version/s: ODF 1.2 Part 3 CD 1
-
Fix Version/s: ODF 1.2 Part 3 CD 2
-
Component/s: Packaging
-
Labels:None
-
Environment:
This issue applies to the Public Review form of ODF 1.2 Part 3 cd01 all formats (files OpenDocument-v1.2-part3-cd01.odt, etc.) and to the corresponding schema (file OpenDocument-manifest-schema-v1.2-cd1.rng)
-
Proposal:
-
Resolution:
Section 3.8.14 manifest:version describes an optional attribute for the <manifest:file-entry> element.
The naming of this attribute invites confusion with a possible version of the manifest XML file. [I attest that I was laboring under exactly that confusion. -- orcmid]
Taking manifest:version as described and as specified in the schema, however, the following questions arise:
1. There is no normative language of any sort associated with this element. There is also no statement concerning this element in the conformance clauses of the Part 3 specification.
2. There is no stipulation on how this value is obtained other than it has a relationship to the MIME type specified in the required manifest:media-type entry of the <manifest:file-entry> element.
3. There is no stipulation on consistency between this value and however version is determinable for the (sub-)document or file identified in the required manifest:full-path attribute.
4. There is no stipulation on when this attribute shall/should be present or if it is always optional, regardless of any multiple versions of a format that might be associated with the same MIME type.
5. There is no indication of any obligations of a package producer to provide this attribute value, or when it is expected that it can be provided.
6. There is no indication of what behavior a package consumer might or might not associate with the presence/absence of this attribute.
Basically, it is not clear what useful purpose is served by this attribute and what convention achieves that purpose.
It also seems that this is too intertwined with knowledge of what all the documents and subdocuments are and what that means with respect to the specific version of a document format that is being carried in an ODF 1.2 package. Maybe such constraints with regard to versions of subdocuments and other constituent files are a matter for ODF 1.2 Part 1 where it is possible to say something meaningful in the case of that specific format.