TEI P5 version 2.2.0 release notes

This version of the TEI 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 SourceForge tracking system. If you find something you think needs to change in the TEI Guidelines, schemas, tools, or website, please submit a ticket a http://tei.sf.net/ for consideration.

Since the last release (16 June 2012), the Council has closed at least 82 tickets entered in the SourceForge tracking system, from 25 different members of the TEI community (10 more than in the previous release!). Full details may be found at http://tei.sf.net/ and an active list sorted by ticket number is also available. Ticket numbers are also referenced in the subversion ChangeLog, as usual, which records around 490 commits during this period.

Schema Changes

Some of the important or interesting schema-related changes include:

After much discussion, the datatype and usage of the global attribute @rend was clarified. In response to 3519866, a new global @style attribute was created to allow local description of the source document's appearance using a formal style definition language such as CSS Increasingly, the Technical Council is attempting to provide more consistent Schematron constraints for additional validation (3557497, 3548772, 3064757) A new listApp element was added, along with other improvements for recording critical apparatus (3497356) The model.glossLike class was subdivided, to ensure that only members such as desc, precision, or equiv appear in the content of appropriate elements. (3565137) The @scheme attribute on keywords was made optional (3554050) A new att.milestoneUnit class was created to ensure consistency in use of @unit (3537452) Tighter restrictions were imposed on the content model of gi and att (3535672) The content model of table was changed to allow model.divBottom (footers, etc.) at the bottom (3531957) The idno element is now allowed inside person and place (3440977) The lg element, after much debate, is now allowed inside p (3532022) In the content model of editionStmt, explicit reference to respStmt has been replaced with model.respLike for greater flexibility (3439587) biblStruct can now be used for patent citations: the monogr element now allows an authority and an idno but no title, and imprint now allows classCode and classRef. (3513147)

Textual Changes

Some of important textual changes in the Guidelines include:

Correction of typos, clearer explanations, or provision of new examples in various sections of the Guidelines: (e.g. 3576189 , 3573757 , 3572375 , 3571101 , 3561766 , 3553911 , 3552973 , 3549757 , 3547934 , 3545113 , 3539329 , 3538141 , 3537574 , 3536504 , 3535717 , 3522019 , 3521714 , 3521288 , 3519772 , and others) Standardization of use of em and en dashes in the Guidelines (3471119) Clarification on the use of XPath to point to readings from an external apparatus (3497369) New section (23.1) added referencing the application/tei+xml IANA-registered media type (3565152) Greater clarification of ISO language codes and consistency in our recommendations and use of @xml:lang (3454803)

Environment Changes

The TEI Technical Council continually strives to improve the underlying infrastructure used to edit, store, test, and publish the outputs it creates. During this release cycle some of these infrastructure changes include:

The TEI source code now references its component parts by means of XInclude rather than by using system entities (3547869) TEI ODD processing now supports local modification of classes, so an element can claim membership of an attribute class (e.g. att.typed) while still redefining an element provided by the class locally (e.g. the @type attribute's value list) The HTML generated from the Guidelines now uses relative links to make browsing them in the Jenkins continuous integration servers easier (3556966) Various improvements to ODD processing, improvements to the TEI build infrastructure, especially in the testing framework and Schematron constraints The marking of TEI P4 as 'deprecated' in oxygen packages Improvements to the handling of exemplars during the build process Provision of additional outputs (e.g. JSON and JSONP see release/xml/tei/odd/) as default release items Many changes have been made to the TEI-C Stylesheet library to support these changes, fix reported bugs, and provide new features

New release of TEI Lite

An updated version of the ever-popular TEI Lite tutorial has been included with this release in the Exemplars directory. This new version has been updated to take advantage of the many new features introduced in the TEI since its first appearance in 1996, but has not changed in its original design goal, of aiming to specify the 50 or so TEI elements likely to be useful to 90% of TEI projects. There are no plans to update this tutorial, but we will continue to check that it remains compatible with future releases.