TEI P5 version 4.2.2 and Stylesheets version 7.51.2 release notes

After release 4.2.1, an issue was noticed concerning the controlled value lists of certain type attributes. The list was not appearing in either the documentation output or schemas. Thus a followup version 4.2.2 of the Guidelines and a corresponding (but unchanged) version 7.51.2 of the Stylesheets has been released to fix the issue. The following change was made to the Guidelines:

• Add a mode attribute with value "add" (#2128) to each type attribute that overrides the att.typed class.

Release 4.2.0 surfaced an issue with the conversion of the constraints on attirubtes to XHTML. This problem did not effect the schemas, but made the “Schema Declaration” portion of the references pages of several elements unreadable. Thus a followup version 4.2.1 of the Guidelines and version 7.51.1 of the Stylesheets has been released to handle the issue. The following change was made in the Stylesheets:

• The constraintSpec element is now ignored when processing an attDef in order to generate the “Schema Declaration” portion of the documentation for the attribute being defined (#488).

For completeness, the full release notes of the TEI P5 version 4.2.0 and Stylesheets version 7.51.0 are copied below.

Release 4.2.0 is codenamed ‘Ruby’.

This release introduces new features and resolves a number of issues raised by the TEI community. As always, the majority of these changes and corrections are a consequence of feature requests or bugs reported by the TEI community using the GitHub tracking system. A full list of the issues resolved in the course of this release cycle may be found under the 4.2.0 milestone.

The following changes are particularly worth highlighting in this release:

• New elements have been introduced for the encoding of ruby annotations, a particular method of glossing runs of text which is common in East Asian scripts (#2054, with thanks to Kiyonori Nagasaki, Satoru Nakamura, Kazuhiro Okada, Duncan Paterson, and Martin Holmes):
  • The ruby element contains a passage of base text along with its associated ruby gloss(es).
  • The rb element contains the base text annotated by a ruby gloss.
  • The rt element contains a ruby text, an annotation closely associated with a passage of the main text.
  • A subsection on Ruby Annotations has been added, which is also referenced from several suitable places in the Guidelines.
  With this first take we hope to initiate further discussion and the implementation of additional use cases.
• The new element persPronouns has been introduced to indicate the personal pronouns used, or assumed to be used, by the individual being described (#2010).
• Two new elements and an attribute class have been introduced to allow documents to declare their citation structure and to specify how structural information may be extracted from them (#1957):
  • The attribute class att.citeStructurePart provides attributes for selecting particular elements within a document.
  • The citeData element specifies how information may be extracted from citation structures.
  • The citeStructure element declares a structure and method for citing the current document.
• A new element, noteGrp, for grouping notes has been introduced (#1833).

• The attribute class att.translatable has been moved from the TEI Infrastructure module to the Documentation Elements module (#2036 and #2097).
• The interp, interpGrp, span, and spanGrp elements now have a type attribute (#2012).
• The material element is now a member of the attribute class att.typed. Furthermore, a free-standing function attribute has been added to the material element, including a sample values list (#1911).
• The altIdentifier element is now a member of the attribute class att.datable (#1986).
• The elements author, editor, funder, meeting, principal, and sponsor are now members of the attribute class att.datable (#1992).
• Elements from the RELAX NG annotations namespace are now allowed alongside elements from the RELAX NG schema language namespace inside content elements (#1937).
• The certainty element is now a member of the attribute class att.typed, and has a sample values list for the type attribute (#1934).
• The free-standing predicate attribute on model has been replaced with a reference to the newly introduced attribute class att.predicate. The equiv element is now also a member of the new class (#1925).
• In several previous releases the schema permitted altIdent as a child of category, joinGrp, and taxonomy. This was a corrigible error that has been fixed in this release (#1919).
• The object element is now allowed in the witness element (#1868).
• The name element is now directly allowed in the place element (#1484).

• The remarks of the match attribute in the attribute class att.scoping and the description of the class itself have been improved (#2078).
• The subsection on Dates and Times has been promoted to the new section Dates (#2066 and #2033).
• The description for the specDesc element has been improved and the key attribute is now required (#2061 and #2062).
• The prose discussion of the location of a place has been expanded (#2042).
• Several comments in ODD customization exemplars were changed to expository prose. This change was motivated by the realization that the placement of each comment made it ambiguous as to which bit of ODD it was referring to, especially after processing with Roma (#1987).
• Chapter 5 on Characters, Glyphs, and Writing Modes now refers potential proposers of new characters to the Unicode Standards to the UC Berkeley Script Encoding Initiative for assistance (#1963).
• The examples demonstrating the usage of the type attribute on listPerson elements has been improved (#1953).
• Several indefinite articles in front of element and attribute names have been corrected (#1951 and #2015).
• A number of translations have been added, updated or improved (#1989, #2082, #2101, #2074).
• Several examples have been corrected and improved (#1932, #2087).
• A new xenoData example using GeoJSON has been added demonstrating the usage of non-XML data (#1884).
• The descriptions of several modules have been improved (#1786).

• Some warning messages in tei_customization have been improved (#2052).
• The outdated genetic directory has been removed (#2043).
• For each specification element in the Guidelines that has glosses in any language, an English gloss has been added (if not already present), even if it had been previously considered unnecessary. Furthermore, a Schematron rule has been added to enforce continued use of English glosses. This change was made to facilitate maintaining glosses in multiple languages, and has the added benefit of treating all languages more equally (#2037).
• Licensing information has been added explicitly to the repository (#1962).
• Unused test files have been removed from the Test directory (#1942).

In addition, many improvements have been made to the XSLT stylesheets (which provide processing of TEI ODD files for Roma and OxGarage as well as other TEI conversions). The Stylesheets are maintained separately from the Guidelines at https://github.com/TEIC/Stylesheets. A full list of the issues resolved in the course of this release cycle may be found under the 7.51.0 milestone.

Highlights of this release include:

• Test2 has been updated to use its own copy of source/p5subset.xml (#456).
• A permalink has been added to all examples (#471).
• An erroneous resp attribute on the note element has been replaced with the type attribute in the OpenEdition output (#474).
• The hard-coded word bibliography used to link to the bibliography at the bottom right of many examples has been replaced with an i18n key (#478).
• An obsolete email address has been removed from the Guidelines pages (#484).