RE: [office] ODF 1.2 Version Significance Proposal - COMPLETE UPDATE

["Dennis E. Hamilton" <dennis.hamilton@acm.org>]

The proposal itself, as updated, is at 
http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance 

-----Original Message-----
From: Dennis E. Hamilton [mailto:dennis.hamilton@acm.org] 
Sent: Saturday, January 10, 2009 15:25
To: 'ODF TC List'
Cc: 'Rob Weir'; 'Michael Brauer'
Subject: RE: [office] ODF 1.2 Version Significance Proposal - COMPLETE UPDATE

This is a complete replacement draft for the January 4 version of the ODF 1.2 Version Significance Proposal.  

This draft contains, below, a complete, lightly-edited version that reflects the review by Michael Brauer on January 6:
<http://lists.oasis-open.org/archives/office/200901/msg00041.html>.

The discussion of Michael's individual points and proposed replacements to the text are discussed in five Update notes:

Update #1 on the beginning of the proposed text is at 
<http://lists.oasis-open.org/archives/office/200901/msg00076.html>.

Update #2 on when ODF 1.2 documents are also compatible with earlier specifications is at 
<http://lists.oasis-open.org/archives/office/200901/msg00077.html>.

Update #3 on deleting a paragraph no longer needed after Update #2 is at 
<http://lists.oasis-open.org/archives/office/200901/msg00078.html>.

Update #4 on when some or all of the parts have office:version different than "1.2"
http://lists.oasis-open.org/archives/office/200901/msg00079.html

Update #5 guidance on processing of non-ODF 1.2 documents as ODF 1.2 by an ODF 1.2 implementation
http://lists.oasis-open.org/archives/office/200901/msg00080.html


The following wikiText is the complete revised wording of the proposed text.  This text will not be changed until there is discussion and/or approval that requires any change.

[January 10 complete text (in wikiText format)[
=== 18.588 The office:version attribute ===
The office:version attribute identifies the version of ODF specification that defines the associated element, its schema, its complete content, and its interpretation.

The office:version attribute '''shall''' be present in each and every <office:document>, <office:content>, <office:document-styles>, <office:document-meta>, and <office:document-settings> element in the XML documents that comprise an ODF 1.2 document. The value of the office:version attribute '''shall''' be "1.2".

'''Note:''' Notwithstanding the occurrences of office:version="1.2", an ODF 1.2 document that relies solely on features of a previous ODF specification that are upward-compatible into ODF 1.2 can also be interpreted correctly under that earlier specification by taking the office:version attribute as everywhere omitted or as identifying that earlier version instead. See also Appendix H, Changes From Previous Specification Versions (Non-Normative).

'''Note:''' When an office:version-requiring element has office:version="1.1" the element and its content are based on the OpenDocument v1.1 specification [ODF11].  For office:version="1.0" the element and its content are based on the OpenDocument v1.0 specification [ODF10].  When an office:version-requiring element has office:version omitted, the element is based on a version of the OpenDocument specification earlier than ODF 1.2.  When an office:version-requiring element has an office:version attribute with value other than one of "1.0", "1.1", and "1.2", the element and its content are based on an OpenDocument specification later than ODF 1.2.  In none of these cases do the elements comprise an ODF 1.2 document.

In any case where an apparent ODF document does not provide the office:version attributes and values required for ODF 1.2 documents, an ODF 1.2 implementation '''may''' process the document as if it is an ODF 1.2 document:
   * In doing so, the implementation '''should''' behave as if the requisite office:version="1.2" attributes are present. 
   * Any elements and attributes based on earlier versions of ODF for which the same-named ODF 1.2 features are incompatible '''need not''' be accepted.  If accepted, an ODF 1.2-incompatible feature '''should''' be cast into an equivalent but ODF 1.2-compatible form.    See Appendix H, Changes From Previous Specification Versions (Non-Normative), as well as previous specifications and any approved errata for them.
   * Any elements and attributes that are neither recognized, accepted, nor supported by the implementation, even though identified in XML namespaces defined for use in ODF 1.2 documents, '''should''' be treated in accordance with the rules for foreign elements and attributes (section 1.4). 
   * Subsequent processing '''should''' be as if the accepted document were exactly the ODF 1.2 document derived in this way. 

[''Note to Editor:'' These section numbers and (corrected) Appendix letters correspond to those of OpenDocument-v1.2-draft7-13.odt and may need to be reviewed and adjusted to apply to subsequent drafts.]
== Schema changes/additions: ==
The current schema has office:version="1.2" be an office-document-common-attrs non-optional attribute with required value. This proposal makes no change to the schema.
]]
 
 - Dennis

