-
Type:
Bug
-
Status: Applied
-
Priority:
Major
-
Resolution: Fixed
-
Affects Version/s: ODF 1.0
-
Fix Version/s: ODF 1.0 Errata CD 5
-
Component/s: Text
-
Labels:None
-
Proposal:
-
Resolution:
Submitter ID
GB-26300-107a
Nature of defect
Clarification Required
Document
ISO/IEC 26300:2006
Clause
6.3
Page
107
Description of issue
It is stated "In the OpenDocument file format, a variable must be declared at the beginning of a document".
What exactly is meant by "the beginning of a document"?
Proposal
Clarify the text.
Topic for discussion
The word "must" is here used incorrectly as prescribed by the ISO/IEC Directives. Are this and other similar usages defects that should be corrected?
In ODF 1.2, we change the sentence in question to (See OFFICE-1459):
"In an OpenDocument file, variable declarations shall precede in document order any use of those variable declarations."
But in ODF 1.1, we have a sentence like that already later in section 6.3: "Variables must be declared before they can be used.".
Further, the schema already requires that variable declarations appear before any content (that is what I believe was meant by beginning of the document).
My suggestion therefore is to either keep the sentence as is, or to remove it.
In ODF 1.2 CD05, the rule for declaration before first usage holds, but there is no statement requiring that this be at the front of the document. So the Errata item corresponding to this issue requires no transposition to ODF 1.2.
We can clarify "beginning of a document", but we must not change conformance language in errata.