diff --git a/Documents/pureODD/howtoChain.xml b/Documents/pureODD/howtoChain.xml index c4f2bb0423..fb81c2c5f4 100644 --- a/Documents/pureODD/howtoChain.xml +++ b/Documents/pureODD/howtoChain.xml @@ -59,14 +59,14 @@ in the current source tree. And one with the value http://example.com/superODDs/anotherSubset.xml will go looking for it at the URL indicated.

-

It's important to understand that the resource indicated by the sources +

It's important to understand that the resource indicated by the source attribute must contain complete and explicit specification elements: elementSpec rather than elementRef, classSpec rather than classRef and so on. It may of course contain other TEI elements, but these will be ignored entirely in the construction of a schema. A file called p5subset.xml, provided as part of every TEI release, is an example of such a resource: it contains specifications for every - single TEI element, class, macro, and datatype, but nothing else much. If the - source parameter is not supplied, the most recently available version of this + single TEI element, class, macro, and datatype, but nothing else much. If a value for the + source attribute is not specified, the most recently available version of this file is what will be used during the processing of an ODD.

@@ -98,8 +98,8 @@ specifications for two classes (classSpec), rather than references (classRef). The reference to the module tei brings with it specifications for most TEI classes, including these two. An ODD processor will therefore - have to resolve duplicate class specifications for the classes att.global - and att.fragmentable. The required resolution is indicated by the value of + have to deal with duplicate class specifications for the classes att.global + and att.fragmentable. The resolution method required is indicated by the value of the mode attribute: if this is delete then both declarations are to be ignored, and the class is therefore suppressed; if it is change then the two declarations are to be merged, with any part of it present in the second specification @@ -107,7 +107,7 @@ attributes mentioned.

If you'd like to check that this ODD does what you expect, and you have oXygen installed with a recent version of the TEI Frameworks, just download the file - tei_bare.odd, and tell oXygen to apply the predefined transformation + tei_bare.odd (you can get it from the TEI github repo), and tell oXygen to apply the predefined transformation TEI ODD to HTML to it. This will produce a mini-manual for the TEI Bare customization in HTML format, near the beginning of which you should see a list of the elements the schema contains.