-----Original Message-----
From: Dennis E. Hamilton [mailto:dennis.hamilton@acm.org] 
http://lists.oasis-open.org/archives/office/200901/msg00011.html
Sent: Sunday, January 04, 2009 16:25
To: 'ODF TC List'
Cc: Rob Weir; Michael Brauer
Subject: RE: [office] ODF 1.2 Version Significance Proposal

[ ... ]

I do not propose to deal with "manifest:version" here.  We can look at that, if necessary, as part of reviewing Part 3 of the ODF 1.2 specification.  

PROPOSED TEXT

== Requested changes to the ODF Standard ==

{{{ This version of the proposal does not address the manifest:version attribute.  This should be dealt with separately. }}}

Replace the text in section 18.588 of OpenDocument-v1.2-draft7-13.odt with the following text:

=== 18.588 The office:version attribute ===

The office:version attribute is required for each and every <office:document>, <office:content>, <office:document-styles>, <office:document-meta>, and <office:document-settings> element in the XML documents that comprise an ODF 1.2 document.  The value of the attribute must be "1.2" in those occurrences.

An ODF 1.2 document, notwithstanding occurrences of office:version="1.2", CAN also be acceptable as a document of a previous ODF version when only ODF 1.2-compatible features of the earlier version are relied upon for the ODF 1.2 document.  The treatment of such documents by processors designed to implement earlier versions of ODF is implementation-specific and is not subject to ODF 1.2 conformance requirements.

When an office:version-requiring element has office:version="1.1" the element and its content are based on the OpenDocument v1.1 specification [ODF11].  For office:version="1.0" the element and its content are based on the OpenDocument v1.0 specification [ODF10].  When an office:version-requiring element has office:version omitted, the element is based on a version of the OpenDocument specification earlier than ODF 1.2.  Any treatment of these cases in accordance with the earlier ODF specifications by an implementation that supports ODF 1.2 is implementation-specific.

When an office:version-requiring element has an office:version attribute with value other than one of "1.0", "1.1", and "1.2", the element and its content are based on an OpenDocument specification later than ODF 1.2.  Any treatment in accordance with such specifications by an implementation that supports ODF 1.2 is implementation-specific.

In any case where an apparent ODF document is not specifically an ODF 1.2 document based on the required occurrences of office:version attributes, an ODF 1.2 implementation MAY process the document as if it is an ODF 1.2 document:
  * In doing so, the implementation SHOULD behave as if the requisite office:version="1.2" attributes are present. 
  * Any elements and attributes based on earlier versions of ODF that are incompatible with the corresponding ODF 1.2 features NEED NOT be accepted.  If the incompatible form is accepted, it SHALL be accepted as if cast into an equivalent but ODF 1.2-compatible substitute form.
  * Any elements and attributes that are not defined for ODF 1.2, even though occurring in XML namespaces defined for use in ODF 1.2 documents, SHOULD be treated in accordance with the rules for foreign elements and attributes. 

== Schema changes/additions: ==

The current schema has office:version="1.2" be an office-document-common-attrs non-optional attribute with required value.  This proposal makes no change to the schema.


[ ... ]


---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php