Fix editorial inconsistencies in the specification

["Schnabel, Bryan S" <bryan.s.schnabel@tektronix.com>]

Tom has cataloged a list of inconsistent language used in various spots in the spec. I have added issue 241 and assigned it to Tom. Since these are all editorial fixes, I propose that the proposed fixes are approved. If nobody expresses dissent by Monday, noon, PDT, I will assume these to be approved by the TC.

 

Thanks,

 

Bryan

 

1. Tables of attribute values use "Values" as the table heading.

                5.1.6.9 type    "Standard Values"

                5.3.5.1 fs      "fs attribute values"

 

2. For context-specific default values, six entries use "default values for this attribute depend on the element in which it is used:".

                4.3.1.4 canOverlap - uses 'value' and 'depends'

                4.3.1.28 srcDir - extra comma

 

3. The value description for most text attributes use "Text".

                4.3.1.23 name    "Text string".

 

4. Most content models for empty elements use "This element is always empty."

                5.7.4.3 normalization   "- empty element"

 

For all of the above, I propose changing the exceptions to use the most commonly used terminology.

 

5. Elements from other namespaces are expressed in various ways:

                "- elements from any namespace, optional"

                                5.7.4.2 profiles

                                5.7.4.4 data

                "- XML elements from any namespace"

                                4.2.2.3 skeleton

                                5.5.4.5 source

                                5.5.4.6 target

                "- Zero, one or more elements from other namespaces."

                                4.2.2.2 file

                                4.2.2.4 group

                                4.2.2.5 unit

                                5.1.5.3 match

                "Zero, one, or more elements from any namespace."

                                5.2.4.3 glossEntry

 

I propose that all of these be changed to "elements from other namespaces, optional". The rationale is that (a) 'XML' is implicit, (b) 'other' rather than 'any' is consistent with a previous change made to the schema, using '##other', and (c) "zero, one or more" is the same as "optional".

 

6. Content models that include 'text' express it in various ways.

                "- Plain text."

                                5.2.4.4 term

                                5.2.4.5 translation

                                5.2.4.6 definition

                "- Text"

                                4.2.2.12 source

                                4.2.2.13 target

                                4.2.2.9 note

                                4.2.3.3 pc

                                4.2.3.6 mrk

                                5.6.4.5 item

                "- Non-translatable text"

                                4.2.2.3 skeleton

                                4.2.2.11 data

                                5.4.4.4 meta

 

I propose that all of these be changed to "Text". I have no objection to retaining "Non-translatable" but it should be part of the accompanying description.