<?xml version="1.0" encoding="UTF-8"?><chapter xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="elements-attributes-and-patterns"><title>TAN patterns, elements, and attributes defined</title><para>The 81 elements and 60 attributes defined in TAN, excluding TEI, are the following::</para><para><code><link linkend="attribute-adverb">@adverb</link></code> <code><link linkend="attribute-affects-element">@affects-element</link></code> <code><link linkend="element-agent">&lt;agent&gt;</link></code> <code><link linkend="element-agentrole">&lt;agentrole&gt;</link></code> <code><link linkend="element-alias">&lt;alias&gt;</link></code> <code><link linkend="element-align">&lt;align&gt;</link></code> <code><link linkend="element-ana">&lt;ana&gt;</link></code> <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> <code><link linkend="element-assert">&lt;assert&gt;</link></code> <code><link linkend="attribute-bitext-relation">@bitext-relation</link></code> <code><link linkend="element-bitext-relation">&lt;bitext-relation&gt;</link></code> <code><link linkend="element-body">&lt;body&gt;</link></code> <code><link linkend="element-category">&lt;category&gt;</link></code> <code><link linkend="attribute-cert">@cert</link></code> <code><link linkend="attribute-cert2">@cert2</link></code> <code><link linkend="element-change">&lt;change&gt;</link></code> <code><link linkend="attribute-chars">@chars</link></code> <code><link linkend="element-checksum">&lt;checksum&gt;</link></code> <code><link linkend="element-claim">&lt;claim&gt;</link></code> <code><link linkend="attribute-claim-basis">@claim-basis</link></code> <code><link linkend="element-claim-basis">&lt;claim-basis&gt;</link></code> <code><link linkend="attribute-claimant">@claimant</link></code> <code><link linkend="attribute-code">@code</link></code> <code><link linkend="element-comment">&lt;comment&gt;</link></code> <code><link linkend="attribute-cont">@cont</link></code> <code><link linkend="attribute-context">@context</link></code> <code><link linkend="element-declarations">&lt;declarations&gt;</link></code> <code><link linkend="attribute-def-ref">@def-ref</link></code> <code><link linkend="element-desc">&lt;desc&gt;</link></code> <code><link linkend="element-div">&lt;div&gt;</link></code> <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> <code><link linkend="element-div-type">&lt;div-type&gt;</link></code> <code><link linkend="attribute-div-type-ref">@div-type-ref</link></code> <code><link linkend="element-div-type-ref">&lt;div-type-ref&gt;</link></code> <code><link linkend="attribute-ed-when">@ed-when</link></code> <code><link linkend="attribute-ed-who">@ed-who</link></code> <code><link linkend="element-equate-div-types">&lt;equate-div-types&gt;</link></code> <code><link linkend="element-equate-works">&lt;equate-works&gt;</link></code> <code><link linkend="element-feature">&lt;feature&gt;</link></code> <code><link linkend="attribute-feature-qty-test">@feature-qty-test</link></code> <code><link linkend="attribute-feature-test">@feature-test</link></code> <code><link linkend="element-filter">&lt;filter&gt;</link></code> <code><link linkend="attribute-flags">@flags</link></code> <code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code> <code><link linkend="attribute-from">@from</link></code> <code><link linkend="attribute-group">@group</link></code> <code><link linkend="element-group">&lt;group&gt;</link></code> <code><link linkend="element-group-type">&lt;group-type&gt;</link></code> <code><link linkend="element-head">&lt;head&gt;</link></code> <code><link linkend="attribute-help">@help</link></code> <code><link linkend="attribute-href">@href</link></code> <code><link linkend="attribute-id">@id</link></code> <code><link linkend="attribute-idrefs">@idrefs</link></code> <code><link linkend="attribute-in-progress">@in-progress</link></code> <code><link linkend="attribute-include">@include</link></code> <code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code> <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> <code><link linkend="element-item">&lt;item&gt;</link></code> <code><link linkend="element-key">&lt;key&gt;</link></code> <code><link linkend="element-l">&lt;l&gt;</link></code> <code><link linkend="attribute-lexicon">@lexicon</link></code> <code><link linkend="element-lexicon">&lt;lexicon&gt;</link></code> <code><link linkend="element-lm">&lt;lm&gt;</link></code> <code><link linkend="element-location">&lt;location&gt;</link></code> <code><link linkend="element-locus">&lt;locus&gt;</link></code> <code><link linkend="element-m">&lt;m&gt;</link></code> <code><link linkend="element-master-location">&lt;master-location&gt;</link></code> <code><link linkend="attribute-matches-m">@matches-m</link></code> <code><link linkend="attribute-matches-tok">@matches-tok</link></code> <code><link linkend="element-modal">&lt;modal&gt;</link></code> <code><link linkend="attribute-morphology">@morphology</link></code> <code><link linkend="element-morphology">&lt;morphology&gt;</link></code> <code><link linkend="attribute-n">@n</link></code> <code><link linkend="element-name">&lt;name&gt;</link></code> <code><link linkend="attribute-new">@new</link></code> <code><link linkend="element-normalization">&lt;normalization&gt;</link></code> <code><link linkend="attribute-object">@object</link></code> <code><link linkend="element-object">&lt;object&gt;</link></code> <code><link linkend="attribute-object-datatype">@object-datatype</link></code> <code><link linkend="attribute-object-lexical-constraint">@object-lexical-constraint</link></code> <code><link linkend="attribute-old">@old</link></code> <code><link linkend="element-person">&lt;person&gt;</link></code> <code><link linkend="element-place">&lt;place&gt;</link></code> <code><link linkend="attribute-pos">@pos</link></code> <code><link linkend="element-realign">&lt;realign&gt;</link></code> <code><link linkend="attribute-ref">@ref</link></code> <code><link linkend="attribute-regex">@regex</link></code> <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> <code><link linkend="element-rename">&lt;rename&gt;</link></code> <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code> <code><link linkend="element-replace">&lt;replace&gt;</link></code> <code><link linkend="attribute-replacement">@replacement</link></code> <code><link linkend="element-report">&lt;report&gt;</link></code> <code><link linkend="attribute-reuse-type">@reuse-type</link></code> <code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code> <code><link linkend="element-rights-excluding-sources">&lt;rights-excluding-sources&gt;</link></code> <code><link linkend="attribute-rights-holder">@rights-holder</link></code> <code><link linkend="element-rights-source-only">&lt;rights-source-only&gt;</link></code> <code><link linkend="element-role">&lt;role&gt;</link></code> <code><link linkend="attribute-roles">@roles</link></code> <code><link linkend="element-scriptum">&lt;scriptum&gt;</link></code> <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> <code><link linkend="attribute-seg">@seg</link></code> <code><link linkend="element-source">&lt;source&gt;</link></code> <code><link linkend="element-split-leaf-div-at">&lt;split-leaf-div-at&gt;</link></code> <code><link linkend="attribute-src">@src</link></code> <code><link linkend="attribute-subject">@subject</link></code> <code><link linkend="element-subject">&lt;subject&gt;</link></code> <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code> <code><link linkend="element-tail">&lt;tail&gt;</link></code> <code><link linkend="element-TAN-A-div">&lt;TAN-A-div&gt;</link></code> <code><link linkend="element-TAN-A-tok">&lt;TAN-A-tok&gt;</link></code> <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code> <code><link linkend="element-TAN-key">&lt;TAN-key&gt;</link></code> <code><link linkend="element-TAN-LM">&lt;TAN-LM&gt;</link></code> <code><link linkend="element-TAN-mor">&lt;TAN-mor&gt;</link></code> <code><link linkend="element-TAN-T">&lt;TAN-T&gt;</link></code> <code><link linkend="attribute-TAN-version">@TAN-version</link></code> <code><link linkend="attribute-to">@to</link></code> <code><link linkend="element-tok">&lt;tok&gt;</link></code> <code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code> <code><link linkend="element-topic">&lt;topic&gt;</link></code> <code><link linkend="element-transliteration">&lt;transliteration&gt;</link></code> <code><link linkend="attribute-type">@type</link></code> <code><link linkend="element-unit">&lt;unit&gt;</link></code> <code><link linkend="attribute-units">@units</link></code> <code><link linkend="attribute-val">@val</link></code> <code><link linkend="element-value">&lt;value&gt;</link></code> <code><link linkend="attribute-verb">@verb</link></code> <code><link linkend="element-verb">&lt;verb&gt;</link></code> <code><link linkend="element-version">&lt;version&gt;</link></code> <code><link linkend="attribute-when">@when</link></code> <code><link linkend="element-when">&lt;when&gt;</link></code> <code><link linkend="attribute-when-accessed">@when-accessed</link></code> <code><link linkend="attribute-where">@where</link></code> <code><link linkend="attribute-which">@which</link></code> <code><link linkend="attribute-who">@who</link></code> <code><link linkend="attribute-work">@work</link></code> <code><link linkend="element-work">&lt;work&gt;</link></code> <code><link linkend="attribute-xmlid">@xml:id</link></code> <code><link linkend="attribute-xmllang">@xml:lang</link></code> </para><para>The contents of this chapter have been generated automatically. Although much effort has
         been spent to ensure accurate representation of the schemas and function library, you may
         find errors or inconsistencies. In such cases, the functions and schemas (particularly the
         RELAX-NG, compact syntax) are to be given priority.</para><section><title>TAN-core elements and attributes summarized</title><section xml:id="element-agent"><title><code>&lt;agent&gt;</code></title><para>The element <code>agent</code> specifies a person or organization that played a direct or indirect role in preparing, creating, or editing the data.</para><para>At least one <code><link linkend="element-agent">&lt;agent&gt;</link></code> must have an <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> that is a tag URN whose namespace matches that of the IRI name. By default, the first such <code><link linkend="element-agent">&lt;agent&gt;</link></code>, called the key agent, is taken to be the person or organization ultimately responsible for the assertions in the current file. See <xref linkend="iri_name"/></para><para>This element may also name a computer or algorithm that performed a task. This feature is useful for crediting software, e.g., an OCR program used to convert an image, or an algorithm that estimates word-to-word alignments.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-roles">@roles</link></code>?, <code><link linkend="attribute-xmlid">@xml:id</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para><caution><para>Every TAN file must have a primary agent, the organization or person that takes the greatest responsibility for the content of the TAN file. The primary agent is defined as the first <code><link linkend="element-agent">&lt;agent&gt;</link></code> with an <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> that is a tag URI whose namespace matches the namespaces of <code><link linkend="attribute-id">@id</link></code> in the root element.</para></caution><para><example><title><code>&lt;agent&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;agent&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;agent&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;agent&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-agentrole"><title><code>&lt;agentrole&gt;</code></title><para>The element <code>agentrole</code> specifies a time period when one or more <code><link linkend="element-agent">&lt;agent&gt;</link></code>s held one or more <code><link linkend="element-role">&lt;role&gt;</link></code>s.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="attribute-who">@who</link></code>, <code><link linkend="attribute-roles">@roles</link></code>, <code><link linkend="element-when">&lt;when&gt;</link></code>+))</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="element-alias"><title><code>&lt;alias&gt;</code></title><para>The element <code>alias</code> assigns multiple values of xml:id to a single xml:id.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="attribute-xmlid">@xml:id</link></code>, <code><link linkend="attribute-idrefs">@idrefs</link></code>))</synopsis><para>Used by: <code><link linkend="pattern-declaration-core">~declaration-core</link></code></para><caution><para>A <code><link linkend="element-alias">&lt;alias&gt;</link></code> may not mix idrefs from different elements.</para></caution><caution><para><code><link linkend="element-alias">&lt;alias&gt;</link></code> references must not be circular.</para></caution><para><example><title><code>&lt;alias&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;work xml:id="αc" which="Explanationes de commentario graeco Ammonii"/&gt;
         &lt;alias xml:id="αd" idrefs="α αc"/&gt;
         &lt;work xml:id="φ" which="Lemmata de commentario graeco Ioannis Philoponi"/&gt;
         &lt;work xml:id="φc" which="Explanationes de commentario graeco Ioannis Philoponi"/&gt;
         &lt;alias xml:id="φd" idrefs="φ φc"/&gt;
         &lt;work xml:id="ο" which="Lemmata de commentario graeco Olympiodori"/&gt;
         &lt;work xml:id="οc" which="Explanationes de commentario graeco Olympiodori"/&gt;
         &lt;alias xml:id="οd" idrefs="ο οc"/&gt;
         &lt;work xml:id="η" which="Lemmata de commentario graeco Eliae"/&gt;
         &lt;work xml:id="ηc" which="Explanationes de commentario graeco Eliae"/&gt;
         &lt;alias xml:id="ηd" idrefs="η ηc"/&gt;
         &lt;work xml:id="σ" which="Lemmata de commentario graeco Simplicii"/&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-body"><title><code>&lt;body&gt;</code></title><para>The element <code>body</code> contains the data</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-in-progress">@in-progress</link></code>?, <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
{[TAN-A-div (<code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>):]   <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>} OR 

{[TAN-mor (<code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>):]   <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>):]   <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>})</synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para><para><example><title><code>&lt;body&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      &lt;div type="p" n="1"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="p" n="2"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="p" n="3"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;body&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      &lt;div type="ch" n="1"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="ch" n="2"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="ch" n="3"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;body&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      &lt;div type="ti" n="ti"&gt;CATÉGORIES&lt;/div&gt;
      &lt;div type="sec" n="1"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="sec" n="2"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;body&gt;</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs-realigned"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      &lt;div n="ti~1" type="ti"&gt;
         .........
      &lt;/div&gt;
      &lt;div n="1" type="ch"&gt;
         .........
      &lt;/div&gt;
      &lt;div n="2" type="ch"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-change"><title><code>&lt;change&gt;</code></title><para>The element <code>change</code> declares a change made to the current file. Must credit an <code><link linkend="element-agent">&lt;agent&gt;</link></code>, specified by <code><link linkend="attribute-who">@who</link></code>, and a time the change was made, specified by <code>@when.</code></para><para>Collectively, <code><link linkend="element-change">&lt;change&gt;</link></code> elements are called the changelog, the revision history of the document. </para><para>The editor has discretion as to how long or detailed a <code><link linkend="element-change">&lt;change&gt;</link></code> should be, or how many should be retained in a changelog. Ideally, <code><link linkend="element-change">&lt;change&gt;</link></code>s documenting every published version should be retained.</para><para><code><link linkend="element-change">&lt;change&gt;</link></code> elements may appear in any order, but it is good practice to put the most recent at the top.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-when">@when</link></code>, <code><link linkend="attribute-flags">@flags</link></code>?, <code><link linkend="attribute-who">@who</link></code>, text</synopsis><para><example><title><code>&lt;change&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-07T16:36:28.867-04:00" who="kalvesmaki"&gt;Reformatted file at
         ar.cat.eng.1926.edghill.sem.xml to the structure of the copy of the model.&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;change&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-06-22T08:04:25.003-04:00" who="kalvesmaki"&gt;Reformatted according to first
         model found. Backup made at
         file:/C:/Users/jdkalv/Dropbox/TAN/library/TAN-1-dev/examples/ar.cat.eng.1926.edghill.sem-201606220804250030400.xml.&lt;/change&gt;
      &lt;change when="2016-01-26-04:00" who="kalvesmaki"&gt;Started new file.&lt;/change&gt;
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;change&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-10" who="kalvesmaki"&gt;Began new file&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para></section><section xml:id="element-checksum"><title><code>&lt;checksum&gt;</code></title><para>The element <code>checksum</code> specifies some checksum that can be used to confirm the identity of a digital file being referred to. This element contains other elements that define the type and value of the checksum. Must begin with an IRI + name pattern that defines the type of checksum being used (e.g., SHA-1).</para><para>This element allows later users ensure that a copies of a file are identical. </para><para>The checksum will not be generated, checked, or validated by TAN schemas. Checksum validation must be provided by other means.</para><para>Formal Definition</para><synopsis>
   
      ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>), <code><link linkend="element-value">&lt;value&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code></para><para><example><title><code>&lt;checksum&gt;</code></title><programlisting>      &lt;source&gt;
         .........
         &lt;name&gt;The Saint Patrick's Confessio Hypertext Stack Project edition&lt;/name&gt;
         &lt;checksum&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Sha-1&lt;/IRI&gt;
            &lt;name&gt;SHA-1&lt;/name&gt;
            &lt;value&gt;91D95564ABDF2B2C1B9EEF016CBA51E8179646CC&lt;/value&gt;
         &lt;/checksum&gt;
         &lt;location href="confessio_english_temp.xml" when-accessed="2016-09-09"/&gt;
      &lt;/source&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/patricius.confessio.2003.eng.xml">patricius.confessio.2003.eng</link></para></note></para></section><section xml:id="element-comment"><title><code>&lt;comment&gt;</code></title><para>The element <code>comment</code> discusses issues relevant to nearby data. Must credit an <code><link linkend="element-agent">&lt;agent&gt;</link></code>, specified by <code><link linkend="attribute-who">@who</link></code>, and a time the comment was made, specified by <code>@when.</code></para><para>Formal Definition</para><synopsis><code><link linkend="attribute-when">@when</link></code>, <code><link linkend="attribute-who">@who</link></code>, text</synopsis><para>Used by: <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-alignment">~alignment</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-category">~category</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt">~decl-filt</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-TAN-head">~TAN-head</link></code>, <code><link linkend="pattern-TAN-body">~TAN-body</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-decl-opt">~decl-opt</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><para><example><title><code>&lt;comment&gt;</code></title><programlisting>      &lt;source&gt;
         .........
         &lt;name&gt;The traditional games of England, Scotland, and Ireland : with tunes, singing-rhymes,
        and methods of playing according to the variants extant and recorded in different parts of
        the Kingdom&lt;/name&gt;
         &lt;comment when="2015-03-10" who="park"&gt;This work is to be found at vol. 2, pp.
        108-111.&lt;/comment&gt;
      &lt;/source&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/gomme.1989.ring-o-roses.xml">gomme.1989.ring-o-roses</link></para></note></para><para><example><title><code>&lt;comment&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;comment when="2016-01-25-05:00" who="park"&gt;The following agents and roles apply only to the
         preparation of the TAN file, not the original TEI file that serves as the source. See the
         teiHeader for details on responsibility.&lt;/comment&gt;
      &lt;agent xml:id="park" roles="editor"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/patricius.confessio.2003.eng.xml">patricius.confessio.2003.eng</link></para></note></para><para><example><title><code>&lt;comment&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;change when="2014-08-13" who="schmidt"&gt;Anfang&lt;/change&gt;
      &lt;comment when="2014-08-13" who="schmidt"&gt;unten auf der Z. 438, recht&lt;/comment&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.deu.1897.xml">ring-o-roses.deu.1897</link></para></note></para><para><example><title><code>&lt;comment&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;change when="2014-10-24" who="park"&gt;Started file&lt;/change&gt;
      &lt;comment when="2014-10-24" who="park"&gt;See p. 39 of source.&lt;/comment&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1987.xml">ring-o-roses.eng.1987</link></para></note></para></section><section xml:id="element-declarations"><title><code>&lt;declarations&gt;</code></title><para>The element <code>declarations</code> contains assumptions or decisions made that materially affect the interpretation of the data in <code><link linkend="element-body">&lt;body&gt;</link></code>. Every TAN format's <code><link linkend="element-declarations">&lt;declarations&gt;</link></code> is unique.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; <code><link linkend="element-alias">&lt;alias&gt;</link></code>* &amp; 
{[TAN-A-div (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   
   (<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; )} OR 

{[TAN-A-tok (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   
   (<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; <code><link linkend="element-bitext-relation">&lt;bitext-relation&gt;</link></code>+ &amp; <code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code>++ &amp; <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*)} OR 

{[TAN-c (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   } OR 

{[TAN-key (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*} OR 

{[TAN-class-1 (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   
   (
      (<code><link linkend="element-work">&lt;work&gt;</link></code> &amp; <code><link linkend="element-version">&lt;version&gt;</link></code>? &amp; <code><link linkend="element-div-type">&lt;div-type&gt;</link></code>+ &amp; <code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-filter">&lt;filter&gt;</link></code>?) &amp; {empty})} OR 

{[TAN-core (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-declaration-items">~declaration-items</link></code>):]   
   (<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; <code><link linkend="element-lexicon">&lt;lexicon&gt;</link></code>+ &amp; <code><link linkend="element-morphology">&lt;morphology&gt;</link></code>+ &amp; <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*)})</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para><para><example><title><code>&lt;declarations&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="p"&gt;
            .........
         &lt;/div-type&gt;
         &lt;div-type xml:id="c"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;declarations&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         &lt;div-type xml:id="par"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;declarations&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         &lt;div-type xml:id="par"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;declarations&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         &lt;div-type xml:id="par"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-desc"><title><code>&lt;desc&gt;</code></title><para>The element <code>desc</code> provides a description of a concept, person, or thing referred to by the parent element (or the current document, if the parent element is <code><link linkend="element-head">&lt;head&gt;</link></code>). <code><link linkend="element-desc">&lt;desc&gt;</link></code> is, in effect, a <code><link linkend="element-comment">&lt;comment&gt;</link></code> about that concept, person, or thing. It has two possible structures, one human-readable and the other computer-readable.</para><para>Under the first, human-readable approach, <code><link linkend="element-desc">&lt;desc&gt;</link></code> takes merely a descriptive text about the entity, optionally with <code>@xml:lang.</code> If you provide descriptions in other languages, it best to make sure that each version says roughly the same thing.</para><para>Under the second, computer-readable approach, <code><link linkend="element-desc">&lt;desc&gt;</link></code> takes an IRI + name pattern plus <code><link linkend="element-location">&lt;location&gt;</link></code> and <code><link linkend="attribute-href">@href</link></code> pointing to a <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code> file, which provides contextual information about the concept, person, or thing. </para><para>Formal Definition</para><synopsis>
   (<code><link linkend="pattern-metadata-desc">~metadata-desc</link></code> | (<code><link linkend="attribute-which">@which</link></code> | 
      
         (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+))))</synopsis><caution><para>All text must be normalized (Unicode NFC).</para></caution><para><example><title><code>&lt;desc&gt;</code></title><programlisting>      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;desc&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;div-type xml:id="ic"&gt;
            .........
            &lt;name&gt;independent clause&lt;/name&gt;
            &lt;desc&gt;used to identify two or more sentence parts that have a subject and predicate and
               function as a sentence.&lt;/desc&gt;
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;desc&gt;</code></title><programlisting>      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para></section><section xml:id="element-for-lang"><title><code>&lt;for-lang&gt;</code></title><para>The element <code>for-lang</code> specifies a language that is being discussed. This element does NOT name the language of the text enclosed by the parent element, which is the province of <code>@xml:lang.</code></para><para>Values should adhere to BCP (Best Common Practices) 47, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt.">http://www.rfc-editor.org/rfc/bcp/bcp47.txt.</link> For more details see <xref linkend="language"/>.</para><para>Examples: 'eng' (English), 'grc' (classical Greek), 'lat' (Latin). For more see <xref linkend="language"/></para><para>Formal Definition</para><synopsis>language </synopsis><para>Used by: <code><link linkend="pattern-source-list">~source-list</link></code>, <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code></para><para><example><title><code>&lt;for-lang&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;lexicon xml:id="LSJ"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;http://lccn.loc.gov/95032369&lt;/IRI&gt;
            .........
         &lt;/lexicon&gt;
         &lt;lexicon xml:id="Lampe"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;http://lccn.loc.gov/77372171&lt;/IRI&gt;
            .........
         &lt;/lexicon&gt;
         &lt;lexicon xml:id="new"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;urn:uuid:d6558d00-8f68-11e3-950a-425861b86ab6&lt;/IRI&gt;
            .........
         &lt;/lexicon&gt;
         &lt;morphology xml:id="Perseus"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-r-mor:grc:perseus&lt;/IRI&gt;
            .........
         &lt;/morphology&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="element-group"><title><code>&lt;group&gt;</code></title><para>The element <code>group</code> collects items that share a common property, defined by the <code><link linkend="element-group-type">&lt;group-type&gt;</link></code> to which it refers.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (
{[TAN-key (<code><link linkend="pattern-group-attributes">~group-attributes</link></code>):]   <code><link linkend="pattern-group-attributes">~group-attributes</link></code>} OR 

{[TAN-class-2 (<code><link linkend="pattern-group-attributes">~group-attributes</link></code>):]   <code><link linkend="pattern-group-attributes">~group-attributes</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-group-attributes">~group-attributes</link></code>):]   <code><link linkend="pattern-group-attributes">~group-attributes</link></code>}, (
{[TAN-class-1 (<code><link linkend="pattern-body-group">~body-group</link></code>):]   {empty}} OR 

{[TAN-core (<code><link linkend="pattern-body-group">~body-group</link></code>):]   <code><link linkend="element-group">&lt;group&gt;</link></code>} | 
{[TAN-A-tok (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-align">&lt;align&gt;</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-item">~item</link></code>):]   +} OR 

{[TAN-key (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-item">&lt;item&gt;</link></code>} OR 

{[TAN-T (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-div">&lt;div&gt;</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-item">~item</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-ana">&lt;ana&gt;</link></code>})*))</synopsis><para>Used by: <code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code></para><caution><para><code><link linkend="attribute-affects-element">@affects-element</link></code> must include only names of TAN elements that accept <code><link linkend="attribute-which">@which</link></code></para></caution><para><example><title><code>&lt;group&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-key:ar.cat"&gt;
   .........
   &lt;body in-progress="true" affects-element="work"&gt;
      .........
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;group&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
      &lt;/group&gt;
      &lt;group&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
      &lt;/group&gt;
      &lt;group&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
      &lt;/group&gt;
      &lt;group&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
         &lt;item&gt;
            .........
         &lt;/item&gt;
      &lt;/group&gt;
      &lt;group&gt;
         .........
      &lt;/group&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-key/ar.cat.TAN-key.xml">ar.cat.TAN-key</link></para></note></para></section><section xml:id="element-group-type"><title><code>&lt;group-type&gt;</code></title><para>The element <code>group-type</code> defines types of <code><link linkend="element-group">&lt;group&gt;</link></code>s. See main.xml# keywords-group-type</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-xmlid">@xml:id</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code>, <code><link linkend="pattern-TAN-key-decl">~TAN-key-decl</link></code></para><para><example><title><code>&lt;group-type&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;morphology xml:id="Perseus"&gt;
            .........
         &lt;/morphology&gt;
         &lt;group-type xml:id="status" which="status"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>&lt;group-type&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;group-type xml:id="inline-start" which="no new line start"/&gt;
         &lt;group-type xml:id="inline-end" which="no new line end"/&gt;
         &lt;group-type xml:id="line-start" which="new line start"/&gt;
         &lt;group-type xml:id="line-end" which="new line end"/&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/div-types.TAN-key.xml">div-types.TAN-key</link></para></note></para></section><section xml:id="element-head"><title><code>&lt;head&gt;</code></title><para>The element <code>head</code> contains the metadata (data about the data contained by <code><link linkend="element-body">&lt;body&gt;</link></code>)</para><para>This element indicates at a bare minimum the name of the file, the sources, the most significant parts of the editorial history; the linguistic or scholarly conventions that have been adopted in creating the data; the license, i.e., who holds what rights to the data, and what kind of reuse is allowed; the persons, organizations, or entities that helped create the data, and the roles played by each.</para><para>The structure of <code><link linkend="element-head">&lt;head&gt;</link></code> is shared across TAN files, with differences between them isolated to the child <code><link linkend="element-declarations">&lt;declarations&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
      (<code><link linkend="pattern-entity-digital-tan-self-ref">~entity-digital-tan-self-ref</link></code>, <code><link linkend="element-rights-excluding-sources">&lt;rights-excluding-sources&gt;</link></code>, (<code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code>* &amp; <code><link linkend="element-key">&lt;key&gt;</link></code>* &amp; 
{[TAN-A-div (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="element-source">&lt;source&gt;</link></code>+} OR 

{[TAN-A-tok (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="pattern-source-list">~source-list</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-source-list">~source-list</link></code>):]   {empty}} OR 

{[TAN-key (<code><link linkend="pattern-source-list">~source-list</link></code>):]   {empty}} OR 

{[TAN-LM-lang (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>} OR 

{[TAN-LM (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="element-source">&lt;source&gt;</link></code>} OR 

{[TAN-class-3 (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="element-source">&lt;source&gt;</link></code>*} OR 

{[TAN-core (<code><link linkend="pattern-source-list">~source-list</link></code>):]   <code><link linkend="element-source">&lt;source&gt;</link></code>} &amp; <code><link linkend="element-see-also">&lt;see-also&gt;</link></code>*), <code><link linkend="element-declarations">&lt;declarations&gt;</link></code>, <code><link linkend="element-agent">&lt;agent&gt;</link></code>+, <code><link linkend="element-role">&lt;role&gt;</link></code>+, <code><link linkend="element-agentrole">&lt;agentrole&gt;</link></code>*, <code><link linkend="element-change">&lt;change&gt;</link></code>+))</synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para><para><example><title><code>&lt;head&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;head&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;head&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, French translation by J. Barthélemy Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;head&gt;</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs-realigned"&gt;
   &lt;head&gt;
      &lt;name&gt;Realignment of Categories, Aristotle, French translation by J. Barthélemy
         Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-inclusion"><title><code>&lt;inclusion&gt;</code></title><para>The element <code>inclusion</code> specifies a TAN file that is available for inclusion. An inclusion occurs whenever an element X points to this inclusion by means of <code>@include.</code> TAN-compliant validators and processors will find every X that is found in the included file (checked recursively, against any inclusions of X adopted by the inclusion) and insert them at that place in the main document.</para><para>Only select elements will be included, not the entire inclusion file. Exactly which elements are included is dictated by <code>@include.</code></para><para>Invoking an <code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code> does not require its use. </para><para>For more on this, see <xref linkend="inclusions-and-keys"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-xmlid">@xml:id</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
   
      (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+)))</synopsis><para>Used by: <code><link linkend="pattern-work-equiv">~work-equiv</link></code>, <code><link linkend="pattern-div-type-equiv">~div-type-equiv</link></code>, <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-alignment-inclusion-opt">~alignment-inclusion-opt</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-category">~category</link></code>, <code><link linkend="pattern-test-pattern">~test-pattern</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-inclusion-list">~inclusion-list</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-relationship">~relationship</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code>, <code><link linkend="pattern-decl-alias">~decl-alias</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><caution><para>Inclusions may not introduce duplicate values of <code>@xml:id.</code></para></caution><caution><para>For any element with <code><link linkend="attribute-include">@include</link></code>, at least one element of the same name must be found in target inclusion document.</para></caution><caution><para>Inclusions may not be circular.</para></caution><caution><para>Inclusions are integral parts of any TAN file. Access to at least one copy is absolutely mandatory.</para></caution><caution><para>Every inclusion should have at least one document available.</para></caution><caution><para>Every element with a <code><link linkend="element-location">&lt;location&gt;</link></code> should have at least one document available.</para></caution><caution><para>Every TAN file referred to by way of an element containing <code><link linkend="element-location">&lt;location&gt;</link></code> should have an <code><link linkend="attribute-id">@id</link></code> that matches the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> of the parent of the <code><link linkend="element-location">&lt;location&gt;</link></code></para></caution><caution><para>No element may point to a TAN file that has an identical <code><link linkend="attribute-id">@id</link></code> value; the only exception is a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> pointing to an older or new version.</para></caution><important><para>If <code><link linkend="attribute-when-accessed">@when-accessed</link></code> predates one or more dates in a target file, a warning will be returned.</para></important><important><para>If a target file does not explicitly give the <code><link linkend="element-body">&lt;body&gt;</link></code>'s <code><link linkend="attribute-in-progress">@in-progress</link></code> the value of <code>true(</code>) a warning will be returned. <quote>Target file is marked as being in progress.</quote></para></important><important><para>If a target file has a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> marked as a new version (update) a warning will be returned.</para></important><para><example><title><code>&lt;inclusion&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;inclusion xml:id="rel"&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="../ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-09-28T08:50:23.457-04:00"/&gt;
      &lt;/inclusion&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="element-IRI"><title><code>&lt;IRI&gt;</code></title><para>The element <code>IRI</code> contains an International Resource Identifier that serves as a name for the a concept, person, or thing referred to by the parent element. IRIs are explained at <xref linkend="IRIs_and_linked_data"/>.</para><para>Any kind of IRIs are allowed: URLs, tag URNs, UUIDs, etc. For names of well-known resources, a URL identifier might be preferred (<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://...),">http://...),</link> to facilitate linked data. If an entity/resource lacks a suitable URL-type name, you may use or coin any other valid IRI, such as a UUID, a tag URN, or an OID. Some concepts may be difficult to find IRIs for.</para><para>Sibling <code><link linkend="element-IRI">&lt;IRI&gt;</link></code>s are to be treated as names for the same thing, not as names of different things. Nevertheless, they are not synonymous, only poecilonymic. In the terms of Web Ontology Language (<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/owl-ref/),">http://www.w3.org/TR/owl-ref/),</link> sibling <code><link linkend="element-IRI">&lt;IRI&gt;</link></code>s cannot be assumed to share the relationship owl:sameAs, because they will draw from independent vocabularies that may define similar concepts differently. </para><para>An element defined with multiple <code><link linkend="element-IRI">&lt;IRI&gt;</link></code>s is technically within the intersection, not the union, of those definitions. Nevertheless, most interpretations of TAN files will draw inferences based upon the union. That is, if item A is defined by IRI X, item B by IRIs X and Y, and item C with IRI Y, it is likely that users of the data will infer identity between items A and C. It is advisable to be cautious is assigning multiple IRIs to entities.</para><para>The element is named IRI instead of URI to encourage internationalization. Alphabets other than the Latin are welcome. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, anyURI (pattern [a-zA-Z][\-.+a-zA-Z0-9]+:\S+)</synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code>, <code><link linkend="pattern-entity-nondigital-ref">~entity-nondigital-ref</link></code></para><caution><para>An IRI may appear no more than once in a TAN document.</para></caution><caution><para>An IRI that names a TAN file must match that file's <code><link linkend="attribute-id">@id</link></code> exactly.</para></caution><caution><para>No file may import keys that have duplicate IRIs.</para></caution><caution><para>All text must be normalized (Unicode NFC).</para></caution><caution><para>Every item in a reserved TAN-key must have at least one IRI with a tag URN in the TAN namespace</para></caution><para><example><title><code>&lt;IRI&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/007901738/catalog&lt;/IRI&gt;
         &lt;name&gt;Aristotle: Categoriae &amp; De interpretatione by E.M. Edghill. Analytica priora / by
            A.J. Jenkinson. Analytica posteriora / by G.R.G. Mure. Oxford : Clarendon Press, 1926.
         &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="alternatively divided edition"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="element-key"><title><code>&lt;key&gt;</code></title><para>The element <code>key</code> specifies a tan:item from a TAN-key (predefined, or declared in a <code><link linkend="element-key">&lt;key&gt;</link></code>) that defines the contents of an element that has <code>@which.</code></para><para>Any number of <code><link linkend="element-key">&lt;key&gt;</link></code>s may be supplied, but all <code><link linkend="element-item">&lt;item&gt;</link></code>s with unique names for the element indicated by <code>@affects-elements.</code></para><para>For more discussion, see <xref linkend="tan-key"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
      
         (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+))))</synopsis><para>Used by: <code><link linkend="pattern-key-list">~key-list</link></code></para><caution><para>No file may import keys that have duplicate IRIs.</para></caution><caution><para>Every element with a <code><link linkend="element-location">&lt;location&gt;</link></code> should have at least one document available.</para></caution><caution><para>Every TAN file referred to by way of an element containing <code><link linkend="element-location">&lt;location&gt;</link></code> should have an <code><link linkend="attribute-id">@id</link></code> that matches the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> of the parent of the <code><link linkend="element-location">&lt;location&gt;</link></code></para></caution><caution><para>No element may point to a TAN file that has an identical <code><link linkend="attribute-id">@id</link></code> value; the only exception is a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> pointing to an older or new version.</para></caution><important><para>If <code><link linkend="attribute-when-accessed">@when-accessed</link></code> predates one or more dates in a target file, a warning will be returned.</para></important><important><para>If a target file does not explicitly give the <code><link linkend="element-body">&lt;body&gt;</link></code>'s <code><link linkend="attribute-in-progress">@in-progress</link></code> the value of <code>true(</code>) a warning will be returned. <quote>Target file is marked as being in progress.</quote></para></important><important><para>If a target file has a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> marked as a new version (update) a warning will be returned.</para></important><caution><para>An element's <code><link linkend="attribute-which">@which</link></code> must have a value that corresponds to a <code><link linkend="element-name">&lt;name&gt;</link></code>, either in the core TAN keyword or an associated TAN-key file, that is marked as applying to that element.</para></caution><caution><para>Keywords (values of <code><link linkend="attribute-which">@which</link></code>) must be unique for a given element name.</para></caution><caution><para>Any element that takes <code><link linkend="attribute-which">@which</link></code> must have keywords defined for that element.</para></caution><caution><para>Keys are integral parts of a document. Access to at least one version is absolutely mandatory.</para></caution><para><example><title><code>&lt;key&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="park"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;key&gt;
         &lt;IRI&gt;tag:parkj@textalign.net,2015:TAN-key:ar.cat&lt;/IRI&gt;
         &lt;name&gt;Keywords for Aristotle's Categories&lt;/name&gt;
         &lt;location href="../TAN-key/ar.cat.TAN-key.xml" when-accessed="2017-03-10T11:50:15.499-05:00"/&gt;
      &lt;/key&gt;
      &lt;source xml:id="grc"&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-location"><title><code>&lt;location&gt;</code></title><para>The element <code>location</code> declares where an electronic file was found and when. </para><para>The URL may be absolute or relative to the current document. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-when-accessed">@when-accessed</link></code>, <code><link linkend="attribute-href">@href</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code></para><caution><para>Every element with a <code><link linkend="element-location">&lt;location&gt;</link></code> should have at least one document available.</para></caution><caution><para>Every TAN file referred to by way of an element containing <code><link linkend="element-location">&lt;location&gt;</link></code> should have an <code><link linkend="attribute-id">@id</link></code> that matches the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> of the parent of the <code><link linkend="element-location">&lt;location&gt;</link></code></para></caution><caution><para>No element may point to a TAN file that has an identical <code><link linkend="attribute-id">@id</link></code> value; the only exception is a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> pointing to an older or new version.</para></caution><important><para>If <code><link linkend="attribute-when-accessed">@when-accessed</link></code> predates one or more dates in a target file, a warning will be returned.</para></important><important><para>If a target file does not explicitly give the <code><link linkend="element-body">&lt;body&gt;</link></code>'s <code><link linkend="attribute-in-progress">@in-progress</link></code> the value of <code>true(</code>) a warning will be returned. <quote>Target file is marked as being in progress.</quote></para></important><important><para>If a target file has a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> marked as a new version (update) a warning will be returned.</para></important><para><example><title><code>&lt;location&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         &lt;location href="ar.cat.eng.1926.edghill.sem.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;location&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-sem.xml" when-accessed="2016-02-10T14:08:52.058-05:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-02-11T12:40:42.823-05:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="element-master-location"><title><code>&lt;master-location&gt;</code></title><para>The element <code>master-location</code> points to a location where a master copy of the file is to be found. Use of this element entails a commitment to updating the TAN file in those locations. Also, if <code><link linkend="attribute-in-progress">@in-progress</link></code> is false, a <code><link linkend="element-master-location">&lt;master-location&gt;</link></code> must be provided.</para><para>The URL may be absolute or relative to the current document. </para><para><code><link linkend="element-master-location">&lt;master-location&gt;</link></code> does not disallow the file from being kept, published, or distributed elsewhere. It merely points to the main locations where an authoritative version of the file is to be found. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-href">@href</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-self-ref">~entity-digital-tan-self-ref</link></code></para><important><para>Any TAN file marked as being no longer in progress should have at least one master-location.</para></important><caution><para>No <code><link linkend="element-master-location">&lt;master-location&gt;</link></code> may have an <code><link linkend="attribute-href">@href</link></code> that points to a compressed archive.</para></caution><para><example><title><code>&lt;master-location&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Dictionary entry by Alice Bertha Gomme on Ring a Ring o' Roses&lt;/name&gt;
      &lt;master-location href="http://textalign.net/release/TAN-1-dev/examples/gomme.1989.ring-o-roses.xml"/&gt;
      &lt;rights-excluding-sources rights-holder="park"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/gomme.1989.ring-o-roses.xml">gomme.1989.ring-o-roses</link></para></note></para><para><example><title><code>&lt;master-location&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;TAN Transkription, Ringelreihen mit Riederfallen&lt;/name&gt;
      &lt;master-location href="http://beispiel.com/TAN-T/ringel.xml"/&gt;
      &lt;rights-excluding-sources rights-holder="schmidt"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.deu.1897.xml">ring-o-roses.deu.1897</link></para></note></para><para><example><title><code>&lt;master-location&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;TAN transcription of Ring a Ring o' Roses&lt;/name&gt;
      &lt;master-location href="ring-o-roses.eng.1881.xml"/&gt;
      &lt;rights-excluding-sources which="by-nc-nd_2.0" rights-holder="park"/&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1881.xml">ring-o-roses.eng.1881</link></para></note></para><para><example><title><code>&lt;master-location&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;TAN transcription of 1790 version of Ring around the Rosie reported by Newell in
      1883&lt;/name&gt;
      &lt;master-location href="ring-o-roses.eng.1957.xml"/&gt;
      &lt;rights-excluding-sources rights-holder="park"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1957.xml">ring-o-roses.eng.1957</link></para></note></para></section><section xml:id="element-name"><title><code>&lt;name&gt;</code></title><para>The element <code>name</code> provides a human-readable name of a concept, person, or thing referred to by the parent element (or the current document, if the parent element is <code><link linkend="element-head">&lt;head&gt;</link></code>)</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-metadata-desc">~metadata-desc</link></code></synopsis><caution><para>All text must be normalized (Unicode NFC).</para></caution><caution><para>Names may not duplicate reserved TAN keywords for the affected element.</para></caution><caution><para>Names may not be duplicates of, case-variants of, or hyphen variants of other names for the same element.</para></caution><para><example><title><code>&lt;name&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/007901738/catalog&lt;/IRI&gt;
         &lt;name&gt;Aristotle: Categoriae &amp; De interpretatione by E.M. Edghill. Analytica priora / by
            A.J. Jenkinson. Analytica posteriora / by G.R.G. Mure. Oxford : Clarendon Press, 1926.
         &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         .........
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         &lt;location href="ar.cat.eng.1926.edghill.sem.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="element-relationship"><title><code>&lt;relationship&gt;</code></title><para>The element <code>relationship</code> specifies the role that the item named by the parent <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> played. This may be either a reserved keyword or an IRI + name pattern that identifies a specific kind of relationship.</para><para>See main.xml# keywords-relationship f or standardized vocabulary.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
   
      ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))</synopsis><para>Used by: <code><link linkend="pattern-see-also-item">~see-also-item</link></code></para><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target TAN file must point to a file whose root element is a TAN file.</para></caution><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target TAN-c file must point to a TAN file whose root element is <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code>.</para></caution><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target copy must point to a TAN file whose root element is identical.</para></caution><caution><para><code><link linkend="element-see-also">&lt;see-also&gt;</link></code> may have the <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> of a different work version only if both are class 1 files and both share the same work.</para></caution><caution><para>In class 1 files, alternative editions must share the same source.</para></caution><caution><para>In class 1 files, alternative editions must share the same work.</para></caution><caution><para>In class 1 files, alternative editions must share the same work-version, if supplied.</para></caution><caution><para>In class 1 files, resegmented copies must have identical transcriptions, after TAN normalization.</para></caution><caution><para>A class 1 file and its model must have the same work.</para></caution><caution><para>A class 1 file may have no more than one model.</para></caution><important><para>If a class 1 file diverges from the structure of its model a warning will be generated specifying where differences exist.</para></important><para><example><title><code>&lt;relationship&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="alternatively divided edition"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;relationship&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="different work version"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="element-rights-excluding-sources"><title><code>&lt;rights-excluding-sources&gt;</code></title><para>The element <code>rights-excluding-sources</code> states the license under which the data is distributed and the rights associated with it, EXCLUSIVE of any rights attached to the source.</para><para>Diligently check to ensure that the license you have claimed respects the rights of your sources' rightsholders. It is recommended that you license your data under a license that is similar to or more liberal than the one under which your sources have been released.</para><para>For more discussion, see <xref linkend="license"/> and for a list of standard vocabulary, main.xml# keywords-rights-excluding-sources</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-rights-holder">@rights-holder</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para><para><example><title><code>&lt;rights-excluding-sources&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;rights-excluding-sources&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;rights-excluding-sources&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, French translation by J. Barthélemy Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;rights-excluding-sources&gt;</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Realignment of Categories, Aristotle, French translation by J. Barthélemy
         Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-rights-source-only"><title><code>&lt;rights-source-only&gt;</code></title><para>The element <code>rights-source-only</code> states license and rights that are attached to the source of the data.</para><para>For more discussion, see <xref linkend="license"/> and for a list of vocabulary, main.xml# keywords-rights-excluding-sources</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="attribute-rights-holder">@rights-holder</link></code>*, 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-source-item">~source-item</link></code></para></section><section xml:id="element-role"><title><code>&lt;role&gt;</code></title><para>The element <code>role</code> specifies a role (responsibility, task, or activity) that one or more <code><link linkend="element-agent">&lt;agent&gt;</link></code>s did in creating or editing the data.</para><para>A role may be any activity, e.g., editor, funder, supervisor, data-processor, peer reviewer, patron, defined through the enclosed IRI + name pattern.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-xmlid">@xml:id</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para><para><example><title><code>&lt;role&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         &lt;IRI&gt;http://schema.org/editor&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Editor&lt;/name&gt;
      &lt;/role&gt;
      &lt;change when="2016-07-07T16:36:28.867-04:00" who="kalvesmaki"&gt;Reformatted file at
         ar.cat.eng.1926.edghill.sem.xml to the structure of the copy of the model.&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;role&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         &lt;IRI&gt;http://schema.org/editor&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Editor&lt;/name&gt;
      &lt;/role&gt;
      &lt;change when="2016-06-22T08:04:25.003-04:00" who="kalvesmaki"&gt;Reformatted according to first
         model found. Backup made at
         file:/C:/Users/jdkalv/Dropbox/TAN/library/TAN-1-dev/examples/ar.cat.eng.1926.edghill.sem-201606220804250030400.xml.&lt;/change&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;role&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         &lt;IRI&gt;http://schema.org/editor&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Editor&lt;/name&gt;
      &lt;/role&gt;
      &lt;change when="2016-07-10" who="kalvesmaki"&gt;Began new file&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;role&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         &lt;IRI&gt;http://schema.org/editor&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Editor&lt;/name&gt;
      &lt;/role&gt;
      &lt;change when="2016-07-10" who="kalvesmaki"&gt;Began new file&lt;/change&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-see-also"><title><code>&lt;see-also&gt;</code></title><para>The element <code>see-also</code> identifies auxiliary entities that were materially helpful in creating or editing the data, or are helpful in understanding the data.</para><para>This element is especially useful for crediting third parties who provided a set of raw data that served as a starting point, or was consulted. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         (<code><link linkend="element-relationship">&lt;relationship&gt;</link></code>, (
            
               ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>) | 
            
               ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+) | <code><link linkend="attribute-which">@which</link></code>) | 
            
               (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+))))))</synopsis><para>Used by: <code><link linkend="pattern-see-also-list">~see-also-list</link></code></para><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target TAN file must point to a file whose root element is a TAN file.</para></caution><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target TAN-c file must point to a TAN file whose root element is <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code>.</para></caution><caution><para>Any <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> whose <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> is defined as requiring a target copy must point to a TAN file whose root element is identical.</para></caution><caution><para><code><link linkend="element-see-also">&lt;see-also&gt;</link></code> may have the <code><link linkend="element-relationship">&lt;relationship&gt;</link></code> of a different work version only if both are class 1 files and both share the same work.</para></caution><caution><para>In class 1 files, alternative editions must share the same source.</para></caution><caution><para>In class 1 files, alternative editions must share the same work.</para></caution><caution><para>In class 1 files, alternative editions must share the same work-version, if supplied.</para></caution><caution><para>In class 1 files, resegmented copies must have identical transcriptions, after TAN normalization.</para></caution><caution><para>A class 1 file and its model must have the same work.</para></caution><caution><para>A class 1 file may have no more than one model.</para></caution><important><para>If a class 1 file diverges from the structure of its model a warning will be generated specifying where differences exist.</para></important><caution><para>Every element with a <code><link linkend="element-location">&lt;location&gt;</link></code> should have at least one document available.</para></caution><caution><para>Every TAN file referred to by way of an element containing <code><link linkend="element-location">&lt;location&gt;</link></code> should have an <code><link linkend="attribute-id">@id</link></code> that matches the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> of the parent of the <code><link linkend="element-location">&lt;location&gt;</link></code></para></caution><caution><para>No element may point to a TAN file that has an identical <code><link linkend="attribute-id">@id</link></code> value; the only exception is a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> pointing to an older or new version.</para></caution><important><para>If <code><link linkend="attribute-when-accessed">@when-accessed</link></code> predates one or more dates in a target file, a warning will be returned.</para></important><important><para>If a target file does not explicitly give the <code><link linkend="element-body">&lt;body&gt;</link></code>'s <code><link linkend="attribute-in-progress">@in-progress</link></code> the value of <code>true(</code>) a warning will be returned. <quote>Target file is marked as being in progress.</quote></para></important><important><para>If a target file has a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> marked as a new version (update) a warning will be returned.</para></important><para><example><title><code>&lt;see-also&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;source&gt;
         .........
      &lt;/source&gt;
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="alternatively divided edition"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;see-also&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;source&gt;
         .........
      &lt;/source&gt;
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="different work version"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="element-source"><title><code>&lt;source&gt;</code></title><para>The element <code>source</code> identifies the source upon which the data in the <code><link linkend="element-body">&lt;body&gt;</link></code> of the current file depends.</para><para>TAN-T and TAN-LM allow only one <code><link linkend="element-source">&lt;source&gt;</link></code>. TAN-A-tok allows exactly two. All other TAN formats require one or more. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (
{[TAN-A-div (<code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-A-tok (<code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-class-3 (<code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>?} OR 

{[TAN-core (<code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>):]   {empty}}, 
         (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
            ((
               
                  ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>) | 
               
                  ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+) | <code><link linkend="attribute-which">@which</link></code>) | 
               
                  (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+))), 
{[TAN-class-2 (<code><link linkend="pattern-source-rights">~source-rights</link></code>):]   {empty}} OR 

{[TAN-core (<code><link linkend="pattern-source-rights">~source-rights</link></code>):]   <code><link linkend="element-rights-source-only">&lt;rights-source-only&gt;</link></code>}?))))</synopsis><para>Used by: <code><link linkend="pattern-source-list">~source-list</link></code></para><caution><para>Every element with a <code><link linkend="element-location">&lt;location&gt;</link></code> should have at least one document available.</para></caution><caution><para>Every TAN file referred to by way of an element containing <code><link linkend="element-location">&lt;location&gt;</link></code> should have an <code><link linkend="attribute-id">@id</link></code> that matches the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> of the parent of the <code><link linkend="element-location">&lt;location&gt;</link></code></para></caution><caution><para>No element may point to a TAN file that has an identical <code><link linkend="attribute-id">@id</link></code> value; the only exception is a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> pointing to an older or new version.</para></caution><important><para>If <code><link linkend="attribute-when-accessed">@when-accessed</link></code> predates one or more dates in a target file, a warning will be returned.</para></important><important><para>If a target file does not explicitly give the <code><link linkend="element-body">&lt;body&gt;</link></code>'s <code><link linkend="attribute-in-progress">@in-progress</link></code> the value of <code>true(</code>) a warning will be returned. <quote>Target file is marked as being in progress.</quote></para></important><important><para>If a target file has a <code><link linkend="element-see-also">&lt;see-also&gt;</link></code> marked as a new version (update) a warning will be returned.</para></important><caution><para>Sources are integral parts of a class 2 TAN file. Access to at least one copy is absolutely mandatory.</para></caution><para><example><title><code>&lt;source&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/007901738/catalog&lt;/IRI&gt;
         &lt;name&gt;Aristotle: Categoriae &amp; De interpretatione by E.M. Edghill. Analytica priora / by
            A.J. Jenkinson. Analytica posteriora / by G.R.G. Mure. Oxford : Clarendon Press, 1926.
         &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;source&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/007901738/catalog&lt;/IRI&gt;
         &lt;name&gt;Aristotle: Categoriae &amp; De interpretatione by E.M. Edghill. Analytica priora / by
            A.J. Jenkinson. Analytica posteriora / by G.R.G. Mure. Oxford : Clarendon Press, 1926.
         &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;source&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/002773288/catalog&lt;/IRI&gt;
         &lt;name&gt;Logique d'Aristote: Traduite en français pour la première fois et accompagnée de
            notes perpétuelles par J. Barthélemy Saint-Hilaire. Paris : Ladrange, 1839-1844. &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;source&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         .........
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         &lt;IRI&gt;http://id.lib.harvard.edu/aleph/002773288/catalog&lt;/IRI&gt;
         &lt;name&gt;Logique d'Aristote: Traduite en français pour la première fois et accompagnée de
            notes perpétuelles par J. Barthélemy Saint-Hilaire. Paris : Ladrange, 1839-1844. &lt;/name&gt;
      &lt;/source&gt;
      &lt;see-also&gt;
         .........
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-tail"><title><code>&lt;tail&gt;</code></title><para>The element <code>tail</code> permits any arbitrary content. This element is suitable as a placeholder for temporary data, especially to facilitate time-consuming validation routines. </para><para>Formal Definition</para><synopsis>
   (&lt;[ANY]&gt;* &amp; text)</synopsis></section><section xml:id="element-token-definition"><title><code>&lt;token-definition&gt;</code></title><para>The element <code>token-definition</code> takes a regular expression to define a word token. This element will be used to segment a string into token and non-token components. </para><para>This element takes attributes that function as the parameters for the function xsl:analyze-string (see <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.w3.org/TR/xslt-30/#element-analyze-string).">https://www.w3.org/TR/xslt-30/#element-analyze-string).</link></para><para>For more see <xref linkend="defining_tokens"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, 
         (<code><link linkend="attribute-which">@which</link></code> | (<code><link linkend="attribute-regex">@regex</link></code>, <code><link linkend="attribute-flags">@flags</link></code>?))))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code>, <code><link linkend="pattern-entity-tok-def">~entity-tok-def</link></code></para><caution><para>No source may be given more than one token definition.</para></caution><para><example><title><code>&lt;token-definition&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following token definition
                treats the following as words: sequences of letters, any individual character 
                that is neither a letter nor a space (i.e., punctuation).&lt;/comment&gt;
         &lt;token-definition src="eng-us" regex="[-\w]+"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            .........
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>&lt;token-definition&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;reuse-type xml:id="adaptation"&gt;
            .........
         &lt;/reuse-type&gt;
         &lt;token-definition src="ring1881 ring1987" which="letters"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>&lt;token-definition&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following is equivalent to @which = 'letters'&lt;/comment&gt;
         &lt;token-definition src="eng ger" regex="\w+"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>&lt;token-definition&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;reuse-type xml:id="correlationGeneral"&gt;
            .........
         &lt;/reuse-type&gt;
         &lt;token-definition src="eng ger" which="letters and punctuation"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            .........
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="element-value"><title><code>&lt;value&gt;</code></title><para>The element <code>value</code> states the value of a <code><link linkend="element-checksum">&lt;checksum&gt;</link></code></para><para>Formal Definition</para><synopsis>string </synopsis><para>Used by: <code><link linkend="element-checksum">&lt;checksum&gt;</link></code></para><para><example><title><code>&lt;value&gt;</code></title><programlisting>         &lt;checksum&gt;
            .........
            &lt;name&gt;SHA-1&lt;/name&gt;
            &lt;value&gt;91D95564ABDF2B2C1B9EEF016CBA51E8179646CC&lt;/value&gt;
         &lt;/checksum&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/patricius.confessio.2003.eng.xml">patricius.confessio.2003.eng</link></para></note></para></section><section xml:id="element-version"><title><code>&lt;version&gt;</code></title><para>The element <code>version</code> identifies the version of a work. Applicable to sources that contain multiple versions, e.g., original text and facing translations. Like <code><link linkend="element-work">&lt;work&gt;</link></code>, <code><link linkend="element-version">&lt;version&gt;</link></code> points to a conceptual entity, not a physical one.</para><para>In the context of a class 1 file, the entity identified by <code><link linkend="element-version">&lt;version&gt;</link></code> is assumed to be a version of the entity defined in <code><link linkend="element-work">&lt;work&gt;</link></code>. In TAN-c files, however, no relationship is assumed between <code><link linkend="element-version">&lt;version&gt;</link></code> and any putative work, unless explicitly stated in that file. </para><para>Very few work-versions have their own URN names. It is advisable to assign a tag URN or a UUID. If you have used an IRI for <code><link linkend="element-work">&lt;work&gt;</link></code> that you are entitled to modify, you may wish to add a suffix that will name the version. If you need to specify exactly where on a text-bearing object a version appears, <code><link linkend="element-desc">&lt;desc&gt;</link></code> or <code><link linkend="element-comment">&lt;comment&gt;</link></code> should be used.</para><para>For more, see <xref linkend="conceptual_works"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para><para><example><title><code>&lt;version&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;version&gt;
            &lt;IRI&gt;urn:uuid:31648039-3dbb-49b9-b66e-9bd2cd11630e&lt;/IRI&gt;
            &lt;name&gt;zweite Version&lt;/name&gt;
         &lt;/version&gt;
         &lt;div-type xml:id="Zeile"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.deu.1897.xml">ring-o-roses.deu.1897</link></para></note></para></section><section xml:id="element-when"><title><code>&lt;when&gt;</code></title><para>The element <code>when</code> constrains an event to a period of time.</para><para>Multiple values of <code><link linkend="element-when">&lt;when&gt;</link></code> are interpreted to mean "or" with union. No distribution takes place (e.g., x &lt;when/&gt; with y &lt;when/&gt; means "at time x or y", not "at time x" and "at time y").</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-from">@from</link></code>, <code><link linkend="attribute-to">@to</link></code></synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code></para></section><section xml:id="element-work"><title><code>&lt;work&gt;</code></title><para>The element <code>work</code> indicates a creative work. The element identifies a conceptual entity, not a physical one.</para><para>The term "work" is only loosely defined in TAN. Any text that has enough unity to be referred to in ordinary conversation as a single entity may be identified as a work. A work may be composed of other works, be a part of other works, or even overlap with other works. E.g., the Lord's Prayer, the Gospel of Luke, the Tetravengelion, the New Testament, and the Bible are all valid works, despite the complex relationship between each of them.</para><para>This element takes the IRI + name pattern. For more, see <xref linkend="conceptual_works"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para><caution><para>A work element may invoke no more than one inclusion.</para></caution><para><example><title><code>&lt;work&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Categories_(Aristotle)&lt;/IRI&gt;
            &lt;name&gt;Aristotle, Categories&lt;/name&gt;
         &lt;/work&gt;
         &lt;div-type xml:id="p"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;work&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Categories_(Aristotle)&lt;/IRI&gt;
            &lt;name&gt;Aristotle, Categories&lt;/name&gt;
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;work&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Categories_(Aristotle)&lt;/IRI&gt;
            &lt;name xml:lang="fra"&gt;Aristote, Catégories&lt;/name&gt;
            &lt;name xml:lang="eng"&gt;Aristotle, Categories&lt;/name&gt;
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;work&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Categories_(Aristotle)&lt;/IRI&gt;
            &lt;name&gt;Aristotle, Categories&lt;/name&gt;
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="attribute-affects-element"><title><code>@affects-element</code></title><para>The attribute <code>affects-element</code> names one or more TAN elements that the keywords apply to</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-group-attributes">~group-attributes</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code></para><caution><para><code><link linkend="attribute-affects-element">@affects-element</link></code> must include only names of TAN elements that accept <code><link linkend="attribute-which">@which</link></code></para></caution><para><example><title><code>@affects-element</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-key:ar.cat"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="true" affects-element="work"&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;group&gt;
         .........
      &lt;/group&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-key/ar.cat.TAN-key.xml">ar.cat.TAN-key</link></para></note></para><para><example><title><code>@affects-element</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:bitext-relation"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="true" affects-element="bitext-relation"&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/bitext-relations.TAN-key.xml">bitext-relations.TAN-key</link></para></note></para><para><example><title><code>@affects-element</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:div-types"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="false" affects-element="div-type"&gt;
      &lt;item group="line-start line-end leading-start leading-end"&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/div-types.TAN-key.xml">div-types.TAN-key</link></para></note></para><para><example><title><code>@affects-element</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:features"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="false" affects-element="feature"&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/features.TAN-key.xml">features.TAN-key</link></para></note></para></section><section xml:id="attribute-cert"><title><code>@cert</code></title><para>The attribute <code>cert</code> states how certain an agent is of the data governed by the parent element, expressed as a real number from 0 (no certainty) to 1 (completely certainty).</para><para> This attribute is taken into account before all other attributes except <code>@claimant.</code> That is, <code><link linkend="attribute-cert">@cert</link></code> is to be interpreted to mean: "<code><link linkend="attribute-claimant">@claimant</link></code> has <code><link linkend="attribute-cert">@cert</link></code> confidence about the following data:...."</para><para>Values of <code><link linkend="attribute-cert">@cert</link></code> amplify. Any <code><link linkend="attribute-cert">@cert</link></code> will be multiplied against any other values of <code><link linkend="attribute-cert">@cert</link></code> in a given context. For example, if an <code><link linkend="element-l">&lt;l&gt;</link></code> and an <code><link linkend="element-m">&lt;m&gt;</link></code> in a TAN-LM file each have a certainty of 0.5, then the lexico-morphological combination of the two is 0.25. In a TAN-A-tok file, if an <code><link linkend="element-align">&lt;align&gt;</link></code> has a certainty of 0.6 and a child <code><link linkend="element-tok">&lt;tok&gt;</link></code> has a certainty of 0.3, then that <code><link linkend="element-tok">&lt;tok&gt;</link></code>'s actual certainty is 0.18.</para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis>double (pattern 1|0|(0\.\d*[1-9]))</synopsis><para>Used by: <code><link linkend="pattern-cert-claim">~cert-claim</link></code></para><para><example><title><code>@cert</code></title><programlisting>   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      .........
      &lt;align&gt;
         &lt;tok src="eng" ref="1" pos="5" cert="0.3"/&gt;
         &lt;tok src="ger" ref="1" pos="3" cert="0.3"/&gt;
      &lt;/align&gt;
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>@cert</code></title><programlisting>   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      .........
      &lt;align&gt;
         &lt;tok src="eng" ref="1" pos="5" cert="0.3"/&gt;
         &lt;tok src="ger" ref="1" pos="3" cert="0.3"/&gt;
      &lt;/align&gt;
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="attribute-cert2"><title><code>@cert2</code></title><para>The attribute <code>cert2</code> provides a second measure of certainty. The value is taken along with <code><link linkend="attribute-cert">@cert</link></code> as the range in which an editors certainty resides. </para><para>Formal Definition</para><synopsis>double (pattern 1|0|(0\.\d*[1-9]))</synopsis><para>Used by: <code><link linkend="pattern-cert-claim">~cert-claim</link></code></para></section><section xml:id="attribute-ed-when"><title><code>@ed-when</code></title><para>The attribute <code>ed-when</code> marks the date or time when an element or its content was edited (added or modified)</para><para>The value of must always conform to an ISO date or dateTime pattern. See <xref linkend="date_and_datetime"/>.</para><para>Along with <code><link linkend="attribute-ed-who">@ed-who</link></code>, this forms the Edit Stamp pattern. See <xref linkend="edit_stamp"/></para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis>(
   dateTime 
   date )</synopsis><para>Used by: <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code></para><caution><para>Date attributes must be castable either as xs:dateTime or xs:date</para></caution><caution><para>Future dates are not permitted.</para></caution><para><example><title><code>@ed-when</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;source&gt;
         .........
      &lt;/source&gt;
      &lt;declarations ed-who="park" ed-when="2015-10-31"&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="l"&gt;
            .........
         &lt;/div-type&gt;
         &lt;filter&gt;
            .........
         &lt;/filter&gt;
      &lt;/declarations&gt;
      &lt;agent xml:id="park" roles="creator"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1987.xml">ring-o-roses.eng.1987</link></para></note></para><para><example><title><code>@ed-when</code></title><programlisting>      &lt;declarations&gt;
         &lt;morphology xml:id="penn" ed-when="2015-08-20-04:00" ed-who="park"&gt;
            &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-r-mor:eng:penn&lt;/IRI&gt;
            &lt;name&gt;Penn Treebank tag set&lt;/name&gt;
            &lt;location href="../TAN-mor/eng.kalvesmaki.com%2C2014.2.xml" when-accessed="2015-11-03-05:00"/&gt;
         &lt;/morphology&gt;
         &lt;lexicon xml:id="test"&gt;
            .........
         &lt;/lexicon&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para><para><example><title><code>@ed-when</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;comment when="2015-03-10" who="kalvesmaki"&gt;Codes developed as a synthesis of
         ftp://ftp.cis.upenn.edu/pub/treebank/doc/tagguide.ps.gz and
         http://www.comp.leeds.ac.uk/amalgam/tagsets/upenn.html&lt;/comment&gt;
      &lt;declarations ed-when="2015-03-03" ed-who="kalvesmaki"/&gt;
      &lt;agent xml:id="kalvesmaki" roles="editor"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-mor/eng.kalvesmaki.com,2014.2.xml">eng.kalvesmaki.com,2014.2</link></para></note></para></section><section xml:id="attribute-ed-who"><title><code>@ed-who</code></title><para>The attribute <code>ed-who</code> refers to one or more <code><link linkend="element-agent">&lt;agent&gt;</link></code>s who have edited (added or modified) an element or its content.</para><para>Along with <code><link linkend="attribute-ed-when">@ed-when</link></code>, this forms the Edit Stamp pattern. See <xref linkend="edit_stamp"/></para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@ed-who</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;source&gt;
         .........
      &lt;/source&gt;
      &lt;declarations ed-who="park" ed-when="2015-10-31"&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="l"&gt;
            .........
         &lt;/div-type&gt;
         &lt;filter&gt;
            .........
         &lt;/filter&gt;
      &lt;/declarations&gt;
      &lt;agent xml:id="park" roles="creator"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1987.xml">ring-o-roses.eng.1987</link></para></note></para><para><example><title><code>@ed-who</code></title><programlisting>      &lt;declarations&gt;
         &lt;morphology xml:id="penn" ed-when="2015-08-20-04:00" ed-who="park"&gt;
            &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-r-mor:eng:penn&lt;/IRI&gt;
            &lt;name&gt;Penn Treebank tag set&lt;/name&gt;
            &lt;location href="../TAN-mor/eng.kalvesmaki.com%2C2014.2.xml" when-accessed="2015-11-03-05:00"/&gt;
         &lt;/morphology&gt;
         &lt;lexicon xml:id="test"&gt;
            .........
         &lt;/lexicon&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para><para><example><title><code>@ed-who</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;comment when="2015-03-10" who="kalvesmaki"&gt;Codes developed as a synthesis of
         ftp://ftp.cis.upenn.edu/pub/treebank/doc/tagguide.ps.gz and
         http://www.comp.leeds.ac.uk/amalgam/tagsets/upenn.html&lt;/comment&gt;
      &lt;declarations ed-when="2015-03-03" ed-who="kalvesmaki"/&gt;
      &lt;agent xml:id="kalvesmaki" roles="editor"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-mor/eng.kalvesmaki.com,2014.2.xml">eng.kalvesmaki.com,2014.2</link></para></note></para></section><section xml:id="attribute-flags"><title><code>@flags</code></title><para>The attribute <code>flags</code> indicates the level of error that should be flagged to any algorithm that uses the parent element . Similar to Schematron's <code>@role</code>, but under a different name, to avoid confusion with TAN <code>@roles.</code></para><para>The attribute <code>flags</code> specifies flags to be applied in an XPath function that uses regular expressions.</para><para>s = dot-all mode; m = multi-line mode; i = case-insensitive mode; x = remove whitespace characters from regular expression; q = no metacharacters </para><para>For more see <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xpath-functions-30/#flags">http://www.w3.org/TR/xpath-functions-30/#flags</link></para><para>Formal Definition</para><synopsis>string (pattern warn(ing)?|error|info|fatal)string (pattern [smixq]+)</synopsis><para>Used by: <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code></para></section><section xml:id="attribute-from"><title><code>@from</code></title><para>The attribute <code>from</code> specifies the beginning of a period of time</para><para>Formal Definition</para><synopsis>(
   dateTime 
   date )</synopsis><para>Used by: <code><link linkend="element-when">&lt;when&gt;</link></code></para><caution><para>Date attributes must be castable either as xs:dateTime or xs:date</para></caution><caution><para>Future dates are not permitted.</para></caution><caution><para><code><link linkend="attribute-from">@from</link></code> must predate <code><link linkend="attribute-to">@to</link></code></para></caution></section><section xml:id="attribute-group"><title><code>@group</code></title><para>The attribute <code>group</code> identifies one or more <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>s under which the parent element, and its children, should be grouped.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-non-class-2-opt">~non-class-2-opt</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><para><example><title><code>@group</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:div-types"&gt;
   .........
   &lt;body in-progress="false" affects-element="div-type"&gt;
      &lt;item group="line-start line-end leading-start leading-end"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:div-type:abstract&lt;/IRI&gt;
         &lt;IRI&gt;http://www.tei-c.org/ns/1.0/abstract&lt;/IRI&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Abstract_(summary)&lt;/IRI&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item group="page-start page-end"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:div-type:afterword&lt;/IRI&gt;
         &lt;IRI&gt;http://dbpedia.org/page/Afterword&lt;/IRI&gt;
         &lt;name&gt;afterword&lt;/name&gt;
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
      &lt;item&gt;
         .........
      &lt;/item&gt;
      &lt;item group="line-start line-end leading-start leading-end"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:div-type:block_quote&lt;/IRI&gt;
         &lt;IRI&gt;http://www.w3.org/1999/xhtml/blockquote&lt;/IRI&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Block_quotation&lt;/IRI&gt;
         .........
      &lt;/item&gt;
      &lt;item group="page-start page-end"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:div-type:book&lt;/IRI&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Book&lt;/IRI&gt;
         &lt;name&gt;book&lt;/name&gt;
         .........
      &lt;/item&gt;
      &lt;item&gt;
         .........
      &lt;/item&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/div-types.TAN-key.xml">div-types.TAN-key</link></para></note></para></section><section xml:id="attribute-help"><title><code>@help</code></title><para>The attribute <code>help</code> requests help on the context element. This attribute is equivalent to the help requested string, ???, but is useful in cases where the string cannot be placed (e.g., elements with no content or few attributes)</para><para>Formal Definition</para><synopsis>{empty}</synopsis><para>Used by: <code><link linkend="pattern-inclusion">~inclusion</link></code></para></section><section xml:id="attribute-href"><title><code>@href</code></title><para>The attribute <code>href</code> points to the location of a file. In some contexts, this attribute is allowed only as a temporary measure, to invoke editing assistance by means of Schematron Quick Fixes.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-loc-self">~loc-self</link></code>, <code><link linkend="pattern-loc-src">~loc-src</link></code></para><caution><para><code><link linkend="attribute-href">@href</link></code> must have <code><link linkend="element-location">&lt;location&gt;</link></code> or <code><link linkend="element-master-location">&lt;master-location&gt;</link></code> as a parent; any other parent will trigger a quick fix to populate the element with the IRI + name pattern of the target file.</para></caution><important><para>If <code>fn:doc-available(</code>) for an <code><link linkend="attribute-href">@href</link></code> returns false, the following message will be returned. <quote><code><link linkend="attribute-href">@href</link></code> points to file that is either (1) not available, (2) not valid XML, or (3) at a server not trusted by the validation engine.</quote></para></important><caution><para>The only <code><link linkend="attribute-href">@href</link></code> in a TAN document that may point to the same document id that of <code><link linkend="element-master-location">&lt;master-location&gt;</link></code></para></caution><caution><para>No <code><link linkend="element-master-location">&lt;master-location&gt;</link></code> may have an <code><link linkend="attribute-href">@href</link></code> that points to a compressed archive.</para></caution><para><example><title><code>@href</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         &lt;location href="ar.cat.eng.1926.edghill.sem.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@href</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-sem.xml" when-accessed="2016-02-10T14:08:52.058-05:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-02-11T12:40:42.823-05:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="attribute-id"><title><code>@id</code></title><para>The attribute <code>id</code> contains a tag URN that permanently and uniquely names the current file, the so-called IRI Name of the current file. See <xref linkend="iri_name"/> for discussion.</para><para>For more on the syntax of tag URNs see <xref linkend="tag_urn"/></para><para>Formal Definition</para><synopsis>anyURI (pattern tag:([\-a-zA-Z0-9._%+]+@)?[\-a-zA-Z0-9.]+\.[A-Za-z]{2,4},\d{4}(-(0\d|1[0-2]))?(-([0-2]\d|3[01]))?:\S+)</synopsis><para>Used by: <code><link linkend="element-TAN-A-div">&lt;TAN-A-div&gt;</link></code>, <code><link linkend="element-TAN-A-tok">&lt;TAN-A-tok&gt;</link></code>, <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code>, <code><link linkend="element-TAN-key">&lt;TAN-key&gt;</link></code>, <code><link linkend="element-TAN-mor">&lt;TAN-mor&gt;</link></code>, <code><link linkend="element-TAN-T">&lt;TAN-T&gt;</link></code>, <code><link linkend="element-TAN-LM">&lt;TAN-LM&gt;</link></code></para><caution><para>Every TAN file must have a primary agent, the organization or person that takes the greatest responsibility for the content of the TAN file. The primary agent is defined as the first <code><link linkend="element-agent">&lt;agent&gt;</link></code> with an <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> that is a tag URI whose namespace matches the namespaces of <code><link linkend="attribute-id">@id</link></code> in the root element.</para></caution><para><example><title><code>@id</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@id</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@id</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>@id</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs-realigned"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="attribute-idrefs"><title><code>@idrefs</code></title><para>The attribute <code>idrefs</code> contains references to one or more values of xml:id in the file </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-decl-alias">~decl-alias</link></code></para><caution><para>A <code><link linkend="element-alias">&lt;alias&gt;</link></code> may not mix idrefs from different elements.</para></caution><caution><para><code><link linkend="element-alias">&lt;alias&gt;</link></code> references must not be circular.</para></caution><para><example><title><code>@idrefs</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;work xml:id="αc" which="Explanationes de commentario graeco Ammonii"/&gt;
         &lt;alias xml:id="αd" idrefs="α αc"/&gt;
         &lt;work xml:id="φ" which="Lemmata de commentario graeco Ioannis Philoponi"/&gt;
         &lt;work xml:id="φc" which="Explanationes de commentario graeco Ioannis Philoponi"/&gt;
         &lt;alias xml:id="φd" idrefs="φ φc"/&gt;
         &lt;work xml:id="ο" which="Lemmata de commentario graeco Olympiodori"/&gt;
         &lt;work xml:id="οc" which="Explanationes de commentario graeco Olympiodori"/&gt;
         &lt;alias xml:id="οd" idrefs="ο οc"/&gt;
         &lt;work xml:id="η" which="Lemmata de commentario graeco Eliae"/&gt;
         &lt;work xml:id="ηc" which="Explanationes de commentario graeco Eliae"/&gt;
         &lt;alias xml:id="ηd" idrefs="η ηc"/&gt;
         &lt;work xml:id="σ" which="Lemmata de commentario graeco Simplicii"/&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-in-progress"><title><code>@in-progress</code></title><para>The attribute <code>in-progress</code> specifies whether or not the editors of the current file have not yet finished supplying the data, intend to make important changes, or otherwise wish to reserve the right to make major changes. </para><para>This attribute does not claim that the data is perfect or that it will not be changed. Rather, it signals to users, especially those who would use the file the object of a <code><link linkend="element-source">&lt;source&gt;</link></code>, <code><link linkend="element-see-also">&lt;see-also&gt;</link></code>, or <code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code>, the possibility of major work that may render dependent data as wrong or invalid. </para><para>Formal Definition</para><synopsis>boolean </synopsis><para>Used by: <code><link linkend="pattern-TAN-body">~TAN-body</link></code></para><important><para>Any TAN file marked as being no longer in progress should have at least one master-location.</para></important><para><example><title><code>@in-progress</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:hans@beispiel.com,2014:ringel"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="deu" in-progress="false"&gt;
      &lt;div type="Zeile" n="a"&gt;Ringel, Ringel, Reihe!&lt;/div&gt;
      &lt;div type="Zeile" n="b"&gt;Sind der Kinder dreie,&lt;/div&gt;
      &lt;div type="Zeile" n="c"&gt;Sitzen auf dem Holderbuch,&lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.deu.1897.xml">ring-o-roses.deu.1897</link></para></note></para><para><example><title><code>@in-progress</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng" in-progress="false"&gt;
      &lt;div type="line" n="1"&gt;Ring-a-ring-a-roses,&lt;/div&gt;
      &lt;div type="line" n="2"&gt;A pocket full of posies;&lt;/div&gt;
      &lt;div type="line" n="3"&gt;Hush! Hush! Hush! Hush!&lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1881.xml">ring-o-roses.eng.1881</link></para></note></para><para><example><title><code>@in-progress</code></title><programlisting>   &lt;text&gt;
      &lt;body xml:lang="eng" in-progress="false"&gt;
         &lt;div type="poem" n="poem" part="N" org="uniform" sample="complete"&gt;
            .........
         &lt;/div&gt;
      &lt;/body&gt;
   &lt;/text&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1957.xml">ring-o-roses.eng.1957</link></para></note></para><para><example><title><code>@in-progress</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring02"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng" in-progress="false"&gt;
      &lt;div type="l" n="1"&gt;Ring-a-round the rosie,&lt;/div&gt;
      &lt;div type="l" n="2"&gt;A pocket full of posies,&lt;/div&gt;
      &lt;div type="l" n="3"&gt;Ashes! Ashes!&lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ring-o-roses.eng.1987.xml">ring-o-roses.eng.1987</link></para></note></para></section><section xml:id="attribute-include"><title><code>@include</code></title><para>The attribute <code>include</code> signals that the parent element is to be replaced by all elements of the same name found in the referred <code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code>.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-inclusion">~inclusion</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><caution><para>Inclusions may not introduce duplicate values of <code>@xml:id.</code></para></caution><caution><para>For any element with <code><link linkend="attribute-include">@include</link></code>, at least one element of the same name must be found in target inclusion document.</para></caution><caution><para>Inclusions may not be circular.</para></caution><caution><para>Inclusions are integral parts of any TAN file. Access to at least one copy is absolutely mandatory.</para></caution><caution><para>Every inclusion should have at least one document available.</para></caution><caution><para>A work element may invoke no more than one inclusion.</para></caution><caution><para>Every <code><link linkend="element-feature">&lt;feature&gt;</link></code> inclusion must support every language that has  been declared.</para></caution><para><example><title><code>@include</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent include="rel"/&gt;
      &lt;agent xml:id="stylesheet" roles="editor"&gt;
         .........
      &lt;/agent&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="attribute-n"><title><code>@n</code></title><para>The attribute <code>n</code> names a <code><link linkend="element-div">&lt;div&gt;</link></code> or <code><link linkend="element-group">&lt;group&gt;</link></code>. </para><para>In a <code><link linkend="element-div">&lt;div&gt;</link></code> of a class 1 file, the space-delimited concatenation of values of <code><link linkend="attribute-n">@n</link></code> from the rootmost ancestor becomes the reference for a <code><link linkend="element-div">&lt;div&gt;</link></code>.</para><para>Special use may be made of the tilde (~), as a kind of surrogate hyphen (which is disallowed), to indicate an <code><link linkend="attribute-n">@n</link></code> that corresponds to a range of values, e.g., n="7~8" for a <code><link linkend="element-div">&lt;div&gt;</link></code> that has text that mixes text from 7 and 8.</para><para>Formal Definition</para><synopsis>string (pattern (\w+|\d+-\d+)(\s+(\w+|\d+-\d+))*)</synopsis><para>Used by: <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-group-attributes">~group-attributes</link></code></para><caution><para>No single set of references may mix Roman numerals, alphabetic numerals, and numerals that are ambiguously either.</para></caution><caution><para>Leaf div references must be unique.</para></caution><caution><para><code><link linkend="attribute-n">@n</link></code>'s taking digit values should not begin with 0.</para></caution><important><para><code><link linkend="attribute-n">@n</link></code> suffices for labeling text in a <code><link linkend="element-div">&lt;div&gt;</link></code>; the <code><link linkend="attribute-n">@n</link></code>'s value should not appear in the text.</para></important><important><para>concatenated <code><link linkend="attribute-n">@n</link></code>'s suffice for labeling text in a <code><link linkend="element-div">&lt;div&gt;</link></code>; the <code><link linkend="element-div">&lt;div&gt;</link></code>'s reference should not appear in the text.</para></important><caution><para>To avoid ambiguous numerals, no div type should mix Roman and alphabet numerals.</para></caution><para><example><title><code>@n</code></title><programlisting>   &lt;body xml:lang="eng"&gt;
      &lt;div type="p" n="1"&gt;
         &lt;div type="c" n="a"&gt;
            &lt;div type="l" n="1"&gt;Things are said to be named 'equivocally' when, though they have a common name, the definition corresponding&lt;/div&gt;
            &lt;div type="l" n="2"&gt;with the name differs for each. Thus, a real man and a figure in a picture can both&lt;/div&gt;
            &lt;div type="l" n="3"&gt;lay claim to the name 'animal'; yet these are equivocally so named, for, though they have&lt;/div&gt;
            .........
         &lt;/div&gt;
         &lt;div type="c" n="b"&gt;
            .........
         &lt;/div&gt;
      &lt;/div&gt;
      &lt;div type="p" n="2"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="attribute-regex"><title><code>@regex</code></title><para>The attribute <code>regex</code> specifies a regular expression pattern to be searched for or matched. TAN regular expressions include an extended syntax, most noted by the special escape character \k{}. </para><para>For more see <xref linkend="regular_expressions"/> and <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.w3.org/TR/xpath-functions-30/#regex-syntax">https://www.w3.org/TR/xpath-functions-30/#regex-syntax</link></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code></para><caution><para>Attributes that take a regular expression must use escape sequences recognized by XML schema or TAN escape extensions (\k{}). See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xmlschema-2/#regexs">http://www.w3.org/TR/xmlschema-2/#regexs</link> for details.</para></caution><para><example><title><code>@regex</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following token definition
                treats the following as words: sequences of letters, any individual character 
                that is neither a letter nor a space (i.e., punctuation).&lt;/comment&gt;
         &lt;token-definition src="eng-us" regex="[-\w]+"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            .........
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>@regex</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following is equivalent to @which = 'letters'&lt;/comment&gt;
         &lt;token-definition src="eng ger" regex="\w+"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>@regex</code></title><programlisting>      &lt;declarations&gt;
         &lt;token-definition regex="[\w­​‍]+"/&gt;
         &lt;lexicon xml:id="LSJ"&gt;
            .........
         &lt;/lexicon&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>@regex</code></title><programlisting>      &lt;item&gt;
         &lt;token-definition regex="[\w­​‍]+"/&gt;
         &lt;name&gt;letters&lt;/name&gt;
         .........
      &lt;/item&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/token-definitions.TAN-key.xml">token-definitions.TAN-key</link></para></note></para></section><section xml:id="attribute-rights-holder"><title><code>@rights-holder</code></title><para>The attribute <code>rights-holder</code> specifies one or more <code><link linkend="element-agent">&lt;agent&gt;</link></code>s who hold the rights over the material specified by the parent element (either the data of the current file, or of the source that forms the basis for the data).</para><para>Nothing should be inferred from a missing <code><link linkend="attribute-rights-holder">@rights-holder</link></code> from <code><link linkend="element-rights-source-only">&lt;rights-source-only&gt;</link></code>. Its absence does not mean that the rightsholder is unknown or nonexistent. For more, see <xref linkend="license"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code></para><para><example><title><code>@rights-holder</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@rights-holder</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@rights-holder</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Categories, Aristotle, French translation by J. Barthélemy Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>@rights-holder</code></title><programlisting>   &lt;head&gt;
      &lt;name&gt;Realignment of Categories, Aristotle, French translation by J. Barthélemy
         Saint-Hilaire&lt;/name&gt;
      &lt;rights-excluding-sources rights-holder="kalvesmaki"&gt;
         &lt;IRI&gt;http://creativecommons.org/licenses/by/4.0/deed.en_US&lt;/IRI&gt;
         &lt;name&gt;Creative Commons Attribution 4.0 International License&lt;/name&gt;
         &lt;desc&gt;Exclusive of rights held and licenses offered by rightsholders of the source or
            sources listed below, this data file, insofar as it constitutes an independent work, is
            licensed under a Creative Commons Attribution 4.0 International License.&lt;/desc&gt;
      &lt;/rights-excluding-sources&gt;
      &lt;source&gt;
         .........
      &lt;/source&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="attribute-roles"><title><code>@roles</code></title><para>The attribute <code>roles</code> refers to the ID of one or more <code><link linkend="element-role">&lt;role&gt;</link></code>s</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@roles</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@roles</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@roles</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>@roles</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="attribute-TAN-version"><title><code>@TAN-version</code></title><para>The attribute <code>TAN-version</code> specifies the version of TAN schemas used. </para><para>Formal Definition</para><synopsis>string </synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para><para><example><title><code>@TAN-version</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@TAN-version</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@TAN-version</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>@TAN-version</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs-realigned"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="attribute-to"><title><code>@to</code></title><para>The attribute <code>to</code> specifies the end of a period of time</para><para>Formal Definition</para><synopsis>(
   dateTime 
   date )</synopsis><para>Used by: <code><link linkend="element-when">&lt;when&gt;</link></code></para><caution><para>Date attributes must be castable either as xs:dateTime or xs:date</para></caution><caution><para>Future dates are not permitted.</para></caution><caution><para><code><link linkend="attribute-from">@from</link></code> must predate <code><link linkend="attribute-to">@to</link></code></para></caution></section><section xml:id="attribute-type"><title><code>@type</code></title><para>The attribute <code>type</code> indicates what type of its parent element. In the context of <code><link linkend="element-div">&lt;div&gt;</link></code> it specifies a type of textual unit, defined by a <code><link linkend="element-div-type">&lt;div-type&gt;</link></code>. In the context of <code><link linkend="element-group">&lt;group&gt;</link></code> it specifies a kind of group defined by a <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-group-attributes">~group-attributes</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code></para><para><example><title><code>@type</code></title><programlisting>   &lt;body xml:lang="eng"&gt;
      &lt;div type="p" n="1"&gt;
         &lt;div type="c" n="a"&gt;
            &lt;div type="l" n="1"&gt;Things are said to be named 'equivocally' when, though they have a common name, the definition corresponding&lt;/div&gt;
            &lt;div type="l" n="2"&gt;with the name differs for each. Thus, a real man and a figure in a picture can both&lt;/div&gt;
            &lt;div type="l" n="3"&gt;lay claim to the name 'animal'; yet these are equivocally so named, for, though they have&lt;/div&gt;
            .........
         &lt;/div&gt;
         &lt;div type="c" n="b"&gt;
            .........
         &lt;/div&gt;
      &lt;/div&gt;
      &lt;div type="p" n="2"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="attribute-when"><title><code>@when</code></title><para>The attribute <code>when</code> indicates a date or date and time</para><para>Formal Definition</para><synopsis>(
   dateTime 
   date )</synopsis><para>Used by: <code><link linkend="pattern-comment">~comment</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code></para><caution><para>Date attributes must be castable either as xs:dateTime or xs:date</para></caution><caution><para>Future dates are not permitted.</para></caution><para><example><title><code>@when</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-07T16:36:28.867-04:00" who="kalvesmaki"&gt;Reformatted file at
         ar.cat.eng.1926.edghill.sem.xml to the structure of the copy of the model.&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@when</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-06-22T08:04:25.003-04:00" who="kalvesmaki"&gt;Reformatted according to first
         model found. Backup made at
         file:/C:/Users/jdkalv/Dropbox/TAN/library/TAN-1-dev/examples/ar.cat.eng.1926.edghill.sem-201606220804250030400.xml.&lt;/change&gt;
      &lt;change when="2016-01-26-04:00" who="kalvesmaki"&gt;Started new file.&lt;/change&gt;
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@when</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-10" who="kalvesmaki"&gt;Began new file&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para></section><section xml:id="attribute-when-accessed"><title><code>@when-accessed</code></title><para>The attribute <code>when-accessed</code> specifies when an electronic file was last examined</para><para>Formal Definition</para><synopsis>(
   date 
   dateTime )</synopsis><para>Used by: <code><link linkend="element-location">&lt;location&gt;</link></code></para><caution><para>Date attributes must be castable either as xs:dateTime or xs:date</para></caution><caution><para>Future dates are not permitted.</para></caution><para><example><title><code>@when-accessed</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, English translation by E. M. Edghill&lt;/name&gt;
         &lt;location href="ar.cat.eng.1926.edghill.sem.xml" when-accessed="2016-07-07T16:36:28.867-04:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@when-accessed</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-sem.xml" when-accessed="2016-02-10T14:08:52.058-05:00"/&gt;
      &lt;/see-also&gt;
      &lt;see-also&gt;
         .........
         &lt;name&gt;Categories, Aristotle, Greek text by Minio-Paluello&lt;/name&gt;
         &lt;location href="ar.cat.grc.1949.minio-paluello-obj.xml" when-accessed="2016-02-11T12:40:42.823-05:00"/&gt;
      &lt;/see-also&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="attribute-which"><title><code>@which</code></title><para>The attribute <code>which</code> used to point to a reserved keyword, either a reserved tokenization pattern or a relationship.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code>, <code><link linkend="pattern-entity-nondigital-ref">~entity-nondigital-ref</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code></para><caution><para>An element's <code><link linkend="attribute-which">@which</link></code> must have a value that corresponds to a <code><link linkend="element-name">&lt;name&gt;</link></code>, either in the core TAN keyword or an associated TAN-key file, that is marked as applying to that element.</para></caution><caution><para>Keywords (values of <code><link linkend="attribute-which">@which</link></code>) must be unique for a given element name.</para></caution><caution><para>Any element that takes <code><link linkend="attribute-which">@which</link></code> must have keywords defined for that element.</para></caution><caution><para>Keys are integral parts of a document. Access to at least one version is absolutely mandatory.</para></caution><para><example><title><code>@which</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:object-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      &lt;see-also&gt;
         &lt;relationship which="alternatively divided edition"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
      &lt;declarations&gt;
         .........
         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@which</code></title><programlisting>      &lt;see-also&gt;
         &lt;relationship which="model"/&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs&lt;/IRI&gt;
         .........
      &lt;/see-also&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="attribute-who"><title><code>@who</code></title><para>The attribute <code>who</code> names an <code><link linkend="element-agent">&lt;agent&gt;</link></code></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-comment">~comment</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@who</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-07T16:36:28.867-04:00" who="kalvesmaki"&gt;Reformatted file at
         ar.cat.eng.1926.edghill.sem.xml to the structure of the copy of the model.&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@who</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-06-22T08:04:25.003-04:00" who="kalvesmaki"&gt;Reformatted according to first
         model found. Backup made at
         file:/C:/Users/jdkalv/Dropbox/TAN/library/TAN-1-dev/examples/ar.cat.eng.1926.edghill.sem-201606220804250030400.xml.&lt;/change&gt;
      &lt;change when="2016-01-26-04:00" who="kalvesmaki"&gt;Started new file.&lt;/change&gt;
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>@who</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      &lt;change when="2016-07-10" who="kalvesmaki"&gt;Began new file&lt;/change&gt;
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para></section><section xml:id="attribute-xmlid"><title><code>@xml:id</code></title><para>The attribute <code>xml:id</code> identifies an entity described within an element. Must be unique within a given file. Must consist only of word characters.</para><para>Formal Definition</para><synopsis>ID (pattern \w\S*)</synopsis><para>Used by: <code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>, <code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-id-option">~id-option</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-decl-alias">~decl-alias</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><caution><para><code><link linkend="attribute-xmlid">@xml:id</link></code> values may not be repeated in the same document.</para></caution><caution><para>Any ana with an <code><link linkend="attribute-xmlid">@xml:id</link></code> must point to no more than one token.</para></caution><caution><para>Codes for (<code><link linkend="attribute-xmlid">@xml:id</link></code> or <code><link linkend="attribute-code">@code</link></code>) features must be case-indifferently unique within a given category.</para></caution><para><example><title><code>@xml:id</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="p"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Page_(paper)&lt;/IRI&gt;
            &lt;name&gt;page&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;div-type xml:id="c"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Column_(typography)&lt;/IRI&gt;
            &lt;name&gt;column&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;div-type xml:id="l"&gt;
            &lt;IRI&gt;tag:textalign.net,2015:div-type:line:physical&lt;/IRI&gt;
            &lt;name&gt;physical line&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;filter&gt;
            .........
         &lt;/filter&gt;
      &lt;/declarations&gt;
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         &lt;IRI&gt;http://viaf.org/viaf/299582703&lt;/IRI&gt;
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         .........
      &lt;/role&gt;
      .........
   &lt;/head&gt;
   .........
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="attribute-xmllang"><title><code>@xml:lang</code></title><para>The attribute <code>xml:lang</code> specifies a language code that names the language of the text enclosed by the parent element. Values are inherited by all descendants except for those that have an <code><link linkend="attribute-xmllang">@xml:lang</link></code> and their descendants.  </para><para>Values should adhere to BCP (Best Common Practices) 47, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt.">http://www.rfc-editor.org/rfc/bcp/bcp47.txt.</link> For more details see <xref linkend="language"/>.</para><para>Examples: 'eng' (English), 'grc' (classical Greek), 'lat' (Latin) </para><para>Formal Definition</para><synopsis>language </synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-nontextual-reference">~nontextual-reference</link></code>, <code><link linkend="pattern-metadata-desc">~metadata-desc</link></code></para><para><example><title><code>@xml:lang</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
      &lt;agent roles="editor" xml:id="kalvesmaki"&gt;
         .........
         &lt;IRI&gt;tag:kalvesmaki.com,2014:self&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Joel Kalvesmaki&lt;/name&gt;
      &lt;/agent&gt;
      &lt;role xml:id="editor"&gt;
         &lt;IRI&gt;http://schema.org/editor&lt;/IRI&gt;
         &lt;name xml:lang="eng"&gt;Editor&lt;/name&gt;
      &lt;/role&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      &lt;div type="p" n="1"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="p" n="2"&gt;
         .........
      &lt;/div&gt;
      &lt;div type="p" n="3"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>@xml:lang</code></title><programlisting>         &lt;div-type xml:id="par"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Paragraph&lt;/IRI&gt;
            &lt;name xml:lang="eng"&gt;paragraph&lt;/name&gt;
         &lt;/div-type&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section></section><section><title>TAN-class-1 elements and attributes summarized</title><section xml:id="element-div-type"><title><code>&lt;div-type&gt;</code></title><para>The element <code>div-type</code> declares a type of textual division (e.g., title, paragraph, stanza). You may have as many <code>&lt;div-types&gt;</code> as you wish, and they need not all be used.</para><para>For more information, see <xref linkend="reference_system"/></para><para>This element takes a reserved keyword or IRI + name pattern. See <xref linkend="keywords-div-type"/> for suggested values. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-xmlid">@xml:id</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para><caution><para>To avoid ambiguous numerals, no div type should mix Roman and alphabet numerals.</para></caution><para><example><title><code>&lt;div-type&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="p"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Page_(paper)&lt;/IRI&gt;
            &lt;name&gt;page&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;div-type xml:id="c"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Column_(typography)&lt;/IRI&gt;
            &lt;name&gt;column&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;div-type xml:id="l"&gt;
            &lt;IRI&gt;tag:textalign.net,2015:div-type:line:physical&lt;/IRI&gt;
            &lt;name&gt;physical line&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;filter&gt;
            .........
         &lt;/filter&gt;
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;div-type&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;work&gt;
            .........
         &lt;/work&gt;
         &lt;div-type xml:id="ch"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Chapter_(books)&lt;/IRI&gt;
            &lt;name&gt;chapter&lt;/name&gt;
         &lt;/div-type&gt;
         &lt;div-type xml:id="par"&gt;
            .........
         &lt;/div-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para></section><section xml:id="element-filter"><title><code>&lt;filter&gt;</code></title><para>The element <code>filter</code> declares alterations that have been made to the source.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
   (<code><link linkend="element-normalization">&lt;normalization&gt;</link></code>* &amp; <code><link linkend="element-replace">&lt;replace&gt;</link></code>* &amp; <code><link linkend="element-transliteration">&lt;transliteration&gt;</link></code>*))</synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para><para><example><title><code>&lt;filter&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;div-type xml:id="l"&gt;
            .........
         &lt;/div-type&gt;
         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;filter&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;div-type xml:id="pt" which="part"/&gt;
         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;filter&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;div-type xml:id="pt" which="part"/&gt;
         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;filter&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;div-type xml:id="pt" which="part"/&gt;
         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-normalization"><title><code>&lt;normalization&gt;</code></title><para>The element <code>normalization</code> specifies an alteration made to a source file to bring the transcription into conformity with standards or common expectations. This element is used typically for minor corrections, e.g., suppression of discretionary hyphenation. You should declare every change you have made to the source.</para><para><code><link linkend="element-normalization">&lt;normalization&gt;</link></code> is especially helpful in reference to nondigital sources, but it may be made also for digital sources, to declare global changes that would be cumbersome, difficult, or impossible to describe in <code><link linkend="element-replace">&lt;replace&gt;</link></code>. </para><para>See <xref linkend="keywords-normalization"/> for suggested IRI + name values for normalizations. For general discussion see <xref linkend="normalizing_transcriptions"/> </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      ({empty}, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-decl-filter-content">~decl-filter-content</link></code></para><para><example><title><code>&lt;normalization&gt;</code></title><programlisting>         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;normalization&gt;</code></title><programlisting>         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;normalization&gt;</code></title><programlisting>         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;normalization&gt;</code></title><programlisting>         &lt;filter&gt;
            &lt;normalization which="no hyphens"/&gt;
         &lt;/filter&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section><section xml:id="element-replace"><title><code>&lt;replace&gt;</code></title><para>The element <code>replace</code> contains the equivalent of the XPath <code>replace(</code>) function plus parameters, indicating a replacement operation that should be, or has been, applied to a digital file.</para><para>Multiple <code><link linkend="element-replace">&lt;replace&gt;</link></code>s will be assumed to have been implemented in document order.</para><para>The conventions of this element and its children accord with the definition of the function and its parameters provided at <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xpath-functions-30/#func-replace">http://www.w3.org/TR/xpath-functions-30/#func-replace</link></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="attribute-regex">@regex</link></code>, <code><link linkend="attribute-replacement">@replacement</link></code>, <code><link linkend="attribute-flags">@flags</link></code>?)))</synopsis><para>Used by: <code><link linkend="pattern-decl-filt-repl">~decl-filt-repl</link></code></para></section><section xml:id="element-transliteration"><title><code>&lt;transliteration&gt;</code></title><para>The element <code>transliteration</code> indicates a transliteration scheme that has been applied to a source to convert it from one writing system to another. This element may be useful if it easier to work with a source in the Latin alphabet (for example) rather than a native one. </para><para>The scope of this element may be specified through optional <code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>s.</para><para>This may be useful for texts easier to handle in a Latin alphabet rather than a native one.  </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-filter-content">~decl-filter-content</link></code></para></section><section xml:id="attribute-replacement"><title><code>@replacement</code></title><para>The attribute <code>replacement</code> contains a string used to replace any occurrence of <code>&lt;pattern&gt;</code> </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="element-replace">&lt;replace&gt;</link></code></para></section></section><section><title>TAN-T elements and attributes summarized</title><section xml:id="element-div"><title><code>&lt;div&gt;</code></title><para>The element <code>div</code> marks a textual unit. Contains other <code><link linkend="element-div">&lt;div&gt;</link></code>s or text, but not both (no mixed content).</para><para>TAN's <code><link linkend="element-div">&lt;div&gt;</link></code> differs from the TEI's, in that the latter is intended for the first level or levels of subdivision in the front, body, or back of a text, but not for paragraphs or anonymous blocks. The TAN <code><link linkend="element-div">&lt;div&gt;</link></code> better resembles the one defined by HTML, and can be applied to any kind of division whatsoever., even down to the letter or character level.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-type">@type</link></code>, <code><link linkend="attribute-n">@n</link></code>, <code><link linkend="attribute-xmllang">@xml:lang</link></code>?, (<code><link linkend="element-div">&lt;div&gt;</link></code>+ | text)))</synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code></para><caution><para>All text must be normalized (Unicode NFC).</para></caution><caution><para>Leaf div references must be unique.</para></caution><caution><para><code><link linkend="attribute-n">@n</link></code>'s taking digit values should not begin with 0.</para></caution><caution><para>Every leaf div must have at least some non-space text.</para></caution><caution><para>No div may begin with a modifying character.</para></caution><caution><para>No div may have a spacing character followed by a modifying character.</para></caution><caution><para>No div may have Unicode characters that are disallowed, e.g., U+A0, NO BREAK SPACE.</para></caution><caution><para><code><link linkend="element-div">&lt;div&gt;</link></code>s may not be mixed with other elements: a <code><link linkend="element-div">&lt;div&gt;</link></code> must parent either only <code><link linkend="element-div">&lt;div&gt;</link></code>s or none at all, and may have as siblings only other <code><link linkend="element-div">&lt;div&gt;</link></code>s.</para></caution><caution><para>A <code><link linkend="element-div">&lt;div&gt;</link></code> must not mix <code><link linkend="attribute-include">@include</link></code> with any other attributes.</para></caution><caution><para>A <code><link linkend="element-div">&lt;div&gt;</link></code> must have either <code><link linkend="attribute-type">@type</link></code> + <code><link linkend="attribute-n">@n</link></code> or <code><link linkend="attribute-include">@include</link></code> but not both.</para></caution><important><para><code><link linkend="attribute-n">@n</link></code> suffices for labeling text in a <code><link linkend="element-div">&lt;div&gt;</link></code>; the <code><link linkend="attribute-n">@n</link></code>'s value should not appear in the text.</para></important><important><para>concatenated <code><link linkend="attribute-n">@n</link></code>'s suffice for labeling text in a <code><link linkend="element-div">&lt;div&gt;</link></code>; the <code><link linkend="element-div">&lt;div&gt;</link></code>'s reference should not appear in the text.</para></important><para><example><title><code>&lt;div&gt;</code></title><programlisting>   &lt;body xml:lang="eng"&gt;
      &lt;div type="p" n="1"&gt;
         &lt;div type="c" n="a"&gt;
            &lt;div type="l" n="1"&gt;Things are said to be named 'equivocally' when, though they have a common name, the definition corresponding&lt;/div&gt;
            &lt;div type="l" n="2"&gt;with the name differs for each. Thus, a real man and a figure in a picture can both&lt;/div&gt;
            &lt;div type="l" n="3"&gt;lay claim to the name 'animal'; yet these are equivocally so named, for, though they have&lt;/div&gt;
            .........
         &lt;/div&gt;
         &lt;div type="c" n="b"&gt;
            .........
         &lt;/div&gt;
      &lt;/div&gt;
      &lt;div type="p" n="2"&gt;
         .........
      &lt;/div&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para></section><section xml:id="element-TAN-T"><title><code>&lt;TAN-T&gt;</code></title><para>The element <code>TAN-T</code> specifies that the TAN file contains a transcription. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-T&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.obj.xml">ar.cat.eng.1926.edghill.obj</link></para></note></para><para><example><title><code>&lt;TAN-T&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="eng"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.eng.1926.edghill.sem.xml">ar.cat.eng.1926.edghill.sem</link></para></note></para><para><example><title><code>&lt;TAN-T&gt;</code></title><programlisting>&lt;TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs" TAN-version="1 dev"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem-native.xml">ar.cat.fra.1844.saint-hilaire.sem-native</link></para></note></para><para><example><title><code>&lt;TAN-T&gt;</code></title><programlisting>&lt;TAN-T TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.fra.1844.saint-hilaire:semantic-refs-realigned"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body xml:lang="fra"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-T&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/ar.cat.fra.1844.saint-hilaire.sem.xml">ar.cat.fra.1844.saint-hilaire.sem</link></para></note></para></section></section><section><title>TAN-class-2 elements and attributes summarized</title><section xml:id="element-rename"><title><code>&lt;rename&gt;</code></title><para>The element <code>rename</code> indicates the name of a <code><link linkend="element-div">&lt;div&gt;</link></code> <code><link linkend="attribute-n">@n</link></code> that should be changed in a given <code><link linkend="attribute-type">@type</link></code>, and the name to which it should be changed.</para><para>There is no need to use this feature to convert Roman, alphabetic, or other numerals, which are detected and converted automatically </para><para>Formal Definition</para><synopsis><code><link linkend="attribute-old">@old</link></code>, <code><link linkend="attribute-new">@new</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code></para><caution><para><code><link linkend="attribute-old">@old</link></code> and <code><link linkend="attribute-new">@new</link></code> may not share the same value</para></caution><caution><para>No value of <code><link linkend="attribute-new">@new</link></code> or <code><link linkend="attribute-old">@old</link></code> may appear more than once for a given div type in a given source.</para></caution><caution><para><code><link linkend="attribute-old">@old</link></code> must be found in every div type of every source</para></caution><para><example><title><code>&lt;rename&gt;</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="e" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>&lt;rename&gt;</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="5" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="element-rename-div-ns"><title><code>&lt;rename-div-ns&gt;</code></title><para>The element <code>rename-div-ns</code> provisionally reassigns <code><link linkend="attribute-n">@n</link></code> values for one or more sources and one or more div types. Renaming applies only to the current file. </para><para>This element is especially useful for converting Roman numerals or letter numerals into Arabic numerals. See <code><link linkend="element-rename">&lt;rename&gt;</link></code> for syntax.</para><para>This feature is strictly speaking a convenience, not a necessity. All TAN-compliant preprocessors are required to automatically detect Roman and alphabetic numbering systems and treat them as Arabic numerals. </para><para>It is also useful for div types that use descriptive names for <code><link linkend="attribute-n">@n</link></code> (such as books of the Bible), particularly for reconciling those names with a system that prevails or is preferred (e.g., "mt" to "Matt"). </para><para>Note for TAN-A-div users: Although this element can reconcile simple differences, it should not be used for more complex inconsistencies that affect alignment, best handled in the <code><link linkend="element-body">&lt;body&gt;</link></code> of a TAN-A-div file.</para><para>For more inforrmation see <xref linkend="class_2_metadata"/></para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, <code><link linkend="attribute-div-type-ref">@div-type-ref</link></code>, <code><link linkend="element-rename">&lt;rename&gt;</link></code>+))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para><caution><para>Every div type reference must be valid in every source</para></caution><para><example><title><code>&lt;rename-div-ns&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;token-definition src="eng-us" regex="[-\w]+"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="e" new="4"/&gt;
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>&lt;rename-div-ns&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;token-definition src="eng ger" which="letters and punctuation"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="5" new="4"/&gt;
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="element-suppress-div-types"><title><code>&lt;suppress-div-types&gt;</code></title><para>The element <code>suppress-div-types</code> marks div types in a source that should be suppressed in references. Suppressions occur shallowly. That is, it does not suppress any descendants of that div type. But if the suppression applies to a leaf div, that div and its text is effectively suppressed. </para><para>Any suppression of a div type must preserve the Leaf Div Uniqueness Rule (LDUR). See <xref linkend="leaf_div_uniqueness_rule"/></para><para>This element will be used seldomly, for cases where a source has a div type that is dispensable in text references. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, <code><link linkend="attribute-div-type-ref">@div-type-ref</link></code>))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para><caution><para>Every div type reference must be valid in every source</para></caution><para><example><title><code>&lt;suppress-div-types&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;suppress-div-types src="fra" div-type-ref="sec"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para><para><example><title><code>&lt;suppress-div-types&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;suppress-div-types src="eng-1790" div-type-ref="poem"/&gt;
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following token definition
                treats the following as words: sequences of letters, any individual character 
                that is neither a letter nor a space (i.e., punctuation).&lt;/comment&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="element-tok"><title><code>&lt;tok&gt;</code></title><para>The element <code>tok</code> identifies one or more words or word fragments. Used by class 2 files to make assertions about specific words. </para><para>In TAN-A-div and TAN-A-tok files, <code><link linkend="element-tok">&lt;tok&gt;</link></code> has no linguistic connotations; in TAN-LM, it normally does.</para><para><code><link linkend="element-tok">&lt;tok&gt;</link></code>s are two types: simple and complex.</para><para>SIMPLE: <code><link linkend="element-tok">&lt;tok&gt;</link></code>s that are restricted to a single token, or a portion of a single token. This is the normal behavior of <code><link linkend="element-tok">&lt;tok&gt;</link></code>. Multiple values in <code><link linkend="attribute-src">@src</link></code>, <code><link linkend="attribute-ref">@ref</link></code>, and <code><link linkend="attribute-pos">@pos</link></code> will result in expansion across all values. But multiple values of <code><link linkend="attribute-chars">@chars</link></code> are taken to refer to the constituent parts of a single <code><link linkend="element-tok">&lt;tok&gt;</link></code> and so no expansion occurs on <code>@chars.</code></para><para>For example, a <code><link linkend="element-tok">&lt;tok&gt;</link></code> with 2 values for <code><link linkend="attribute-src">@src</link></code>, 3 for <code><link linkend="attribute-ref">@ref</link></code>, 4 for <code><link linkend="attribute-pos">@pos</link></code>, and 5 for <code><link linkend="attribute-chars">@chars</link></code> will result in a <code><link linkend="element-tok">&lt;tok&gt;</link></code> that points to 24 tokens, each of which is filtered to the same five characters (by position, not content). This syntax, then, allows multiple <code><link linkend="element-tok">&lt;tok&gt;</link></code>s to be collapsed into a single one, to save space and perhaps enhance legibility. Put another way, &lt;tok src="X" ref="a" pos="1"/&gt; and &lt;tok src="X" ref="a" pos="2"/&gt; is always identical to &lt;tok src="X" ref="a" pos="1-2"/&gt;</para><para>COMPLEX: There are cases where one wishes to treat more than one token, in whole or part, as a single entity. In this case, <code><link linkend="attribute-cont">@cont</link></code> should be used, and it must join <code><link linkend="element-tok">&lt;tok&gt;</link></code>s that have only single values for <code><link linkend="attribute-src">@src</link></code>, <code><link linkend="attribute-ref">@ref</link></code>, and <code>@pos.</code> <code><link linkend="attribute-chars">@chars</link></code> may take multiple values.</para><para>The behavior of <code><link linkend="element-tok">&lt;tok&gt;</link></code> differs from <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>. The former is never treated as a group, whereas the latter is. For more, see <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-tok-attr-core">~tok-attr-core</link></code>, 
{[TAN-A-div (<code><link linkend="pattern-tok-source-ref-opt">~tok-source-ref-opt</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-tok-source-ref-opt">~tok-source-ref-opt</link></code>):]   
  {{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>}} OR 

  {{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}} OR 

  {{[TAN-LM-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}}}, 
{[TAN-LM-lang (<code><link linkend="pattern-pointer-to-div-range">~pointer-to-div-range</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-pointer-to-div-range">~pointer-to-div-range</link></code>):]   <code><link linkend="attribute-ref">@ref</link></code>}, 
   (<code><link linkend="attribute-val">@val</link></code> | 
{[TAN-LM-lang (<code><link linkend="pattern-seq-pos-ref">~seq-pos-ref</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-seq-pos-ref">~seq-pos-ref</link></code>):]   <code><link linkend="attribute-pos">@pos</link></code>} | (<code><link linkend="attribute-val">@val</link></code>, 
{[TAN-LM-lang (<code><link linkend="pattern-seq-pos-ref">~seq-pos-ref</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-seq-pos-ref">~seq-pos-ref</link></code>):]   <code><link linkend="attribute-pos">@pos</link></code>})), 
{[TAN-A-div (<code><link linkend="pattern-tok-cert-opt">~tok-cert-opt</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-tok-cert-opt">~tok-cert-opt</link></code>):]   
   
      (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?}<code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code>, <code><link linkend="attribute-src">@src</link></code>, 
{[TAN-A-div (<code><link linkend="pattern-continuation-opt">~continuation-opt</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-continuation-opt">~continuation-opt</link></code>):]   <code><link linkend="attribute-cont">@cont</link></code>}, 
   
      (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?<code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code>, 
{[TAN-A-div (<code><link linkend="pattern-continuation-opt">~continuation-opt</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-continuation-opt">~continuation-opt</link></code>):]   <code><link linkend="attribute-cont">@cont</link></code>}<code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></synopsis><para>Used by: <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-complex-text-ref">~complex-text-ref</link></code>, <code><link linkend="pattern-alignment-content-non-class-2">~alignment-content-non-class-2</link></code>, <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><caution><para>Every token must be locatable in every cited ref in every source.</para></caution><caution><para><code><link linkend="element-tok">&lt;tok&gt;</link></code> must reference a leaf <code><link linkend="element-div">&lt;div&gt;</link></code>.</para></caution><caution><para>No source may be split more than once in the same place.</para></caution><caution><para>Splits may not be made at the first token in a div.</para></caution><caution><para>A <code><link linkend="element-tok">&lt;tok&gt;</link></code> may not duplicate any sibling <code><link linkend="element-tok">&lt;tok&gt;</link></code>.</para></caution><caution><para>Any ana with an <code><link linkend="attribute-xmlid">@xml:id</link></code> must point to no more than one token.</para></caution><para><example><title><code>&lt;tok&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-chars"><title><code>@chars</code></title><para>The attribute <code>chars</code> list of one or more characters, specified through Arabic numerals, the keyword 'last' or 'last-X' (where X is a valid number), joined with commas or hyphens.</para><para>Examples: '1', 'last', 'last-3 - last-1', '1, 3, 5, 7 - 11, last-8, last'</para><para>Formal Definition</para><synopsis>string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-tok-attr-core">~tok-attr-core</link></code></para><caution><para>Sequences may not include values less than 1.</para></caution><caution><para>Sequences may not include values greater than the maximum allowed.</para></caution><caution><para>Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2.</para></caution></section><section xml:id="attribute-cont"><title><code>@cont</code></title><para>The attribute <code>cont</code> indicates whether the current element is continued by the next one and to be treated as a single one. Value must be 1 or true, implied by the very presence of the attribute. If you wish to decare it to be false, delete the attribute altogether.</para><para>This feature is useful in <code><link linkend="element-tok">&lt;tok&gt;</link></code> for rejoining the portion of a word split across two <code><link linkend="element-div">&lt;div&gt;</link></code>s, or for uniting into a single linguistic token multiple tokens separated by the tokenization process, e.g., "pom pom". </para><para>This feature is useful in <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> for creating groups of references that cannot be expressed in a single <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>  </para><para>Formal Definition</para><synopsis>boolean (pattern true|1)</synopsis><para>Used by: <code><link linkend="pattern-continuation-opt">~continuation-opt</link></code></para><caution><para>Any element taking <code><link linkend="attribute-cont">@cont</link></code> must be followed by at least one sibling of the same type.</para></caution></section><section xml:id="attribute-div-type-ref"><title><code>@div-type-ref</code></title><para>The attribute <code>div-type-ref</code> is used by class-2 files to point to one or more <code><link linkend="element-div-type">&lt;div-type&gt;</link></code>s in class-1 files. Permits multiple values separated by spaces.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code></para><caution><para>Every div type reference must be valid in every source</para></caution><para><example><title><code>@div-type-ref</code></title><programlisting>      &lt;declarations&gt;
         &lt;suppress-div-types src="fra" div-type-ref="sec"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para><para><example><title><code>@div-type-ref</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-TAN-A-ring02"&gt;
   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;suppress-div-types src="eng-1790" div-type-ref="poem"/&gt;
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following token definition
                treats the following as words: sequences of letters, any individual character 
                that is neither a letter nor a space (i.e., punctuation).&lt;/comment&gt;
         &lt;token-definition src="eng-us" regex="[-\w]+"/&gt;
         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="e" new="4"/&gt;
         &lt;/rename-div-ns&gt;
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
   &lt;body&gt;
      .........
      &lt;equate-div-types&gt;
         &lt;div-type-ref src="ger" div-type-ref="Zeile"/&gt;
         &lt;div-type-ref src="eng-uk" div-type-ref="line"/&gt;
      &lt;/equate-div-types&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="attribute-new"><title><code>@new</code></title><para>The attribute <code>new</code> provides the new name for an <code><link linkend="attribute-n">@n</link></code> that is to be renamed</para><para>Formal Definition</para><synopsis>string (pattern (\w+|\d+-\d+)(\s+(\w+|\d+-\d+))*)</synopsis><para>Used by: <code><link linkend="element-rename">&lt;rename&gt;</link></code></para><caution><para><code><link linkend="attribute-old">@old</link></code> and <code><link linkend="attribute-new">@new</link></code> may not share the same value</para></caution><caution><para>No value of <code><link linkend="attribute-new">@new</link></code> or <code><link linkend="attribute-old">@old</link></code> may appear more than once for a given div type in a given source.</para></caution><para><example><title><code>@new</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="e" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>@new</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="5" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="attribute-old"><title><code>@old</code></title><para>The attribute <code>old</code> provides the name of an <code><link linkend="attribute-n">@n</link></code> to be renamed</para><para>Formal Definition</para><synopsis>string (pattern (\w+|\d+-\d+)(\s+(\w+|\d+-\d+))*)</synopsis><para>Used by: <code><link linkend="element-rename">&lt;rename&gt;</link></code></para><caution><para><code><link linkend="attribute-old">@old</link></code> and <code><link linkend="attribute-new">@new</link></code> may not share the same value</para></caution><caution><para>No value of <code><link linkend="attribute-new">@new</link></code> or <code><link linkend="attribute-old">@old</link></code> may appear more than once for a given div type in a given source.</para></caution><caution><para><code><link linkend="attribute-old">@old</link></code> must be found in every div type of every source</para></caution><para><example><title><code>@old</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="e" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para><para><example><title><code>@old</code></title><programlisting>         &lt;rename-div-ns src="ger" div-type-ref="Zeile"&gt;
            &lt;rename old="5" new="4"/&gt;
         &lt;/rename-div-ns&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="attribute-pos"><title><code>@pos</code></title><para>The attribute <code>pos</code> lists one or more items, specified through Arabic numerals and the keyword 'last' or 'last-X' (where X is a valid number), joined with commas or hyphens.</para><para>Examples: '1', 'last', 'last-3 - last-1', '1, 3, 5, 7 - 11, last-8, last'</para><para>For more see <xref linkend="attr_pos_and_val"/></para><para>Formal Definition</para><synopsis>string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)string (pattern ((last|max)|((last|max)-\d+)|(\d+))|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code>, <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para><caution><para>Sequences may not include values less than 1.</para></caution><caution><para>Sequences may not include values greater than the maximum allowed.</para></caution><caution><para>Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2.</para></caution><para><example><title><code>@pos</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-ref"><title><code>@ref</code></title><para>The attribute <code>ref</code> lists references to one or more <code><link linkend="element-div">&lt;div&gt;</link></code>s. It consists of one or more simple references joined by commas or hyphens. A simple reference is a string value that points to a single <code><link linkend="element-div">&lt;div&gt;</link></code>. </para><para>It is assumed that any simple reference that has fewer <code><link linkend="attribute-n">@n</link></code> values than preceding simple references has been truncated. The abbreviated form will be checked before the form actually stated. For example, 1 1 - 3 will be interpreted first as 1 1 through 1 3; if that is invalid, it will be interpeted as 1 1 through 3. Examples: '2.4 - 7, 9', 'iv 7 - 9'</para><para>In a range with members of uneven depth, those <code><link linkend="element-div">&lt;div&gt;</link></code>s that are closest to the shallowest member are retrieved. For example, 2 - 3 2 2 might fetch 2, 3 1, 3 2 1, 3 2 2 (and not 3 or 3 1 1).</para><para>For more, see <xref linkend="class_2_body"/> </para><para>Formal Definition</para><synopsis>string (pattern (\w+([^\w\-]\w+)*)(((\s*-\s*)|(\s*,\s+))(\w+([^\w\-]\w+)*))*|.*\?\?\?.*)string (pattern (\w+([^\w\-]\w+)*)|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-anchor-div-ref-item">~anchor-div-ref-item</link></code>, <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-claim-div-ref-item">~claim-div-ref-item</link></code>, <code><link linkend="pattern-tok-regular">~tok-regular</link></code>, <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para><caution><para>No single set of references may mix Roman numerals, alphabetic numerals, and numerals that are ambiguously either.</para></caution><caution><para>Every atomic reference in a <code><link linkend="attribute-ref">@ref</link></code> must correspond to a <code><link linkend="element-div">&lt;div&gt;</link></code> in every source mentioned by <code>@src.</code></para></caution><caution><para>Every range in a <code><link linkend="attribute-ref">@ref</link></code> must correspond to one or more <code><link linkend="element-div">&lt;div&gt;</link></code>s in every source mentioned by <code>@src.</code></para></caution><caution><para>If <code><link linkend="attribute-ref">@ref</link></code> points to a leaf div, it must be unique.</para></caution><important><para>A defective reference is a value of <code><link linkend="attribute-ref">@ref</link></code> that corresponds to a <code><link linkend="element-div">&lt;div&gt;</link></code> in some but not all sources in a work. If a defective reference is used, a warning will be reported, identifying the sources that lack the appropriate <code><link linkend="element-div">&lt;div&gt;</link></code>.</para></important><para><example><title><code>@ref</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-src"><title><code>@src</code></title><para>The attribute <code>src</code> refers to the ID of one or more <code><link linkend="element-source">&lt;source&gt;</link></code>s </para><para>The attribute <code>src</code> refers to the ID of only one <code><link linkend="element-source">&lt;source&gt;</link></code></para><para>Formal Definition</para><synopsis>NCName </synopsis><para>Used by: <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-anchor-div-ref-item">~anchor-div-ref-item</link></code>, <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code>, <code><link linkend="pattern-tok-source-ref-opt">~tok-source-ref-opt</link></code>, <code><link linkend="pattern-tok-with-src-and-cont">~tok-with-src-and-cont</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><caution><para>Every atomic reference in a <code><link linkend="attribute-ref">@ref</link></code> must correspond to a <code><link linkend="element-div">&lt;div&gt;</link></code> in every source mentioned by <code>@src.</code></para></caution><caution><para>Every range in a <code><link linkend="attribute-ref">@ref</link></code> must correspond to one or more <code><link linkend="element-div">&lt;div&gt;</link></code>s in every source mentioned by <code>@src.</code></para></caution><para><example><title><code>@src</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;suppress-div-types src="fra" div-type-ref="sec"/&gt;
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
   &lt;body&gt;
      &lt;split-leaf-div-at&gt;
         &lt;tok src="fra" ref="5 5" val="Ceci"/&gt;
         &lt;tok src="fra" ref="5 5" val="Il"/&gt;
         &lt;tok src="fra" ref="5 6" val="Si" pos="1"/&gt;
         &lt;tok src="fra" ref="5 12" val="Ainsi" pos="1, last"/&gt;
         .........
      &lt;/split-leaf-div-at&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section><section xml:id="attribute-val"><title><code>@val</code></title><para>The attribute <code>val</code> specifies a particular word token by means of its string value. Permits regular expressions.</para><para>For more see <xref linkend="attr_pos_and_val"/></para><para>Formal Definition</para><synopsis>string (pattern .+)</synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code>, <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para><caution><para>Attributes that take a regular expression must use escape sequences recognized by XML schema or TAN escape extensions (\k{}). See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xmlschema-2/#regexs">http://www.w3.org/TR/xmlschema-2/#regexs</link> for details.</para></caution><caution><para><code><link linkend="attribute-val">@val</link></code> must wholly match a token in the target.</para></caution><important><para>A <code><link linkend="attribute-val">@val</link></code> set to '.+', a regular expression that matches any string, is equivalent to the omission of <code><link linkend="attribute-val">@val</link></code> <quote>The value '.+' will match any string.</quote></para></important><para><example><title><code>@val</code></title><programlisting>   &lt;body&gt;
      &lt;split-leaf-div-at&gt;
         &lt;tok src="fra" ref="5 5" val="Ceci"/&gt;
         &lt;tok src="fra" ref="5 5" val="Il"/&gt;
         &lt;tok src="fra" ref="5 6" val="Si" pos="1"/&gt;
         &lt;tok src="fra" ref="5 12" val="Ainsi" pos="1, last"/&gt;
         &lt;tok src="fra" ref="5 12" val="Quant"/&gt;
         .........
      &lt;/split-leaf-div-at&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section></section><section><title>TAN-A-div elements and attributes summarized</title><section xml:id="element-anchor-div-ref"><title><code>&lt;anchor-div-ref&gt;</code></title><para>The element <code>anchor-div-ref</code> refers to a group of one or more <code><link linkend="element-div">&lt;div&gt;</link></code>s (or segments of <code><link linkend="element-div">&lt;div&gt;</link></code>s) to which <code><link linkend="element-div">&lt;div&gt;</link></code>s from other versions of the same work should be realigned (defined by the <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s that follow). The first child of a <code><link linkend="element-realign">&lt;realign&gt;</link></code>, it is constructed exactly like <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>, except that only <code><link linkend="attribute-src">@src</link></code>, not <code><link linkend="attribute-work">@work</link></code>, is used, and <code><link linkend="attribute-seg">@seg</link></code> is excluded. </para><para><code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> does not permit the comma in <code><link linkend="attribute-ref">@ref</link></code> in an undistributed realignment, since realignment must always be made to a contiguous range of text. </para><para>If the parent <code><link linkend="element-realign">&lt;realign&gt;</link></code>'s <code>@distribute</code> is false, or missing, then each <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> group will be realigned as a whole to the anchor, treated as a whole.</para><para>If <code>@distribute</code> is true, then every nth realign head will serve as the anchor for the nth realign head in each subsequent <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s (grouped by source).</para><para><code><link linkend="attribute-seg">@seg</link></code>, which applies to splits in specific sources, is not allowed because the job of an anchor is to reconcile other <code><link linkend="element-div">&lt;div&gt;</link></code>s to a reference that is valid independent of any particular edition. <code><link linkend="attribute-seg">@seg</link></code> would defeat that purpose.</para><para>For more, see <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-src">@src</link></code>, <code><link linkend="attribute-ref">@ref</link></code></synopsis><para>Used by: <code><link linkend="pattern-realignment">~realignment</link></code></para><caution><para>A <code><link linkend="element-div">&lt;div&gt;</link></code> may be referred to in a <code><link linkend="element-realign">&lt;realign&gt;</link></code> no more than once (whether <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> or <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>).</para></caution><para><example><title><code>&lt;anchor-div-ref&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   .........
   &lt;body&gt;
      .........
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/&gt;
         &lt;div-ref src="fra" ref="1 1 - 1 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/&gt;
         &lt;div-ref src="fra" ref="3 1 - 3 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/&gt;
         &lt;div-ref src="fra" ref="4 1 - 4 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 1 1-4"/&gt;
         &lt;div-ref src="fra" ref="5 1 - 5 4"/&gt;
      &lt;/realign&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section><section xml:id="element-div-ref"><title><code>&lt;div-ref&gt;</code></title><para>The element <code>div-ref</code> refers to and groups one or more <code><link linkend="element-div">&lt;div&gt;</link></code>s (or segments of <code><link linkend="element-div">&lt;div&gt;</link></code>s).</para><para><code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s are expanded against <code><link linkend="attribute-src">@src</link></code>/<code><link linkend="attribute-work">@work</link></code>, <code><link linkend="attribute-ref">@ref</link></code>, and <code>@seg.</code> That is, a <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> points to every segment of every div of every source cited.</para><para>A <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>, or a group of <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s joined by <code><link linkend="attribute-cont">@cont</link></code>, are treated as many groups as sources referred to. That is, &lt;div-ref src="X Y" ... /&gt; will be treated as shorthand for &lt;div-ref src="X" ... /&gt; and &lt;div-ref src="Y" ... /&gt;. This applies to <code><link linkend="attribute-work">@work</link></code> as well: &lt;div-ref work="w" ... /&gt; is equivalent to &lt;div-ref src="w1" ... /&gt;, &lt;div-ref src="w2" ... /&gt;, etc. </para><para>After this distinction between sources is made, the entire set of <code><link linkend="element-div">&lt;div&gt;</link></code>s pointed to will be treated as a group, and processed as a whole (see <code>@distribute</code>). </para><para><code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> is a grouping device, and is therefore unlike <code><link linkend="element-tok">&lt;tok&gt;</link></code>, which always refers to single items, never sets. As a result, the siblings &lt;div-ref src="X" ref="a"/&gt; and &lt;div-ref src="X" ref="b"/&gt; are NOT identical to &lt;div-ref src="X" ref="a, b"/&gt;   </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, <code><link linkend="attribute-ref">@ref</link></code>, <code><link linkend="attribute-seg">@seg</link></code>?<code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-ref">@ref</link></code>, <code><link linkend="attribute-seg">@seg</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-complex-text-ref">~complex-text-ref</link></code></para><important><para>A defective reference is a value of <code><link linkend="attribute-ref">@ref</link></code> that corresponds to a <code><link linkend="element-div">&lt;div&gt;</link></code> in some but not all sources in a work. If a defective reference is used, a warning will be reported, identifying the sources that lack the appropriate <code><link linkend="element-div">&lt;div&gt;</link></code>.</para></important><caution><para>A <code><link linkend="element-div">&lt;div&gt;</link></code> may be referred to in a <code><link linkend="element-realign">&lt;realign&gt;</link></code> no more than once (whether <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> or <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>).</para></caution><para><example><title><code>&lt;div-ref&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   .........
   &lt;body&gt;
      .........
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/&gt;
         &lt;div-ref src="fra" ref="1 1 - 1 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/&gt;
         &lt;div-ref src="fra" ref="3 1 - 3 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/&gt;
         &lt;div-ref src="fra" ref="4 1 - 4 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 1 1-4"/&gt;
         &lt;div-ref src="fra" ref="5 1 - 5 4"/&gt;
      &lt;/realign&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section><section xml:id="element-div-type-ref"><title><code>&lt;div-type-ref&gt;</code></title><para>The element <code>div-type-ref</code> points to a <code><link linkend="element-div-type">&lt;div-type&gt;</link></code> in one or more sources, using the <code><link linkend="attribute-xmlid">@xml:id</link></code> assigned by the source to that div type. </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, <code><link linkend="attribute-div-type-ref">@div-type-ref</link></code></synopsis><para>Used by: <code><link linkend="pattern-div-type-equiv">~div-type-equiv</link></code>, <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code></para><caution><para>Every div type reference must be valid in every source</para></caution><para><example><title><code>&lt;div-type-ref&gt;</code></title><programlisting>   &lt;body&gt;
      .........
      &lt;equate-div-types&gt;
         &lt;div-type-ref src="ger" div-type-ref="Zeile"/&gt;
         &lt;div-type-ref src="eng-uk" div-type-ref="line"/&gt;
      &lt;/equate-div-types&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="element-equate-div-types"><title><code>&lt;equate-div-types&gt;</code></title><para>The element <code>equate-div-types</code> declares an ad hoc equivalence between div types that are not defined by the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> values in their sources as being identical.</para><para><code><link linkend="element-equate-div-types">&lt;equate-div-types&gt;</link></code> are assumed to be greedy and transitive. If this element is used to equate div type X with type Y, then any div type in any source identical to X's or Y's IRI values will treated as identical. </para><para>This element does not imply that the two types of division are, in reality, one and the same. It merely states that, for the purposes of this alignment, they should be treated as equivalent.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="element-div-type-ref">&lt;div-type-ref&gt;</link></code>, <code><link linkend="element-div-type-ref">&lt;div-type-ref&gt;</link></code>+))</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para><caution><para>Items that share IRI values should not be equated.</para></caution><caution><para>Every div type reference must be valid in every source</para></caution><para><example><title><code>&lt;equate-div-types&gt;</code></title><programlisting>   &lt;body&gt;
      &lt;equate-works work="eng-uk ger"/&gt;
      &lt;equate-div-types&gt;
         &lt;div-type-ref src="ger" div-type-ref="Zeile"/&gt;
         &lt;div-type-ref src="eng-uk" div-type-ref="line"/&gt;
      &lt;/equate-div-types&gt;
      &lt;split-leaf-div-at src="eng-us"&gt;
         .........
      &lt;/split-leaf-div-at&gt;
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="element-equate-works"><title><code>&lt;equate-works&gt;</code></title><para>The element <code>equate-works</code> declares an ad hoc equivalence between works that are not defined by the <code><link linkend="element-IRI">&lt;IRI&gt;</link></code>s in their sources as being identical.</para><para>This element extends the automatic equating of works, which is transitive and greedy. If work A is defined with <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> X, work B with <code><link linkend="element-IRI">&lt;IRI&gt;</link></code>s X and Y, and work C with only <code><link linkend="element-IRI">&lt;IRI&gt;</link></code> Y, then works A and C will be automatically equated.</para><para><code><link linkend="element-equate-works">&lt;equate-works&gt;</link></code> does not imply that the two works are, in reality, one and the same. It merely states that, for the purposes of this alignment, they should be treated as equivalent.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="pattern-inclusion">~inclusion</link></code> | <code><link linkend="attribute-work">@work</link></code>)</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para><caution><para>Items that share IRI values should not be equated.</para></caution><para><example><title><code>&lt;equate-works&gt;</code></title><programlisting>   &lt;body&gt;
      &lt;equate-works work="eng-uk ger"/&gt;
      &lt;equate-div-types&gt;
         .........
      &lt;/equate-div-types&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="element-realign"><title><code>&lt;realign&gt;</code></title><para>The element <code>realign</code> corrects misaligned or unaligned divisions and segments in versions of the same work. <code><link linkend="element-realign">&lt;realign&gt;</link></code> is intended to reconcile discordant reference systems by mapping <code><link linkend="element-div">&lt;div&gt;</link></code>s from one or more sources onto the <code><link linkend="element-div">&lt;div&gt;</link></code>s of another, treated as an anchor. The reanchored divs are then excluded from any default alignments, but they inherit the anchor's alignments. </para><para>Realignments come in four types.</para><para>An UNANCHORED, ONE-SOURCE realigment consists solely of one or more <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s belonging to only one source. Any number of <code><link linkend="element-div">&lt;div&gt;</link></code>s may be referred to by the child <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s. All <code><link linkend="element-div">&lt;div&gt;</link></code>s referred to will be excluded from automatic alignment with every other version of the same work.</para><para>An UNANCHORED, MULTIPLE-SOURCE realignment realigns <code><link linkend="element-div">&lt;div&gt;</link></code>s from multiple sources. The number of <code><link linkend="element-div">&lt;div&gt;</link></code>s per source must be identical, since these <code><link linkend="element-div">&lt;div&gt;</link></code>s will not only be excluded from automatic alignment, but realigned with each other, with the nth <code><link linkend="element-div">&lt;div&gt;</link></code> in each source constituting a realigned group.</para><para>An ANCHORED, ONE-TO-ONE realignment consists of an <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> that points to n <code><link linkend="element-div">&lt;div&gt;</link></code>s, and each source invoked by the following <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s also point to n <code><link linkend="element-div">&lt;div&gt;</link></code>s, which will be reanchored to the nth <code><link linkend="element-div">&lt;div&gt;</link></code> in the anchor. </para><para>An ANCHORED, ONE-TO-MANY realignment consists of an <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> that points only to one <code><link linkend="element-div">&lt;div&gt;</link></code>, and <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>s that point to any number of sources and any number of <code><link linkend="element-div">&lt;div&gt;</link></code>s. To that one anchor will be remapped each source's collection of <code><link linkend="element-div">&lt;div&gt;</link></code>s to be reanchored. The sequence of <code><link linkend="element-div">&lt;div&gt;</link></code>s referred to will be respected. If to an anchor A is remapped <code><link linkend="element-div">&lt;div&gt;</link></code>s 2, 4, and 3, then  </para><para>Realignment is disruptive, displacing any default alignment that might have been inferred in the reanchored source. Assume a case where a <code><link linkend="element-div">&lt;div&gt;</link></code> with reference B is being realigned to an anchor with reference A. In the source to be reanchored reference A, if it exists, will be excluded from automatic alignment with the anchor, unless if it is explicitly included in a <code><link linkend="element-realign">&lt;realign&gt;</link></code>. </para><para>All realignment, except one-to-many anchored, is inheritable, affecting not only the specified <code><link linkend="element-div">&lt;div&gt;</link></code>s but also their descendants. That is, if X is realigned to Y, then children in X will be automatically aligned with children in Y, based on normalized values of <code>@n.</code> Children of <code><link linkend="element-div">&lt;div&gt;</link></code>s in one-to-many anchored realignments must be explicitly realigned.</para><para>Because of the distributive nature of the realignment, every value of <code><link linkend="attribute-ref">@ref</link></code> that involves a hyphen must have siblings with balanced depth on the left and right side of the hyphen (i.e., ref="1 - 2.1" would be invalid).</para><para><code><link linkend="element-realign">&lt;realign&gt;</link></code> does not affect subsequent nomenclature of <code>@ref.</code> If in source x a <code><link linkend="element-div">&lt;div&gt;</link></code> A is realigned with <code><link linkend="element-div">&lt;div&gt;</link></code> B in source y, then subsequent references to the realigned <code><link linkend="element-div">&lt;div&gt;</link></code> in source x should still use A as a value of <code><link linkend="attribute-ref">@ref</link></code>, not B.  </para><para>The order of <code><link linkend="element-realign">&lt;realign&gt;</link></code>s is immaterial. No <code><link linkend="element-realign">&lt;realign&gt;</link></code> overwrites any other <code><link linkend="element-realign">&lt;realign&gt;</link></code>. If two <code><link linkend="element-realign">&lt;realign&gt;</link></code>s each reanchor A and B in the same source to C in the anchor, then A and B will be realigned in parallel. If one meant to say that A followed by B is to be realigned to C, then a one-to-many anchored realignment should be used.  </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code>*, <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>+)))</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para><caution><para>A <code><link linkend="element-div">&lt;div&gt;</link></code> may be referred to in a <code><link linkend="element-realign">&lt;realign&gt;</link></code> no more than once (whether <code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code> or <code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code>).</para></caution><caution><para>Distribution must be applied to groups of equal size.</para></caution><caution><para>No <code><link linkend="element-div">&lt;div&gt;</link></code> that is a member of a complex realignment may be used to align all members of a work (<code><link linkend="attribute-src">@src</link></code> should be used instead of <code><link linkend="attribute-work">@work</link></code>)</para></caution><para><example><title><code>&lt;realign&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   .........
   &lt;body&gt;
      &lt;split-leaf-div-at&gt;
         .........
      &lt;/split-leaf-div-at&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="1 1 1 - 1 1 3"/&gt;
         &lt;div-ref src="fra" ref="1 1 - 1 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="3 1 1 - 3 1 3"/&gt;
         &lt;div-ref src="fra" ref="3 1 - 3 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="4 1 1 - 4 1 3"/&gt;
         &lt;div-ref src="fra" ref="4 1 - 4 3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 1 1-4"/&gt;
         &lt;div-ref src="fra" ref="5 1 - 5 4"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         .........
      &lt;/realign&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section><section xml:id="element-split-leaf-div-at"><title><code>&lt;split-leaf-div-at&gt;</code></title><para>The element <code>split-leaf-div-at</code> creates ad hoc splits in leaf <code><link linkend="element-div">&lt;div&gt;</link></code>s, to facilitate alignments and realignments of textual units smaller than leaf <code><link linkend="element-div">&lt;div&gt;</link></code>s. Any leaf div may be split as many times as there are token, as defined by <code>&lt;tokenization&gt;</code>s.</para><para>Each split creates a provisional segment, a textual subdivision of a leaf <code><link linkend="element-div">&lt;div&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; <code><link linkend="element-tok">&lt;tok&gt;</link></code>+)))</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para><caution><para>Splits may be made only at leaf divs.</para></caution><caution><para>No source may be split more than once in the same place.</para></caution><caution><para>Splits may not be made at the first token in a div.</para></caution><para><example><title><code>&lt;split-leaf-div-at&gt;</code></title><programlisting>   &lt;body&gt;
      &lt;split-leaf-div-at&gt;
         &lt;tok src="fra" ref="5 5" val="Ceci"/&gt;
         &lt;tok src="fra" ref="5 5" val="Il"/&gt;
         &lt;tok src="fra" ref="5 6" val="Si" pos="1"/&gt;
         .........
      &lt;/split-leaf-div-at&gt;
      &lt;realign&gt;
         .........
      &lt;/realign&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para><para><example><title><code>&lt;split-leaf-div-at&gt;</code></title><programlisting>   &lt;body&gt;
      .........
      &lt;equate-div-types&gt;
         .........
      &lt;/equate-div-types&gt;
      &lt;split-leaf-div-at src="eng-us"&gt;
         &lt;tok ref="2" pos="last-3"/&gt;
      &lt;/split-leaf-div-at&gt;
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="element-TAN-A-div"><title><code>&lt;TAN-A-div&gt;</code></title><para>The element <code>TAN-A-div</code> specifies that the file is a div-based TAN alignment file. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-A-div&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body claimant="lmp"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para><para><example><title><code>&lt;TAN-A-div&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para><para><example><title><code>&lt;TAN-A-div&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-TAN-A-ring02"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ringoroses.div.1.xml">ringoroses.div.1</link></para></note></para></section><section xml:id="attribute-seg"><title><code>@seg</code></title><para>The attribute <code>seg</code> picks specific segments in a leaf div. There must be an appropriate number of splits declared for those leaf divs in <code><link linkend="element-split-leaf-div-at">&lt;split-leaf-div-at&gt;</link></code>.</para><para>Formal Definition</para><synopsis>string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-claim-div-ref-item">~claim-div-ref-item</link></code></para><caution><para><code><link linkend="attribute-seg">@seg</link></code> may not be applied to any element that is not a leaf div</para></caution><caution><para>Sequences may not include values less than 1.</para></caution><caution><para>Sequences may not include values greater than the maximum allowed.</para></caution><caution><para>Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2.</para></caution><para><example><title><code>@seg</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div"&gt;
   .........
   &lt;body&gt;
      .........
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 1 5 - 5 1 7"/&gt;
         &lt;div-ref src="fra" ref="5 5" seg="1-3"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 2 1 - 5 2 2"/&gt;
         &lt;div-ref src="fra" ref="5 6" seg="1-2"/&gt;
      &lt;/realign&gt;
      .........
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 4 1 - 5 4 5"/&gt;
         &lt;div-ref src="fra" ref="5 12" seg="1-5"/&gt;
      &lt;/realign&gt;
      &lt;realign&gt;
         &lt;anchor-div-ref src="grc" ref="5 4 6 - 5 4 7"/&gt;
         &lt;div-ref src="fra" ref="5 13" seg="1-2"/&gt;
      &lt;/realign&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.xml">ar.cat.tan-a-div</link></para></note></para></section><section xml:id="attribute-work"><title><code>@work</code></title><para>The attribute <code>work</code> refers to a work by means of a source ID as a proxy. The attribute will be treated as indicating all sources that share the same work as the one mentioned.</para><para>If you wish to avoid making a claim applying to all other versions of a work, use <code><link linkend="attribute-src">@src</link></code> instead.</para><para>The attribute <code>work</code> refers to works by means of source IDs as a proxy. </para><para>Formal Definition</para><synopsis>string (pattern \S+)</synopsis><para>Used by: <code><link linkend="pattern-work-equiv">~work-equiv</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code></para><caution><para>No <code><link linkend="element-div">&lt;div&gt;</link></code> that is a member of a complex realignment may be used to align all members of a work (<code><link linkend="attribute-src">@src</link></code> should be used instead of <code><link linkend="attribute-work">@work</link></code>)</para></caution><para><example><title><code>@work</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section></section><section><title>TAN-A-tok elements and attributes summarized</title><section xml:id="element-align"><title><code>&lt;align&gt;</code></title><para>The element <code>align</code> declares one or more groups of words that should be aligned with each other. <code><link linkend="element-align">&lt;align&gt;</link></code> specifies that all the tokens invoked for one source collectively align with the tokens in the other. </para><para>Formal Definition</para><synopsis>
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code>, <code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, <code><link linkend="attribute-group">@group</link></code>?, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="element-tok">&lt;tok&gt;</link></code> | <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code>)+)))</synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para><important><para>A defective reference is a value of <code><link linkend="attribute-ref">@ref</link></code> that corresponds to a <code><link linkend="element-div">&lt;div&gt;</link></code> in some but not all sources in a work. If a defective reference is used, a warning will be reported, identifying the sources that lack the appropriate <code><link linkend="element-div">&lt;div&gt;</link></code>.</para></important><caution><para>No <code><link linkend="element-div">&lt;div&gt;</link></code> that is a member of a complex realignment may be used to align all members of a work (<code><link linkend="attribute-src">@src</link></code> should be used instead of <code><link linkend="attribute-work">@work</link></code>)</para></caution><caution><para>A <code><link linkend="element-tok">&lt;tok&gt;</link></code> may not duplicate any sibling <code><link linkend="element-tok">&lt;tok&gt;</link></code>.</para></caution><para><example><title><code>&lt;align&gt;</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring02"&gt;
   .........
   &lt;body bitext-relation="B-descends-from-A" reuse-type="adaptation" in-progress="false"&gt;
      &lt;align&gt;
         &lt;tok src="ring1881" ref="1" pos="1"/&gt;
         &lt;tok src="ring1987" ref="1" pos="1"/&gt;
      &lt;/align&gt;
      &lt;align&gt;
         &lt;tok src="ring1881" ref="1" pos="2"/&gt;
         &lt;tok src="ring1987" ref="1" pos="2"/&gt;
      &lt;/align&gt;
      &lt;align&gt;
         &lt;tok src="ring1881" ref="1" pos="3"/&gt;
         &lt;tok src="ring1987" ref="1" pos="3"/&gt;
      &lt;/align&gt;
      &lt;align&gt;
         &lt;tok src="ring1881" ref="1" pos="4"/&gt;
         &lt;tok src="ring1987" ref="1" pos="4"/&gt;
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para></section><section xml:id="element-bitext-relation"><title><code>&lt;bitext-relation&gt;</code></title><para>The element <code>bitext-relation</code> identifies how the text on one text-bearing object relates to that on another by specifying a relationship, e.g., B is a direct copy of A, B and A descent from a commont parent, etc. See <xref linkend="tan-a-tok"/> for theoretical background.</para><para>In most cases, there will be need for only one of these elements. But multiple values may be helpful for cases where a bitext has a complex history, for example, a textual object that was created over time, and in different phases.</para><para>This element should not be used to describe any activities (e.g., translation, copying), reserved for <code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code>. </para><para>For examples see main.xml# keywords-bitext-relation</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para><para><example><title><code>&lt;bitext-relation&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="B-descends-from-A"&gt;
            &lt;IRI&gt;tag:textalign.net,2015:bitext-relation:a/x+/b&lt;/IRI&gt;
            &lt;name&gt;B descends directly from A, unknown number of intermediaries&lt;/name&gt;
            &lt;desc&gt;The 1987 versions is hypothesized to descend somehow from the 1881 version,
                    mainly for the sake of illustration.&lt;/desc&gt;
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="adaptation"&gt;
            .........
         &lt;/reuse-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>&lt;bitext-relation&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="unclear"&gt;
            &lt;IRI&gt;tag:kalvesmaki@gmail.com,2014:bitext-relation:unclear&lt;/IRI&gt;
            &lt;name&gt;The German and English versions bear some relationship, but what exactly is
                    unclear.&lt;/name&gt;
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="correlationGeneral"&gt;
            .........
         &lt;/reuse-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>&lt;bitext-relation&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="unclear"&gt;
            &lt;IRI&gt;tag:kalvesmaki@gmail.com,2014:bitext-relation:unclear&lt;/IRI&gt;
            &lt;name&gt;The German and English versions bear some relationship, but what exactly is
                    unclear.&lt;/name&gt;
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="correlationGeneral"&gt;
            .........
         &lt;/reuse-type&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="element-reuse-type"><title><code>&lt;reuse-type&gt;</code></title><para>The element <code>reuse-type</code> identifies a category of text reuse (e.g., translation, mistranslation, paraphrase, ridicule). See <xref linkend="tan-a-tok"/> for theoretical background.</para><para>For examples see main.xml# keywords-reuse-type</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para><example><title><code>&lt;reuse-type&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="B-descends-from-A"&gt;
            .........
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="adaptation"&gt;
            &lt;IRI&gt;tag:textalign.net,2015:reuse-type:adaptation:general&lt;/IRI&gt;
            &lt;name&gt;general adaptation&lt;/name&gt;
         &lt;/reuse-type&gt;
         &lt;token-definition src="ring1881 ring1987" which="letters"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>&lt;reuse-type&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="unclear"&gt;
            .........
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="correlationGeneral"&gt;
            &lt;IRI&gt;tag:kalvesmaki@gmail.com,2014:reuse-type:correlation-general&lt;/IRI&gt;
            &lt;name&gt;Texts are generally correlated, but without specifying the relation&lt;/name&gt;
         &lt;/reuse-type&gt;
         &lt;comment when="2016-02-22-05:00" who="park"&gt;The following is equivalent to @which = 'letters'&lt;/comment&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>&lt;reuse-type&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;bitext-relation xml:id="unclear"&gt;
            .........
         &lt;/bitext-relation&gt;
         &lt;reuse-type xml:id="correlationGeneral"&gt;
            &lt;IRI&gt;tag:kalvesmaki@gmail.com,2014:reuse-type:correlation-general&lt;/IRI&gt;
            &lt;name&gt;Texts are generally correlated, but without specifying the relation&lt;/name&gt;
         &lt;/reuse-type&gt;
         &lt;token-definition src="eng ger" which="letters and punctuation"/&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="element-TAN-A-tok"><title><code>&lt;TAN-A-tok&gt;</code></title><para>The element <code>TAN-A-tok</code> specifies that the file is a token-based TAN alignment file. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-A-tok&gt;</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring02"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body bitext-relation="B-descends-from-A" reuse-type="adaptation" in-progress="false"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>&lt;TAN-A-tok&gt;</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>&lt;TAN-A-tok&gt;</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03:alt"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="attribute-bitext-relation"><title><code>@bitext-relation</code></title><para>The attribute <code>bitext-relation</code> points to one or more <code><link linkend="element-bitext-relation">&lt;bitext-relation&gt;</link></code> <code><link linkend="attribute-xmlid">@xml:id</link></code> values that qualify the type of relation that holds. Multiple values assume inclusive or (A or B or A and B)</para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@bitext-relation</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring02"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body bitext-relation="B-descends-from-A" reuse-type="adaptation" in-progress="false"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>@bitext-relation</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>@bitext-relation</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03:alt"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section><section xml:id="attribute-reuse-type"><title><code>@reuse-type</code></title><para>The attribute <code>reuse-type</code> points to one or more <code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code> <code><link linkend="attribute-xmlid">@xml:id</link></code> values that qualify the type of textual reuse that holds. Multiple values assume inclusive or (A or B or A and B)</para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@reuse-type</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring02"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body bitext-relation="B-descends-from-A" reuse-type="adaptation" in-progress="false"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+02.token.1.xml">ringoroses.01+02.token.1</link></para></note></para><para><example><title><code>@reuse-type</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.1.xml">ringoroses.01+03.token.1</link></para></note></para><para><example><title><code>@reuse-type</code></title><programlisting>&lt;TAN-A-tok TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-A-tok,ring01+ring03:alt"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body reuse-type="correlationGeneral" bitext-relation="unclear"&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      &lt;align&gt;
         .........
      &lt;/align&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-tok&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-tok/ringoroses.01+03.token.2.xml">ringoroses.01+03.token.2</link></para></note></para></section></section><section><title>TAN-LM-core elements and attributes summarized</title><section xml:id="element-ana"><title><code>&lt;ana&gt;</code></title><para>The element <code>ana</code> contains a one or more assertions about the lexical or morphological properties of one or more tokens.</para><para>Claims within an <code><link linkend="element-ana">&lt;ana&gt;</link></code> are distributive. That is, every combination of <code><link linkend="element-l">&lt;l&gt;</link></code> and <code><link linkend="element-m">&lt;m&gt;</link></code> within an <code><link linkend="element-lm">&lt;lm&gt;</link></code> is asserted of every <code><link linkend="element-tok">&lt;tok&gt;</link></code>.</para><para>Formal Definition</para><synopsis>
   ((<code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="pattern-inclusion">~inclusion</link></code>) | 
      (<code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, <code><link linkend="attribute-group">@group</link></code>?, <code><link linkend="attribute-xmlid">@xml:id</link></code>?, 
         (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; ((<code><link linkend="element-tok">&lt;tok&gt;</link></code> | <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code>)+, <code><link linkend="element-lm">&lt;lm&gt;</link></code>+))))</synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para><caution><para>A <code><link linkend="element-tok">&lt;tok&gt;</link></code> may not duplicate any sibling <code><link linkend="element-tok">&lt;tok&gt;</link></code>.</para></caution><para><example><title><code>&lt;ana&gt;</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   .........
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      &lt;ana&gt;
         &lt;tok ref="11 2 1 1" pos="1"/&gt;
         &lt;lm&gt;
            .........
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         &lt;tok ref="10 6 3 2" pos="4"/&gt;
         &lt;tok ref="10 6 3 3" pos="15"/&gt;
         &lt;tok ref="10 6 4 2" pos="37"/&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         &lt;tok ref="8 3 5 4" pos="6"/&gt;
         &lt;tok ref="8 3 7 3" pos="7"/&gt;
         &lt;lm&gt;
            .........
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         &lt;tok ref="7 1 2 1" pos="12"/&gt;
         &lt;tok ref="7 3 1 3" pos="22"/&gt;
         &lt;tok ref="7 3 1 3" pos="24"/&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="element-l"><title><code>&lt;l&gt;</code></title><para>The element <code>l</code> names a lexeme, by points to the main word entry in the lexicon defined by the element's inherited value of <code>@lexicon.</code> This element should not be used to point to roots, only to lexical headwords. </para><para>In many languages, especially those that are lightly inflected, this word will be identical to the word token itself. In those cases, <code><link linkend="element-l">&lt;l&gt;</link></code> may be left empty, indicating that the value of <code><link linkend="element-tok">&lt;tok&gt;</link></code> is to be supplied.</para><para>Because there is no TAN format for lexicons, values in this element will not be validated.</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-lexicon">@lexicon</link></code>?, <code><link linkend="attribute-def-ref">@def-ref</link></code>?, <code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, text</synopsis><para>Used by: <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><para><example><title><code>&lt;l&gt;</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   .........
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l&gt;Δῆλος&lt;/l&gt;
            &lt;m&gt;n e - s - - - f a -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l&gt;Σωκράτης&lt;/l&gt;
            &lt;m&gt;n e - s - - - m g -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l&gt;αἰσχύνω&lt;/l&gt;
            &lt;m&gt;v - - - a n p - - -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l&gt;αἴσθησις&lt;/l&gt;
            &lt;m&gt;n - - s - - - f n -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l&gt;αἴσθησις&lt;/l&gt;
            &lt;m&gt;n - - s - - - f g -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="element-lexicon"><title><code>&lt;lexicon&gt;</code></title><para>The element <code>lexicon</code> names a lexicographical authority. This element is optional, because the lexical informat could be based upon the knowledge of the <code><link linkend="element-agent">&lt;agent&gt;</link></code>s who wrote the data.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-xmlid">@xml:id</link></code>, <code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>*, (
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+) | <code><link linkend="attribute-which">@which</link></code>) | 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para><para><example><title><code>&lt;lexicon&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;token-definition regex="[\w­​‍]+"/&gt;
         &lt;lexicon xml:id="LSJ"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;http://lccn.loc.gov/95032369&lt;/IRI&gt;
            &lt;name xml:lang="eng"&gt;Liddell-Scott-Jones, 9th ed. plus rev. supplement&lt;/name&gt;
         &lt;/lexicon&gt;
         &lt;lexicon xml:id="Lampe"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;http://lccn.loc.gov/77372171&lt;/IRI&gt;
            &lt;name xml:lang="eng"&gt;G.H.W. Lampe, A Patristic Greek Lexicon, Oxford 1961.&lt;/name&gt;
         &lt;/lexicon&gt;
         &lt;lexicon xml:id="new"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;urn:uuid:d6558d00-8f68-11e3-950a-425861b86ab6&lt;/IRI&gt;
            &lt;name xml:lang="eng"&gt;Lexicon generated from words in this document not to be found in
               any other lexicon.&lt;/name&gt;
         &lt;/lexicon&gt;
         &lt;morphology xml:id="Perseus"&gt;
            .........
         &lt;/morphology&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>&lt;lexicon&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;morphology xml:id="penn" ed-when="2015-08-20-04:00" ed-who="park"&gt;
            .........
         &lt;/morphology&gt;
         &lt;lexicon xml:id="test"&gt;
            &lt;IRI&gt;tag:kalvesmaki@gmail.com,2014:lexicon:eng:test&lt;/IRI&gt;
            &lt;name&gt;test lexicon&lt;/name&gt;
         &lt;/lexicon&gt;
         &lt;token-definition which="letters and punctuation"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para></section><section xml:id="element-lm"><title><code>&lt;lm&gt;</code></title><para>The element <code>lm</code> contains lexical or morphological data.</para><para>Claims within an <code><link linkend="element-lm">&lt;lm&gt;</link></code> are distributive. That is, every <code><link linkend="element-l">&lt;l&gt;</link></code> is asserted against every <code><link linkend="element-m">&lt;m&gt;</link></code> within an <code><link linkend="element-lm">&lt;lm&gt;</link></code> is asserted of every <code><link linkend="element-tok">&lt;tok&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, 
   (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
      ((<code><link linkend="element-l">&lt;l&gt;</link></code>+, <code><link linkend="element-m">&lt;m&gt;</link></code>*) | (<code><link linkend="element-l">&lt;l&gt;</link></code>*, <code><link linkend="element-m">&lt;m&gt;</link></code>+)))</synopsis><para>Used by: <code><link linkend="element-ana">&lt;ana&gt;</link></code></para><para><example><title><code>&lt;lm&gt;</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   .........
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      &lt;ana&gt;
         &lt;tok ref="11 2 1 1" pos="1"/&gt;
         &lt;lm&gt;
            &lt;l&gt;Δῆλος&lt;/l&gt;
            &lt;m&gt;n e - s - - - f a -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;tok ref="10 6 4 2" pos="37"/&gt;
         &lt;lm&gt;
            &lt;l&gt;Σωκράτης&lt;/l&gt;
            &lt;m&gt;n e - s - - - m g -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;tok ref="8 3 7 3" pos="7"/&gt;
         &lt;lm&gt;
            &lt;l&gt;αἰσχύνω&lt;/l&gt;
            &lt;m&gt;v - - - a n p - - -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
         &lt;tok ref="7 4 9 2" pos="4"/&gt;
         &lt;lm&gt;
            &lt;l&gt;αἴσθησις&lt;/l&gt;
            &lt;m&gt;n - - s - - - f n -&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para></section><section xml:id="element-m"><title><code>&lt;m&gt;</code></title><para>The element <code>m</code> carries a morphological code that conforms to the rules or patterns defined in the TAN-mor file upon which the data depends.</para><para>Codes are space-delimited. If a value of <code><link linkend="element-m">&lt;m&gt;</link></code> violates the rules established by the TAN-mor file, an error will be generated. For more about how codes are built, and how they function, see <xref linkend="tan-lm"/>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, <code><link linkend="attribute-morphology">@morphology</link></code>?, string (pattern [^\+\s]+(\s+[^\+\s]+)*)</synopsis><para>Used by: <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para><caution><para>When using a category-based morphology, the number of feature codes in an <code><link linkend="element-m">&lt;m&gt;</link></code> may not exceed the number of categories.</para></caution><caution><para>Every feature code in an <code><link linkend="element-m">&lt;m&gt;</link></code> must be found in the target morphology file.</para></caution><caution><para>Every condition of a relevant <code><link linkend="element-assert">&lt;assert&gt;</link></code> (<code><link linkend="element-report">&lt;report&gt;</link></code>) must be true (false) otherwise an error will be returned.</para></caution><important><para>Every condition of an uncertain but relevant <code><link linkend="element-assert">&lt;assert&gt;</link></code> (<code><link linkend="element-report">&lt;report&gt;</link></code>) must be true (false) otherwise a warning will be returned.</para></important></section><section xml:id="element-morphology"><title><code>&lt;morphology&gt;</code></title><para>The element <code>morphology</code> identifies a <code><link linkend="element-TAN-mor">&lt;TAN-mor&gt;</link></code> file that defines the parts of speech for a language, the codes for those parts, and the rules for combining them</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-xmlid">@xml:id</link></code>, <code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>*, (<code><link linkend="attribute-which">@which</link></code> | 
         
            (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+)))))</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para><para><example><title><code>&lt;morphology&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;lexicon xml:id="new"&gt;
            .........
         &lt;/lexicon&gt;
         &lt;morphology xml:id="Perseus"&gt;
            &lt;for-lang&gt;grc&lt;/for-lang&gt;
            &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-r-mor:grc:perseus&lt;/IRI&gt;
            &lt;name xml:lang="eng"&gt;Perseus Greek morphology&lt;/name&gt;
            .........
         &lt;/morphology&gt;
         &lt;group-type xml:id="status" which="status"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>&lt;morphology&gt;</code></title><programlisting>      &lt;declarations&gt;
         &lt;morphology xml:id="penn" ed-when="2015-08-20-04:00" ed-who="park"&gt;
            &lt;IRI&gt;tag:kalvesmaki.com,2014:tan-r-mor:eng:penn&lt;/IRI&gt;
            &lt;name&gt;Penn Treebank tag set&lt;/name&gt;
            &lt;location href="../TAN-mor/eng.kalvesmaki.com%2C2014.2.xml" when-accessed="2015-11-03-05:00"/&gt;
         &lt;/morphology&gt;
         &lt;lexicon xml:id="test"&gt;
            .........
         &lt;/lexicon&gt;
         .........
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para></section><section xml:id="element-TAN-LM"><title><code>&lt;TAN-LM&gt;</code></title><para>The element <code>TAN-LM</code> specifies that the file is a TAN file containing lexico-morphology data about a text. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-LM&gt;</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>&lt;TAN-LM&gt;</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-lm"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="test" morphology="penn" in-progress="false"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para></section><section xml:id="attribute-def-ref"><title><code>@def-ref</code></title><para>The attribute <code>def-ref</code> identifies which definition is meant. This attribute is essential in cases where a lexicon has multiple entries for lexemes that are orthographically indistinguishable. </para><para>Because there is no TAN format for lexicons, the value in this attribute will not be validated.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="element-l">&lt;l&gt;</link></code></para></section><section xml:id="attribute-lexicon"><title><code>@lexicon</code></title><para>The attribute <code>lexicon</code> points to one or more <code><link linkend="element-lexicon">&lt;lexicon&gt;</link></code> or <code><link linkend="element-agent">&lt;agent&gt;</link></code> IDs</para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-lexeme">~lexeme</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@lexicon</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>@lexicon</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-lm"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="test" morphology="penn" in-progress="false"&gt;
      &lt;ana&gt;
         .........
         &lt;lm&gt;
            &lt;l lexicon="test"&gt;ring-a-ring-a-rose&lt;/l&gt;
            &lt;m&gt;NNS ;&lt;/m&gt;
         &lt;/lm&gt;
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana xml:id="anatest"&gt;
         .........
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para></section><section xml:id="attribute-morphology"><title><code>@morphology</code></title><para>The attribute <code>morphology</code> points to one or more <code><link linkend="element-morphology">&lt;morphology&gt;</link></code> IDs</para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-morph">~morph</link></code></para><caution><para>Every idref in an attribute must point to the <code><link linkend="attribute-xmlid">@xml:id</link></code> value of the appropriate corresponding element.</para></caution><caution><para>All idrefs in an attribute must be unique.</para></caution><para><example><title><code>@morphology</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-t:ar.cat.grc.1949.minio-paluello:semantic-refs:TAN-LM:2016-04-05T07:07:40.033-04:00"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="LSJ Lampe new" morphology="Perseus"&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample.xml">ar.cat.grc.1949.minio-paluello-sem-TAN-LM-sample</link></para></note></para><para><example><title><code>@morphology</code></title><programlisting>&lt;TAN-LM TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ring01-lm"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body lexicon="test" morphology="penn" in-progress="false"&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana&gt;
         .........
      &lt;/ana&gt;
      &lt;ana xml:id="anatest"&gt;
         .........
      &lt;/ana&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-LM&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-LM/ring-o-roses.eng.1881.lm.xml">ring-o-roses.eng.1881.lm</link></para></note></para></section></section><section><title>TAN-LM elements and attributes summarized</title><para>No attributes or elements are defined for TAN-LM.</para></section><section><title>TAN-LM-lang elements and attributes summarized</title><para>No attributes or elements are defined for TAN-LM-lang.</para></section><section><title>TAN-class-3 elements and attributes summarized</title><para>No attributes or elements are defined for TAN-class-3.</para></section><section><title>TAN-key elements and attributes summarized</title><section xml:id="element-item"><title><code>&lt;item&gt;</code></title><para>The element <code>item</code> names an item that is being described. The item is assumed to be a species of the type of thing discussed by the TAN element that is affected.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-affects-element">@affects-element</link></code>?, <code><link linkend="attribute-group">@group</link></code>?, (
         
            (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+)) | 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+) | <code><link linkend="attribute-which">@which</link></code>) | 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>) | <code><link linkend="pattern-entity-tok-def">~entity-tok-def</link></code>)))</synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code>, <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code></para><caution><para><code><link linkend="attribute-affects-element">@affects-element</link></code> must include only names of TAN elements that accept <code><link linkend="attribute-which">@which</link></code></para></caution><caution><para>Every item in a reserved TAN-key must have at least one IRI with a tag URN in the TAN namespace</para></caution><para><example><title><code>&lt;item&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-key:ar.cat"&gt;
   .........
   &lt;body in-progress="true" affects-element="work"&gt;
      &lt;item&gt;
         &lt;IRI&gt;tag:parkj@textalign.net,2015:work:porphyry:on-aristotles-categories&lt;/IRI&gt;
         &lt;name xml:lang="lat"&gt;Commentarium graecum Porphyrii&lt;/name&gt;
         &lt;name xml:lang="eng"&gt;Porphyry's commentary on Aristotle's Categories&lt;/name&gt;
      &lt;/item&gt;
      &lt;item&gt;
         &lt;IRI&gt;tag:parkj@textalign.net,2015:work:dexippus:on-aristotles-categories&lt;/IRI&gt;
         &lt;name xml:lang="lat"&gt;Commentarium graecum Dexippi&lt;/name&gt;
         &lt;name xml:lang="eng"&gt;Dexippus's commentary on Aristotle's Categories&lt;/name&gt;
      &lt;/item&gt;
      &lt;group&gt;
         &lt;item&gt;
            &lt;IRI&gt;tag:parkj@textalign.net,2015:work:ammonius:on-aristotles-categories:lemmata&lt;/IRI&gt;
            &lt;name xml:lang="lat"&gt;Lemmata de commentario graeco Ammonii&lt;/name&gt;
            &lt;name xml:lang="eng"&gt;Lemmata from Ammonius's commentary on Aristotle's
                    Categories&lt;/name&gt;
         &lt;/item&gt;
         &lt;item&gt;
            &lt;IRI&gt;tag:parkj@textalign.net,2015:work:ammonius:on-aristotles-categories:discussions&lt;/IRI&gt;
            &lt;name xml:lang="lat"&gt;Explanationes de commentario graeco Ammonii&lt;/name&gt;
            &lt;name xml:lang="eng"&gt;Discussions in Ammonius's commentary on Aristotle's
                    Categories&lt;/name&gt;
         &lt;/item&gt;
      &lt;/group&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-key/ar.cat.TAN-key.xml">ar.cat.TAN-key</link></para></note></para></section><section xml:id="element-TAN-key"><title><code>&lt;TAN-key&gt;</code></title><para>The element <code>TAN-key</code> specifies that the TAN file contains vocabulary suitable  for inclusion in other TAN files. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-key&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:parkj@textalign.net,2015:TAN-key:ar.cat"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="true" affects-element="work"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-key/ar.cat.TAN-key.xml">ar.cat.TAN-key</link></para></note></para><para><example><title><code>&lt;TAN-key&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:bitext-relation"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="true" affects-element="bitext-relation"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/bitext-relations.TAN-key.xml">bitext-relations.TAN-key</link></para></note></para><para><example><title><code>&lt;TAN-key&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:div-types"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="false" affects-element="div-type"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/div-types.TAN-key.xml">div-types.TAN-key</link></para></note></para><para><example><title><code>&lt;TAN-key&gt;</code></title><programlisting>&lt;TAN-key TAN-version="1 dev" id="tag:textalign.net,2015:tan-key:features"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body in-progress="false" affects-element="feature"&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-key&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../TAN-key/features.TAN-key.xml">features.TAN-key</link></para></note></para></section></section><section><title>TAN-mor elements and attributes summarized</title><section xml:id="element-assert"><title><code>&lt;assert&gt;</code></title><para>The element <code>assert</code> names a pattern that, if found to be false in any <code><link linkend="element-m">&lt;m&gt;</link></code> in a dependent TAN-LM file, will return the enclosed message upon validation of the dependent file, along with an error or warning. Modeled on Schematron <code><link linkend="element-report">&lt;report&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-test-pattern">~test-pattern</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para><caution><para><code><link linkend="attribute-feature-test">@feature-test</link></code> and <code><link linkend="attribute-context">@context</link></code> must point to one or more feature <code>@codes</code> or <code>@xml:ids</code> a space or +</para></caution></section><section xml:id="element-category"><title><code>&lt;category&gt;</code></title><para>The element <code>category</code> groups a set of features that share a common grammatical trait such as gender, number, etc.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="element-feature">&lt;feature&gt;</link></code>, <code><link linkend="element-feature">&lt;feature&gt;</link></code>+)))</synopsis><para>Used by: <code><link linkend="pattern-category-list">~category-list</link></code></para></section><section xml:id="element-feature"><title><code>&lt;feature&gt;</code></title><para>The element <code>feature</code> names, through its IRI + name pattern, a grammatical feature or concept (e.g., plural, subjunctive, 1st person) that is part of a language. In the context of <code><link linkend="element-feature">&lt;feature&gt;</link></code> a <code><link linkend="attribute-code">@code</link></code> is always included. The first <code><link linkend="element-feature">&lt;feature&gt;</link></code> of a <code><link linkend="element-category">&lt;category&gt;</link></code> never has <code><link linkend="attribute-code">@code</link></code>, and refers to the grammatical feature that characterizes the category.</para><para>See main.xml# keywords-feature for a list of standard features, derived  from OLiA.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-feature-pattern">~feature-pattern</link></code><code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code></synopsis><para>Used by: <code><link linkend="pattern-feature-list">~feature-list</link></code>, <code><link linkend="pattern-category">~category</link></code></para><caution><para>Every <code><link linkend="element-feature">&lt;feature&gt;</link></code> inclusion must support every language that has  been declared.</para></caution><para><example><title><code>&lt;feature&gt;</code></title><programlisting>&lt;TAN-mor TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-r-mor:eng:penn"&gt;
   .........
   &lt;body&gt;
      &lt;for-lang&gt;eng&lt;/for-lang&gt;
      &lt;feature code="''"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:morphology:option:quotation-mark-closing&lt;/IRI&gt;
         &lt;name&gt;closing quotation mark&lt;/name&gt;
         &lt;desc&gt;Examples: ' ''&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="--"&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Dash&lt;/IRI&gt;
         &lt;name&gt;dash&lt;/name&gt;
         &lt;desc&gt;Examples: --&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="$"&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Dollar_sign&lt;/IRI&gt;
         &lt;name&gt;dollar&lt;/name&gt;
         &lt;desc&gt;Examples: $ -$ --$ A$ C$ HK$ M$ NZ$ S$ U.S.$ US$&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="["&gt;
         &lt;IRI&gt;tag:textalign.net,2015:morphology:option:bracket-opening&lt;/IRI&gt;
         &lt;name&gt;opening bracket&lt;/name&gt;
         &lt;desc&gt;Examples: ( [ {&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="]"&gt;
         .........
      &lt;/feature&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-mor&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-mor/eng.kalvesmaki.com,2014.2.xml">eng.kalvesmaki.com,2014.2</link></para></note></para></section><section xml:id="element-report"><title><code>&lt;report&gt;</code></title><para>The element <code>report</code> names a pattern that, if found to be true in any <code><link linkend="element-m">&lt;m&gt;</link></code> in a dependent TAN-LM file, will return the enclosed message upon validation of the dependent file, along with an error or warning. Modeled on Schematron <code><link linkend="element-report">&lt;report&gt;</link></code>.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-test-pattern">~test-pattern</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para><caution><para><code><link linkend="attribute-feature-test">@feature-test</link></code> and <code><link linkend="attribute-context">@context</link></code> must point to one or more feature <code>@codes</code> or <code>@xml:ids</code> a space or +</para></caution></section><section xml:id="element-TAN-mor"><title><code>&lt;TAN-mor&gt;</code></title><para>The element <code>TAN-mor</code> specifies that the TAN file contains definitions for the parts of speech for a language, the codes for those parts, and the rules for combining them. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important><para><example><title><code>&lt;TAN-mor&gt;</code></title><programlisting>&lt;TAN-mor TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-r-mor:eng:penn"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-mor&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-mor/eng.kalvesmaki.com,2014.2.xml">eng.kalvesmaki.com,2014.2</link></para></note></para></section><section xml:id="attribute-code"><title><code>@code</code></title><para>The attribute <code>code</code> contains a string that serves as an identifier for <code><link linkend="element-feature">&lt;feature&gt;</link></code>.</para><para>Formal Definition</para><synopsis>string (pattern [^\-\+\s]|[^\+\s]+)</synopsis><para>Used by: <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code></para><caution><para>Codes for (<code><link linkend="attribute-xmlid">@xml:id</link></code> or <code><link linkend="attribute-code">@code</link></code>) features must be case-indifferently unique within a given category.</para></caution><para><example><title><code>@code</code></title><programlisting>&lt;TAN-mor TAN-version="1 dev" id="tag:kalvesmaki.com,2014:tan-r-mor:eng:penn"&gt;
   .........
   &lt;body&gt;
      &lt;for-lang&gt;eng&lt;/for-lang&gt;
      &lt;feature code="''"&gt;
         &lt;IRI&gt;tag:textalign.net,2015:morphology:option:quotation-mark-closing&lt;/IRI&gt;
         &lt;name&gt;closing quotation mark&lt;/name&gt;
         &lt;desc&gt;Examples: ' ''&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="--"&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Dash&lt;/IRI&gt;
         &lt;name&gt;dash&lt;/name&gt;
         &lt;desc&gt;Examples: --&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="$"&gt;
         &lt;IRI&gt;http://dbpedia.org/resource/Dollar_sign&lt;/IRI&gt;
         &lt;name&gt;dollar&lt;/name&gt;
         &lt;desc&gt;Examples: $ -$ --$ A$ C$ HK$ M$ NZ$ S$ U.S.$ US$&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="["&gt;
         &lt;IRI&gt;tag:textalign.net,2015:morphology:option:bracket-opening&lt;/IRI&gt;
         &lt;name&gt;opening bracket&lt;/name&gt;
         &lt;desc&gt;Examples: ( [ {&lt;/desc&gt;
      &lt;/feature&gt;
      &lt;feature code="]"&gt;
         .........
      &lt;/feature&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-mor&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-mor/eng.kalvesmaki.com,2014.2.xml">eng.kalvesmaki.com,2014.2</link></para></note></para></section><section xml:id="attribute-context"><title><code>@context</code></title><para>The attribute <code>context</code> specifies under what conditions a particular <code><link linkend="element-assert">&lt;assert&gt;</link></code> or <code><link linkend="element-report">&lt;report&gt;</link></code> should be enforced. When an <code><link linkend="element-m">&lt;m&gt;</link></code> in a dependent TAN-LM file is validated, if it contains the codes for the features in question, the other conditions of the <code><link linkend="element-assert">&lt;assert&gt;</link></code> or <code><link linkend="element-report">&lt;report&gt;</link></code> will be checked; otherwise, the <code><link linkend="element-assert">&lt;assert&gt;</link></code> or <code><link linkend="element-report">&lt;report&gt;</link></code> will be ignored.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para><caution><para><code><link linkend="attribute-feature-test">@feature-test</link></code> and <code><link linkend="attribute-context">@context</link></code> must point to one or more feature <code>@codes</code> or <code>@xml:ids</code> a space or +</para></caution></section><section xml:id="attribute-feature-qty-test"><title><code>@feature-qty-test</code></title><para>The attribute <code>feature-qty-test</code> specifies a range or sequence of integers (e.g., 2-4). If the quantity of features in an <code><link linkend="element-m">&lt;m&gt;</link></code> matches a number from that sequence, the condition is true, and false otherwise. If the keyword 'last' or 'max' is used, the number of features will be substituted. </para><para>This test is useful for non-category based languages to put a limit on the number of features that can be declared in an <code><link linkend="element-m">&lt;m&gt;</link></code>. It is one of four tests for determining the truth value that will determine whether a <code><link linkend="element-report">&lt;report&gt;</link></code> or <code><link linkend="element-assert">&lt;assert&gt;</link></code> will be acted upon. </para><para>Formal Definition</para><synopsis>string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para><caution><para>Sequences may not include values less than 1.</para></caution><caution><para>Sequences may not include values greater than the maximum allowed.</para></caution><caution><para>Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2.</para></caution></section><section xml:id="attribute-feature-test"><title><code>@feature-test</code></title><para>The attribute <code>feature-test</code> specifies one or more features separated by spaces or the padded + (a plus sign with surrounding spaces). A plain space is treated  as meaning "or" and the padded + as meaning "and." If there is at least one match between the list and the value of the codes in an <code><link linkend="element-m">&lt;m&gt;</link></code> then the condition will be treated as true. The padded plus sign specifies that all the items need to be found in the <code><link linkend="element-m">&lt;m&gt;</link></code>. </para><para>For example, feature-test="A B + C D + E" means that the condition will be true for a given <code><link linkend="element-m">&lt;m&gt;</link></code> only if that <code><link linkend="element-m">&lt;m&gt;</link></code> has A or B and C or D and E present as values. This test is one of four tests for determining the truth value that will trigger the message in a <code><link linkend="element-report">&lt;report&gt;</link></code> or <code><link linkend="element-assert">&lt;assert&gt;</link></code> </para><para>Formal Definition</para><synopsis>string (pattern [^\s\+]+(\s(\+\s)?[^\s\+]+)*)</synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para><caution><para><code><link linkend="attribute-feature-test">@feature-test</link></code> and <code><link linkend="attribute-context">@context</link></code> must point to one or more feature <code>@codes</code> or <code>@xml:ids</code> a space or +</para></caution></section><section xml:id="attribute-matches-m"><title><code>@matches-m</code></title><para>The attribute <code>matches-m</code> takes a regular expression. If an <code><link linkend="element-m">&lt;m&gt;</link></code> matches the pattern, then the condition will be true. </para><para>One of four tests for determining the truth value that will trigger the message in a <code><link linkend="element-report">&lt;report&gt;</link></code> or <code><link linkend="element-assert">&lt;assert&gt;</link></code> </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para><caution><para>Attributes that take a regular expression must use escape sequences recognized by XML schema or TAN escape extensions (\k{}). See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xmlschema-2/#regexs">http://www.w3.org/TR/xmlschema-2/#regexs</link> for details.</para></caution></section><section xml:id="attribute-matches-tok"><title><code>@matches-tok</code></title><para>The attribute <code>matches-tok</code> takes a regular expression. When validating a given <code><link linkend="element-m">&lt;m&gt;</link></code>, a test will be made against each companion <code><link linkend="element-tok">&lt;tok&gt;</link></code> (i.e., those <code><link linkend="element-tok">&lt;tok&gt;</link></code>s that have the same ancestral <code><link linkend="element-ana">&lt;ana&gt;</link></code>). The condition will be treated as true only if there is a match with the resolved value of every such <code><link linkend="element-tok">&lt;tok&gt;</link></code>, and false if there is any nonmatch. </para><para>One of four tests for determining the truth value that will trigger the message in a <code><link linkend="element-report">&lt;report&gt;</link></code> or <code><link linkend="element-assert">&lt;assert&gt;</link></code> </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para><caution><para>Attributes that take a regular expression must use escape sequences recognized by XML schema or TAN escape extensions (\k{}). See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/xmlschema-2/#regexs">http://www.w3.org/TR/xmlschema-2/#regexs</link> for details.</para></caution></section></section><section><title>TAN-c elements and attributes summarized</title><section xml:id="element-TAN-c"><title><code>&lt;TAN-c&gt;</code></title><para>The element <code>TAN-c</code> specifies that the TAN file makes assertions subject a conceptual work. Root element.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-TAN-root">~TAN-root</link></code></synopsis><important><para>Every validated TAN file will include the following message at its root. <quote>This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://textalign.net">http://textalign.net</link> for details.</quote></para></important></section></section><section><title>TAN-c-core elements and attributes summarized</title><section xml:id="element-claim"><title><code>&lt;claim&gt;</code></title><para>The element <code>claim</code> contains one or more claims.</para><para>Formal Definition</para><synopsis>
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
         
            (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?, <code><link linkend="attribute-claimant">@claimant</link></code>?, <code><link linkend="attribute-adverb">@adverb</link></code>?, <code><link linkend="attribute-verb">@verb</link></code>?, <code><link linkend="attribute-where">@where</link></code>?, (
         (<code><link linkend="attribute-subject">@subject</link></code> | <code><link linkend="element-subject">&lt;subject&gt;</link></code>+)? &amp; 
         (<code><link linkend="attribute-object">@object</link></code> | 
            (<code><link linkend="element-object">&lt;object&gt;</link></code> | <code><link linkend="element-claim">&lt;claim&gt;</link></code>+)+)? &amp; <code><link linkend="element-locus">&lt;locus&gt;</link></code>+? &amp; <code><link linkend="element-when">&lt;when&gt;</link></code>* &amp; 
         (<code><link linkend="attribute-claim-basis">@claim-basis</link></code> | <code><link linkend="element-claim-basis">&lt;claim-basis&gt;</link></code>+)?)))</synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-TAN-c-item">~TAN-c-item</link></code>, <code><link linkend="pattern-complex-object">~complex-object</link></code></para><caution><para>Claims involving verbs whose object is constrained must use <code><link linkend="element-object">&lt;object&gt;</link></code>, not <code>@object.</code></para></caution><caution><para>Verbs that have object constraints must not be combined with other verbs in <code>@verb.</code></para></caution><caution><para>Every <code><link linkend="element-claim">&lt;claim&gt;</link></code> must have at least one subject, either <code><link linkend="attribute-subject">@subject</link></code> (self or ancestral <code><link linkend="element-body">&lt;body&gt;</link></code>) or a child <code><link linkend="element-subject">&lt;subject&gt;</link></code></para></caution><caution><para>Any predefined strictures on verbs must be respected.</para></caution><caution><para>Every <code><link linkend="element-claim">&lt;claim&gt;</link></code> must have at least one subject, either <code><link linkend="attribute-subject">@subject</link></code> (self or ancestral <code><link linkend="element-body">&lt;body&gt;</link></code>) or a child <code><link linkend="element-subject">&lt;subject&gt;</link></code></para></caution></section><section xml:id="element-claim-basis"><title><code>&lt;claim-basis&gt;</code></title><para>The element <code>claim-basis</code> points to a textual passage that serves as the rationale for why a claim was made.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, {empty}</synopsis><para>Used by: <code><link linkend="pattern-rationale">~rationale</link></code></para></section><section xml:id="element-locus"><title><code>&lt;locus&gt;</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, {empty}</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para><para><example><title><code>&lt;locus&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 2" pos="3-4"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         &lt;locus work="grc"&gt;
            &lt;tok ref="1 a 5" pos="1-2"/&gt;
         &lt;/locus&gt;
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-modal"><title><code>&lt;modal&gt;</code></title><para>The element <code>modal</code> contains an IRI + name pattern identifying a modal or adverb that qualifies the verb of an assertion.</para><para>See main.xml# keywords-modal for standard vocabulary.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para><para><example><title><code>&lt;modal&gt;</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;verb xml:id="replaces" which="replaces" object-datatype="string"/&gt;
         &lt;modal which="possibly" xml:id="perhaps"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-object"><title><code>&lt;object&gt;</code></title><para>The element <code>object</code> is similar to <code><link linkend="attribute-object">@object</link></code>, but for complex content, mainly concepts that do not lend themselves to the IRI + name pattern, particularly languages and units or passages of text.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="pattern-nontextual-reference">~nontextual-reference</link></code> | {empty})</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-complex-object">~complex-object</link></code></para><caution><para><code><link linkend="element-object">&lt;object&gt;</link></code>s taking strings must match the predefined <code><link linkend="attribute-object-datatype">@object-datatype</link></code> for the verb.</para></caution><caution><para><code><link linkend="element-object">&lt;object&gt;</link></code>s taking strings for verbs that have lexical constraints must match those lexical constraints.</para></caution><para><example><title><code>&lt;object&gt;</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            .........
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            .........
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-person"><title><code>&lt;person&gt;</code></title><para>The element <code>person</code> contains an IRI + name pattern identifying a person. This element is very similar to <code><link linkend="element-agent">&lt;agent&gt;</link></code>, but does not imply that the person had anything to do with the data in the TAN file.</para><para>Although person implies a single individual, this element may be applied to corporate entities, or groups of more than one person.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para><para><example><title><code>&lt;person&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         &lt;person xml:id="andronicus"&gt;
            &lt;IRI&gt;https://inpho.cogs.indiana.edu/thinker/2532&lt;/IRI&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Andronicus_of_Rhodes&lt;/IRI&gt;
            &lt;name&gt;Andronicus of Rhodes&lt;/name&gt;
         &lt;/person&gt;
         &lt;person xml:id="boethus"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Boethus_of_Sidon&lt;/IRI&gt;
            &lt;name&gt;Boethus of Sidon&lt;/name&gt;
         &lt;/person&gt;
         &lt;person xml:id="dexippus"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Dexippus&lt;/IRI&gt;
            &lt;name&gt;Dexippus&lt;/name&gt;
         &lt;/person&gt;
         &lt;person xml:id="herminus"&gt;
            &lt;IRI&gt;http://dbpedia.org/resource/Herminus&lt;/IRI&gt;
            &lt;name&gt;Herminus&lt;/name&gt;
         &lt;/person&gt;
         &lt;person xml:id="porphyry"&gt;
            .........
         &lt;/person&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-place"><title><code>&lt;place&gt;</code></title><para>The element <code>place</code> contains an IRI + name pattern identifying a spatial location, usually somewhere on earth</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="element-scriptum"><title><code>&lt;scriptum&gt;</code></title><para>The element <code>scriptum</code> contains an IRI + name pattern identifying a text-bearing object.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para><para><example><title><code>&lt;scriptum&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;work xml:id="Γ"&gt;
            .........
         &lt;/work&gt;
         &lt;scriptum xml:id="n"&gt;
            &lt;IRI&gt;tag:parkj@textalign.net,2015:scriptum:ita:milan:ambrosianus:L-93&lt;/IRI&gt;
            &lt;name&gt;Ambrosianus L 93&lt;/name&gt;
            &lt;desc&gt;saec. ix&lt;/desc&gt;
         &lt;/scriptum&gt;
         &lt;scriptum xml:id="B"&gt;
            &lt;IRI&gt;tag:parkj@textalign.net,2015:scriptum:ita:venezia:marcianus:201&lt;/IRI&gt;
            &lt;name&gt;Marcianus 201&lt;/name&gt;
            &lt;desc&gt;saec. x&lt;/desc&gt;
         &lt;/scriptum&gt;
         &lt;work xml:id="π" which="Commentarium graecum Porphyrii"/&gt;
         .........
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="element-subject"><title><code>&lt;subject&gt;</code></title><para>The element <code>subject</code> points to text references that act as the subject of the claim.</para><para> Multiple values of <code><link linkend="element-subject">&lt;subject&gt;</link></code> are interpreted to mean "and", resulting in distribution of the claim (e.g., subject="x y" becomes "x [verby]..." and "y [verb]...").</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, {empty}</synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-subject">~subject</link></code></para><caution><para>Every <code><link linkend="element-claim">&lt;claim&gt;</link></code> must have at least one subject, either <code><link linkend="attribute-subject">@subject</link></code> (self or ancestral <code><link linkend="element-body">&lt;body&gt;</link></code>) or a child <code><link linkend="element-subject">&lt;subject&gt;</link></code></para></caution></section><section xml:id="element-topic"><title><code>&lt;topic&gt;</code></title><para>The element <code>topic</code> declares one or more topics, to be used in conjunction with <code>@topic</code> under <code><link linkend="element-align">&lt;align&gt;</link></code> to associate alignments with specific topics instead of verbatim parallels.  </para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="element-unit"><title><code>&lt;unit&gt;</code></title><para>The element <code>unit</code> contains an IRI + name pattern identifying a unit type (e.g., millimeters, seconds, Euros), to be used in conjunction with <code><link linkend="element-object">&lt;object&gt;</link></code> to specify the meaning of a value</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="element-verb"><title><code>&lt;verb&gt;</code></title><para>The element <code>verb</code> contains an IRI + name pattern identifying a property, relationship, action, or something else that is used to say something about something. </para><para>The preferred term "verb" is equivalent to RDF "predicate." The latter term is avoided as misleading, since in ordinary usage the term "predicate" implies everything in a sentence that is not the subject.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-object-constraint">~object-constraint</link></code>?, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code></synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para><caution><para>Claims involving verbs whose object is constrained must use <code><link linkend="element-object">&lt;object&gt;</link></code>, not <code>@object.</code></para></caution><caution><para>Verbs that have object constraints must not be combined with other verbs in <code>@verb.</code></para></caution><para><example><title><code>&lt;verb&gt;</code></title><programlisting>   &lt;head&gt;
      .........
      &lt;declarations&gt;
         .........
         &lt;alias xml:id="comm-omnes" idrefs="π δ αd φd οd ηd σd"/&gt;
         &lt;verb xml:id="omits" which="omits"/&gt;
         &lt;verb xml:id="agrees" which="agrees"/&gt;
         &lt;verb xml:id="replaces" which="replaces" object-datatype="string"/&gt;
         &lt;modal which="possibly" xml:id="perhaps"/&gt;
      &lt;/declarations&gt;
      .........
   &lt;/head&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-adverb"><title><code>@adverb</code></title><para>The attribute <code>adverb</code> names a <code><link linkend="element-modal">&lt;modal&gt;</link></code> that qualifies the claim.</para><para> Multiple values of <code><link linkend="attribute-adverb">@adverb</link></code> are interpreted to mean "and" with intersection. No distribution takes place (e.g., adverb="x y" means "[subject] x &amp; y [verby]...", not "[subject] x [verb]..." and "[subject] y [verb]...").</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para><para><example><title><code>@adverb</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   .........
   &lt;body claimant="lmp"&gt;
      &lt;comment when="2017-03-10-05:00" who="park"&gt;The following two claims interpret
            Minio-Paluello's apparatus criticus entry for 1a2, which suggests that Andronicus and
            Boethus might have omitted τῆς οὐσίας (based on what Porphyry and Dexippus say) and
            asserts that the reading adopted is found in the seven commentators. This interpretation
            sticks close to M-P's original, and does not fill in important gaps. For example,
            Dexippus's remark comes from his commentary, 1.18 (p. 21.20) and is reliant wholly on a
            fragment of Porphyry preserved in Simplicius's commentary, p. 30.1-2. Furthermore, these
            sources show that the claim is not that Andronicus and Boethus omitted the text, or
            relied on sources that had omitted it, but that they observed that there were
            manuscripts that had done so.&lt;/comment&gt;
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            .........
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         .........
      &lt;/claim&gt;
      .........
      &lt;claim subject="B" verb="replaces"&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="Λ" adverb="perhaps" verb="replaces"&gt;
         &lt;locus work="grc"&gt;
            .........
         &lt;/locus&gt;
         &lt;object&gt;τις ἀποδιδῷ&lt;/object&gt;
      &lt;/claim&gt;
      &lt;claim subject="π α φ ο" verb="agrees"&gt;
         .........
      &lt;/claim&gt;
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-claim-basis"><title><code>@claim-basis</code></title><para>The attribute <code>claim-basis</code> points to an entity that serves as the rationale for why a claim was made. </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-rationale">~rationale</link></code></para><para><example><title><code>@claim-basis</code></title><programlisting>   &lt;body claimant="lmp"&gt;
      &lt;comment when="2017-03-10-05:00" who="park"&gt;The following two claims interpret
            Minio-Paluello's apparatus criticus entry for 1a2, which suggests that Andronicus and
            Boethus might have omitted τῆς οὐσίας (based on what Porphyry and Dexippus say) and
            asserts that the reading adopted is found in the seven commentators. This interpretation
            sticks close to M-P's original, and does not fill in important gaps. For example,
            Dexippus's remark comes from his commentary, 1.18 (p. 21.20) and is reliant wholly on a
            fragment of Porphyry preserved in Simplicius's commentary, p. 30.1-2. Furthermore, these
            sources show that the claim is not that Andronicus and Boethus omitted the text, or
            relied on sources that had omitted it, but that they observed that there were
            manuscripts that had done so.&lt;/comment&gt;
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         &lt;locus work="grc"&gt;
            .........
         &lt;/locus&gt;
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         .........
      &lt;/claim&gt;
      .........
   &lt;/body&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-claimant"><title><code>@claimant</code></title><para>The attribute <code>claimant</code> points to an <code><link linkend="element-agent">&lt;agent&gt;</link></code> or <code><link linkend="element-person">&lt;person&gt;</link></code> who makes a claim. <code><link linkend="attribute-claimant">@claimant</link></code> within <code><link linkend="element-body">&lt;body&gt;</link></code> indicates the default persons to be credited or blamed for an assertion.</para><para>Claimants are not to be confused with the editor of a TAN file. If an editor X writes a TAN-c file that says that person Y makes such-and-such a claim, then the implication is that X claims that Y claims that....  </para><para>This attribute is taken into account before all other attributes. That is, <code><link linkend="attribute-claimant">@claimant</link></code> is to be interpreted to mean: "<code><link linkend="attribute-claimant">@claimant</link></code> states the following:...." Multiple values of <code><link linkend="attribute-claimant">@claimant</link></code> are interpreted to mean "and", resulting in distribution of the claim (e.g., claimant="x y" becomes "x claims that..." and "y claims that...").</para><para>If you wish to claim that claimant X claimed that claimant Y claimed that claimant Z...., only the original claimant is given to <code><link linkend="attribute-claimant">@claimant</link></code>, and each of the other claimants are placed in a <code><link linkend="attribute-subject">@subject</link></code> in an embedded <code><link linkend="element-claim">&lt;claim&gt;</link></code> that serves as the object of the master <code><link linkend="element-claim">&lt;claim&gt;</link></code>. </para><para>This attribute is inheritable. See <xref linkend="inheritable_attributes"/></para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para><para><example><title><code>@claimant</code></title><programlisting>&lt;TAN-A-div TAN-version="1 dev" id="tag:parkj@textalign.net,2015:ar.cat.tan-a-div:claims"&gt;
   &lt;head&gt;
      .........
   &lt;/head&gt;
   &lt;body claimant="lmp"&gt;
      &lt;comment when="2017-03-10-05:00" who="park"&gt;The following two claims interpret
            Minio-Paluello's apparatus criticus entry for 1a2, which suggests that Andronicus and
            Boethus might have omitted τῆς οὐσίας (based on what Porphyry and Dexippus say) and
            asserts that the reading adopted is found in the seven commentators. This interpretation
            sticks close to M-P's original, and does not fill in important gaps. For example,
            Dexippus's remark comes from his commentary, 1.18 (p. 21.20) and is reliant wholly on a
            fragment of Porphyry preserved in Simplicius's commentary, p. 30.1-2. Furthermore, these
            sources show that the claim is not that Andronicus and Boethus omitted the text, or
            relied on sources that had omitted it, but that they observed that there were
            manuscripts that had done so.&lt;/comment&gt;
      &lt;claim subject="andronicus boethus" adverb="perhaps" verb="omits" claim-basis="dexippus porphyry"&gt;
         .........
      &lt;/claim&gt;
      &lt;claim subject="herminus comm-omnes" verb="agrees"&gt;
         .........
      &lt;/claim&gt;
      .........
   &lt;/body&gt;
&lt;/TAN-A-div&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-object"><title><code>@object</code></title><para>The attribute <code>object</code> takes one or more ID refs of entities defined in <code><link linkend="element-head">&lt;head&gt;</link></code> that serve as the grammatical object of a claim. For example, if you wish to say that work A is a commentary on work B, then the object would have the ID ref for work B. If you wish to make more complex assertions, use <code><link linkend="element-object">&lt;object&gt;</link></code>.</para><para> Multiple values of <code><link linkend="attribute-object">@object</link></code> are interpreted to mean "and", resulting in distribution of the claim (e.g., object="x y" becomes "[subject] [verb] x" and "[subject] [verb] y...").</para><para>In RDF, the concept of object (the third element of a triple) is required. In TAN-c, it is not required, since some <code><link linkend="element-verb">&lt;verb&gt;</link></code>s may be intransitive (e.g., "Charlie slept.").</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-object">~object</link></code></para></section><section xml:id="attribute-object-datatype"><title><code>@object-datatype</code></title><para>The attribute <code>object-datatype</code> specifies the type of data that the object must take. This attribute is intended to specify that a particular verb governs raw units, not entities definable by the IRI + name pattern. Use this attribute if and only if the verb may not govern objects defined in <code><link linkend="element-declarations">&lt;declarations&gt;</link></code>.</para><para>Formal Definition</para><synopsis>string (pattern string|boolean|decimal|float|double|duration|dateTime|time|date|gYearMonth|gYear|gMonthDay|gDay|gMonth|hexBinary|base64Binary|anyURI|QName|normalizedString|token|language|NMTOKEN|NMTOKENS|Name|NCName|ID|IDREF|IDREFS|ENTITY|ENTITIES|integer|nonPositiveInteger|negativeInteger|long|int|short|byte|nonNegativeInteger|unsignedLong|unsignedInt|unsignedShort|unsignedByte|positiveInteger)</synopsis><para>Used by: <code><link linkend="pattern-object-constraint">~object-constraint</link></code></para><caution><para>Claims involving verbs whose object is constrained must use <code><link linkend="element-object">&lt;object&gt;</link></code>, not <code>@object.</code></para></caution><caution><para>Verbs that have object constraints must not be combined with other verbs in <code>@verb.</code></para></caution><caution><para><code><link linkend="element-object">&lt;object&gt;</link></code>s taking strings must match the predefined <code><link linkend="attribute-object-datatype">@object-datatype</link></code> for the verb.</para></caution><para><example><title><code>@object-datatype</code></title><programlisting>      &lt;declarations&gt;
         .........
         &lt;verb xml:id="agrees" which="agrees"/&gt;
         &lt;verb xml:id="replaces" which="replaces" object-datatype="string"/&gt;
         &lt;modal which="possibly" xml:id="perhaps"/&gt;
      &lt;/declarations&gt;
</programlisting></example><note><para>Taken from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="../../examples/TAN-A-div/ar.cat.tan-a-div.claims.xml">ar.cat.tan-a-div.claims</link></para></note></para></section><section xml:id="attribute-object-lexical-constraint"><title><code>@object-lexical-constraint</code></title><para>The attribute <code>object-lexical-constraint</code> specifies a regular expression that constrains the value of any <code><link linkend="element-object">&lt;object&gt;</link></code>. </para><para>Note that the regular expression will be strictly followed, e.g., "\d+" will be satisfied by "a1". If you wish to constrain the entire value, be sure to use ^ and $, e.g., "^\d+$". </para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-object-constraint">~object-constraint</link></code></para><caution><para>Claims involving verbs whose object is constrained must use <code><link linkend="element-object">&lt;object&gt;</link></code>, not <code>@object.</code></para></caution><caution><para>Verbs that have object constraints must not be combined with other verbs in <code>@verb.</code></para></caution><caution><para><code><link linkend="element-object">&lt;object&gt;</link></code>s taking strings for verbs that have lexical constraints must match those lexical constraints.</para></caution></section><section xml:id="attribute-subject"><title><code>@subject</code></title><para>The attribute <code>subject</code> points to one or more ID refs of entities defined in <code><link linkend="element-head">&lt;head&gt;</link></code> that serve as the grammatical subject of a claim. <code><link linkend="attribute-subject">@subject</link></code> within <code><link linkend="element-body">&lt;body&gt;</link></code> indicates the default <code>subject(</code>s) for <code><link linkend="element-claim">&lt;claim&gt;</link></code>s. </para><para> Multiple values of <code><link linkend="attribute-subject">@subject</link></code> are interpreted to mean "and", resulting in distribution of the claim (e.g., subject="x y" becomes "x [verby]..." and "y [verb]...").</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-subject">~subject</link></code></para><caution><para>Every <code><link linkend="element-claim">&lt;claim&gt;</link></code> must have at least one subject, either <code><link linkend="attribute-subject">@subject</link></code> (self or ancestral <code><link linkend="element-body">&lt;body&gt;</link></code>) or a child <code><link linkend="element-subject">&lt;subject&gt;</link></code></para></caution></section><section xml:id="attribute-units"><title><code>@units</code></title><para>The attribute <code>units</code> points to the ID ref of a <code><link linkend="element-unit">&lt;unit&gt;</link></code>, defining the type of units.</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-nontextual-reference">~nontextual-reference</link></code></para></section><section xml:id="attribute-verb"><title><code>@verb</code></title><para>The attribute <code>verb</code> points to one or more <code><link linkend="element-verb">&lt;verb&gt;</link></code>s that serve to assert something of the <code>@subject.</code></para><para>The preferred term "verb" is equivalent to RDF "predicate." The latter term is avoided as being misleading -- most who use TAN will understand "predicate," grammatically speaking, to refer to everything in a sentence that is not the subject.</para><para> Multiple values of <code><link linkend="attribute-verb">@verb</link></code> are interpreted to mean "and", resulting in distribution of the claim (e.g., verb="x y" becomes "[subject] x ..." and "[subject] y...").</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para><caution><para>Any predefined strictures on verbs must be respected.</para></caution><caution><para>Every <code><link linkend="element-claim">&lt;claim&gt;</link></code> must have at least one subject, either <code><link linkend="attribute-subject">@subject</link></code> (self or ancestral <code><link linkend="element-body">&lt;body&gt;</link></code>) or a child <code><link linkend="element-subject">&lt;subject&gt;</link></code></para></caution></section><section xml:id="attribute-where"><title><code>@where</code></title><para>The attribute <code>where</code> restricts the <code><link linkend="element-claim">&lt;claim&gt;</link></code> to a specific <code><link linkend="element-place">&lt;place&gt;</link></code>.
 Multiple values of <code><link linkend="attribute-where">@where</link></code> are interpreted to mean "or" with union. No distribution takes place (e.g., where="x y" means "[subject] x or y [verby]...", not "[subject] x [verb]..." and "[subject] y [verb]...").</para><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section></section><section><title>TAN patterns</title><section xml:id="pattern-agent-list"><title><code>~agent-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-agent">&lt;agent&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-agent-ref"><title><code>~agent-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-who">@who</link></code></synopsis><para>Used by: <code><link linkend="pattern-comment">~comment</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code></para></section><section xml:id="pattern-agent-role-list"><title><code>~agent-role-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-agentrole">&lt;agentrole&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-alignment"><title><code>~alignment</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-align">&lt;align&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para></section><section xml:id="pattern-alignment-attributes-non-class-2"><title><code>~alignment-attributes-non-class-2</code></title><para>TAN-A-tok: alignments may claim bitext relations and reuse type</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmlid">@xml:id</link></code>?, <code><link linkend="attribute-bitext-relation">@bitext-relation</link></code>?, <code><link linkend="attribute-reuse-type">@reuse-type</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-alignment">~alignment</link></code></para></section><section xml:id="pattern-alignment-content-non-class-2"><title><code>~alignment-content-non-class-2</code></title><para>TAN-A-tok: alignments must contain one or more toks</para><para>Formal Definition</para><synopsis>(<code><link linkend="element-tok">&lt;tok&gt;</link></code> | <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code>)+</synopsis><para>Used by: <code><link linkend="pattern-alignment">~alignment</link></code></para></section><section xml:id="pattern-alignment-inclusion-opt"><title><code>~alignment-inclusion-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-inclusion">~inclusion</link></code></synopsis><para>Used by: <code><link linkend="pattern-alignment">~alignment</link></code></para></section><section xml:id="pattern-anchor-div-ref-item"><title><code>~anchor-div-ref-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-anchor-div-ref">&lt;anchor-div-ref&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-realignment">~realignment</link></code></para></section><section xml:id="pattern-any-attribute"><title><code>~any-attribute</code></title><para>Formal Definition</para><synopsis>@[ANY]</synopsis><para>Used by: <code><link linkend="pattern-any-element">~any-element</link></code></para></section><section xml:id="pattern-any-content"><title><code>~any-content</code></title><para>Formal Definition</para><synopsis>(&lt;[ANY]&gt;* &amp; text)</synopsis><para>Used by: <code><link linkend="pattern-TAN-tail">~TAN-tail</link></code>, <code><link linkend="pattern-any-element">~any-element</link></code></para></section><section xml:id="pattern-any-element"><title><code>~any-element</code></title><para>Formal Definition</para><synopsis>&lt;[ANY]&gt;</synopsis><para>Used by: <code><link linkend="pattern-any-content">~any-content</link></code></para></section><section xml:id="pattern-assert"><title><code>~assert</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-assert">&lt;assert&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para></section><section xml:id="pattern-attr-cert"><title><code>~attr-cert</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-cert">@cert</link></code></synopsis><para>Used by: <code><link linkend="pattern-cert-claim">~cert-claim</link></code></para></section><section xml:id="pattern-attr-cert2"><title><code>~attr-cert2</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-cert2">@cert2</link></code></synopsis><para>Used by: <code><link linkend="pattern-cert-claim">~cert-claim</link></code></para></section><section xml:id="pattern-bitext-relation-attr"><title><code>~bitext-relation-attr</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-bitext-relation">@bitext-relation</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code></para></section><section xml:id="pattern-body-group"><title><code>~body-group</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="element-group">&lt;group&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code></para></section><section xml:id="pattern-body-group-opt"><title><code>~body-group-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-group">&lt;group&gt;</link></code><code><link linkend="element-group">&lt;group&gt;</link></code><code><link linkend="element-group">&lt;group&gt;</link></code>*{empty}<code><link linkend="element-group">&lt;group&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-category"><title><code>~category</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-category">&lt;category&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-category-list">~category-list</link></code></para></section><section xml:id="pattern-category-feature"><title><code>~category-feature</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-feature">&lt;feature&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-category">~category</link></code></para></section><section xml:id="pattern-category-list"><title><code>~category-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-category">&lt;category&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para></section><section xml:id="pattern-cert-claim"><title><code>~cert-claim</code></title><para>Formal Definition</para><synopsis>
   (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-tok-with-src-and-cont">~tok-with-src-and-cont</link></code>, <code><link linkend="pattern-cert-opt">~cert-opt</link></code>, <code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code></para></section><section xml:id="pattern-cert-content"><title><code>~cert-content</code></title><para>Formal Definition</para><synopsis>double (pattern 1|0|(0\.\d*[1-9]))</synopsis><para>Used by: <code><link linkend="pattern-attr-cert">~attr-cert</link></code>, <code><link linkend="pattern-attr-cert2">~attr-cert2</link></code></para></section><section xml:id="pattern-cert-opt"><title><code>~cert-opt</code></title><para>Formal Definition</para><synopsis>
   
      (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?</synopsis><para>Used by: <code><link linkend="pattern-tok-cert-opt">~tok-cert-opt</link></code></para></section><section xml:id="pattern-certainty-stamp"><title><code>~certainty-stamp</code></title><para>Formal Definition</para><synopsis>
   
      (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?, <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-alignment">~alignment</link></code>, <code><link linkend="pattern-test-pattern">~test-pattern</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code>, <code><link linkend="pattern-lexeme">~lexeme</link></code>, <code><link linkend="pattern-morph">~morph</link></code></para></section><section xml:id="pattern-change-list"><title><code>~change-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-change">&lt;change&gt;</link></code>+</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-char-ref"><title><code>~char-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-chars">@chars</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-attr-core">~tok-attr-core</link></code></para></section><section xml:id="pattern-checksum"><title><code>~checksum</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-checksum">&lt;checksum&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code></para></section><section xml:id="pattern-claim"><title><code>~claim</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-claim">&lt;claim&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-TAN-c-item">~TAN-c-item</link></code>, <code><link linkend="pattern-complex-object">~complex-object</link></code></para></section><section xml:id="pattern-claim-div-ref-item"><title><code>~claim-div-ref-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-complex-text-ref">~complex-text-ref</link></code></para></section><section xml:id="pattern-claimant"><title><code>~claimant</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-claimant">@claimant</link></code></synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-code"><title><code>~code</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-code">@code</link></code></synopsis><para>Used by: <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code></para></section><section xml:id="pattern-comment"><title><code>~comment</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-comment">&lt;comment&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-alignment">~alignment</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-category">~category</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt">~decl-filt</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-TAN-head">~TAN-head</link></code>, <code><link linkend="pattern-TAN-body">~TAN-body</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-decl-opt">~decl-opt</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-complex-object"><title><code>~complex-object</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="element-object">&lt;object&gt;</link></code> | <code><link linkend="element-claim">&lt;claim&gt;</link></code>+)</synopsis><para>Used by: <code><link linkend="pattern-object">~object</link></code></para></section><section xml:id="pattern-complex-rationale"><title><code>~complex-rationale</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-claim-basis">&lt;claim-basis&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-rationale">~rationale</link></code></para></section><section xml:id="pattern-complex-subject"><title><code>~complex-subject</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="element-subject">&lt;subject&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-subject">~subject</link></code></para></section><section xml:id="pattern-complex-text-ref"><title><code>~complex-text-ref</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> | <code><link linkend="element-tok">&lt;tok&gt;</link></code>)</synopsis><para>Used by: <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code></para></section><section xml:id="pattern-complex-textual-reference-set"><title><code>~complex-textual-reference-set</code></title><para>Formal Definition</para><synopsis>(
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} | <code><link linkend="attribute-work">@work</link></code>), 
   (<code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code> | <code><link linkend="element-tok">&lt;tok&gt;</link></code>)+</synopsis><para>Used by: <code><link linkend="pattern-textual-reference">~textual-reference</link></code></para></section><section xml:id="pattern-continuation"><title><code>~continuation</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-cont">@cont</link></code></synopsis><para>Used by: <code><link linkend="pattern-continuation-opt">~continuation-opt</link></code></para></section><section xml:id="pattern-continuation-opt"><title><code>~continuation-opt</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="attribute-cont">@cont</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-with-src-and-cont">~tok-with-src-and-cont</link></code>, <code><link linkend="pattern-tok-with-cont-but-no-src">~tok-with-cont-but-no-src</link></code></para></section><section xml:id="pattern-decl-alias"><title><code>~decl-alias</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-alias">&lt;alias&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-core">~declaration-core</link></code></para></section><section xml:id="pattern-decl-brel"><title><code>~decl-brel</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-bitext-relation">&lt;bitext-relation&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-class-1"><title><code>~decl-class-1</code></title><para>TAN-class-1: Class 1 files must declare a single work, perhaps one version, one or more divisions, one or more recommended tokenizations, perhaps one filter, and perhaps one </para><para>Formal Definition</para><synopsis>(<code><link linkend="element-work">&lt;work&gt;</link></code> &amp; <code><link linkend="element-version">&lt;version&gt;</link></code>? &amp; <code><link linkend="element-div-type">&lt;div-type&gt;</link></code>+ &amp; <code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-filter">&lt;filter&gt;</link></code>?)</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-div"><title><code>~decl-div</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-div-type">&lt;div-type&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para></section><section xml:id="pattern-decl-filt"><title><code>~decl-filt</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-filter">&lt;filter&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para></section><section xml:id="pattern-decl-filt-norm"><title><code>~decl-filt-norm</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-normalization">&lt;normalization&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-filter-content">~decl-filter-content</link></code></para></section><section xml:id="pattern-decl-filt-repl"><title><code>~decl-filt-repl</code></title><para>TAN-class-1: Replacements that have been made to an XML source file. </para><para>Formal Definition</para><synopsis><code><link linkend="element-replace">&lt;replace&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-filter-content">~decl-filter-content</link></code></para></section><section xml:id="pattern-decl-filt-tlit"><title><code>~decl-filt-tlit</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-transliteration">&lt;transliteration&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-filter-content">~decl-filter-content</link></code></para></section><section xml:id="pattern-decl-filter-content"><title><code>~decl-filter-content</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="element-normalization">&lt;normalization&gt;</link></code>* &amp; <code><link linkend="element-replace">&lt;replace&gt;</link></code>* &amp; <code><link linkend="element-transliteration">&lt;transliteration&gt;</link></code>*)</synopsis><para>Used by: <code><link linkend="pattern-decl-filt">~decl-filt</link></code></para></section><section xml:id="pattern-decl-group-type"><title><code>~decl-group-type</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-group-type">&lt;group-type&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code>, <code><link linkend="pattern-TAN-key-decl">~TAN-key-decl</link></code></para></section><section xml:id="pattern-decl-id-ref-opt"><title><code>~decl-id-ref-opt</code></title><para>TAN-A-div: declarations by default have ids</para><para>TAN-A-tok: all declarations must have ids</para><para>TAN-c: declarations by default have ids</para><para>TAN-key: all declarations must have ids</para><para>TAN-mor: no declarations may have ids</para><para>TAN-core: Option to allow an <code><link linkend="attribute-xmlid">@xml:id</link></code> in children of <code><link linkend="element-declarations">&lt;declarations&gt;</link></code></para><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmlid">@xml:id</link></code><code><link linkend="attribute-xmlid">@xml:id</link></code><code><link linkend="attribute-xmlid">@xml:id</link></code><code><link linkend="attribute-xmlid">@xml:id</link></code>{empty}{empty}</synopsis><para>Used by: <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code></para></section><section xml:id="pattern-decl-lexi"><title><code>~decl-lexi</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-lexicon">&lt;lexicon&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-mode"><title><code>~decl-mode</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-modal">&lt;modal&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-morph"><title><code>~decl-morph</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-morphology">&lt;morphology&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-non-class-1"><title><code>~decl-non-class-1</code></title><para>TAN-class-1: Reserved for declarations specific to individual types of class 1 files</para><para>Formal Definition</para><synopsis>{empty}</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-opt"><title><code>~decl-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-declarations">&lt;declarations&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-decl-pattern-default"><title><code>~decl-pattern-default</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (
{[TAN-A-div (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-A-tok (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-key (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-mor (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   {empty}} OR 

{[TAN-core (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   {empty}}, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-decl-brel">~decl-brel</link></code>, <code><link linkend="pattern-decl-reus">~decl-reus</link></code>, <code><link linkend="pattern-decl-place">~decl-place</link></code>, <code><link linkend="pattern-decl-topic">~decl-topic</link></code>, <code><link linkend="pattern-decl-verb">~decl-verb</link></code>, <code><link linkend="pattern-decl-unit">~decl-unit</link></code>, <code><link linkend="pattern-decl-pers">~decl-pers</link></code>, <code><link linkend="pattern-decl-mode">~decl-mode</link></code>, <code><link linkend="pattern-decl-scri">~decl-scri</link></code>, <code><link linkend="pattern-decl-work">~decl-work</link></code>, <code><link linkend="pattern-decl-vers">~decl-vers</link></code></para></section><section xml:id="pattern-decl-pattern-language"><title><code>~decl-pattern-language</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (
{[TAN-A-div (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-A-tok (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-key (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   <code><link linkend="attribute-xmlid">@xml:id</link></code>} OR 

{[TAN-mor (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   {empty}} OR 

{[TAN-core (<code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>):]   {empty}}, 
         (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; (<code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>*, 
            
               ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>)))))</synopsis><para>Used by: <code><link linkend="pattern-decl-filt-tlit">~decl-filt-tlit</link></code></para></section><section xml:id="pattern-decl-pattern-no-id"><title><code>~decl-pattern-no-id</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
      
         ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>)))</synopsis></section><section xml:id="pattern-decl-pers"><title><code>~decl-pers</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-person">&lt;person&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-place"><title><code>~decl-place</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-place">&lt;place&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-rename-div-n"><title><code>~decl-rename-div-n</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-reus"><title><code>~decl-reus</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code>+</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-scri"><title><code>~decl-scri</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-scriptum">&lt;scriptum&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-supp-div-type"><title><code>~decl-supp-div-type</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-decl-tok-def"><title><code>~decl-tok-def</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code>, <code><link linkend="pattern-entity-tok-def">~entity-tok-def</link></code></para></section><section xml:id="pattern-decl-topic"><title><code>~decl-topic</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-topic">&lt;topic&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-unit"><title><code>~decl-unit</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-unit">&lt;unit&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-verb"><title><code>~decl-verb</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-verb">&lt;verb&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code></para></section><section xml:id="pattern-decl-vers"><title><code>~decl-vers</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-version">&lt;version&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para></section><section xml:id="pattern-decl-work"><title><code>~decl-work</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-work">&lt;work&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-c-decl-core">~TAN-c-decl-core</link></code>, <code><link linkend="pattern-decl-class-1">~decl-class-1</link></code></para></section><section xml:id="pattern-declaration-core"><title><code>~declaration-core</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-alias">&lt;alias&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-decl-opt">~decl-opt</link></code></para></section><section xml:id="pattern-declaration-items"><title><code>~declaration-items</code></title><para>TAN-core: declaration-items to be filled out by each TAN-class-X.rnc file</para><para>TAN-LM-core: TAN-LM files must each have at least one lexicon and one TAN-mor declaration</para><para>Formal Definition</para><synopsis>(<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; )(<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; <code><link linkend="element-bitext-relation">&lt;bitext-relation&gt;</link></code>+ &amp; <code><link linkend="element-reuse-type">&lt;reuse-type&gt;</link></code>++ &amp; <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*)<code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*(
   (<code><link linkend="element-work">&lt;work&gt;</link></code> &amp; <code><link linkend="element-version">&lt;version&gt;</link></code>? &amp; <code><link linkend="element-div-type">&lt;div-type&gt;</link></code>+ &amp; <code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-filter">&lt;filter&gt;</link></code>?) &amp; {empty}){empty}(<code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>* &amp; <code><link linkend="element-suppress-div-types">&lt;suppress-div-types&gt;</link></code>* &amp; <code><link linkend="element-rename-div-ns">&lt;rename-div-ns&gt;</link></code>* &amp; <code><link linkend="element-lexicon">&lt;lexicon&gt;</link></code>+ &amp; <code><link linkend="element-morphology">&lt;morphology&gt;</link></code>+ &amp; <code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*)</synopsis><para>Used by: <code><link linkend="pattern-decl-opt">~decl-opt</link></code></para></section><section xml:id="pattern-div-item-ref"><title><code>~div-item-ref</code></title><para>TAN-core: String that specifies a range of divs using the div-ref pattern joined by a hyphen or a comma.</para><para>TAN-core: String that specifies a single <code><link linkend="element-div">&lt;div&gt;</link></code></para><para>Formal Definition</para><synopsis>string (pattern (\w+([^\w\-]\w+)*)|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-pointer-to-div-item">~pointer-to-div-item</link></code></para></section><section xml:id="pattern-div-range-ref"><title><code>~div-range-ref</code></title><para>TAN-core: For more see <xref linkend="leaf_div_uniqueness_rule"/></para><para>Formal Definition</para><synopsis>string (pattern (\w+([^\w\-]\w+)*)(((\s*-\s*)|(\s*,\s+))(\w+([^\w\-]\w+)*))*|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-pointer-to-div-range">~pointer-to-div-range</link></code></para></section><section xml:id="pattern-div-type-equiv"><title><code>~div-type-equiv</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-equate-div-types">&lt;equate-div-types&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-div-type-ref"><title><code>~div-type-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-div-type-ref">@div-type-ref</link></code></synopsis><para>Used by: <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code></para></section><section xml:id="pattern-div-type-ref-cluster"><title><code>~div-type-ref-cluster</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-div-type-ref">&lt;div-type-ref&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-div-type-equiv">~div-type-equiv</link></code></para></section><section xml:id="pattern-ed-agent"><title><code>~ed-agent</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-ed-who">@ed-who</link></code></synopsis><para>Used by: <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code></para></section><section xml:id="pattern-ed-stamp"><title><code>~ed-stamp</code></title><para>TAN-core: Editorial stamp: who created or edited the enclosed data and when. </para><para>Formal Definition</para><synopsis><code><link linkend="attribute-ed-who">@ed-who</link></code>, <code><link linkend="attribute-ed-when">@ed-when</link></code></synopsis><para>Used by: <code><link linkend="pattern-work-equiv">~work-equiv</link></code>, <code><link linkend="pattern-div-type-equiv">~div-type-equiv</link></code>, <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-anchor-div-ref-item">~anchor-div-ref-item</link></code>, <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-claim-div-ref-item">~claim-div-ref-item</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-category">~category</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-complex-subject">~complex-subject</link></code>, <code><link linkend="pattern-object-element">~object-element</link></code>, <code><link linkend="pattern-locus">~locus</link></code>, <code><link linkend="pattern-complex-rationale">~complex-rationale</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt">~decl-filt</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code>, <code><link linkend="pattern-tok-attr-core">~tok-attr-core</link></code>, <code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-IRI-gen-ref">~IRI-gen-ref</link></code>, <code><link linkend="pattern-loc-self">~loc-self</link></code>, <code><link linkend="pattern-loc-src">~loc-src</link></code>, <code><link linkend="pattern-metadata-desc">~metadata-desc</link></code>, <code><link linkend="pattern-TAN-root">~TAN-root</link></code>, <code><link linkend="pattern-TAN-head">~TAN-head</link></code>, <code><link linkend="pattern-TAN-body">~TAN-body</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-relationship">~relationship</link></code>, <code><link linkend="pattern-decl-opt">~decl-opt</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code>, <code><link linkend="pattern-decl-alias">~decl-alias</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-ed-time"><title><code>~ed-time</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-ed-when">@ed-when</link></code></synopsis><para>Used by: <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code></para></section><section xml:id="pattern-element-scope"><title><code>~element-scope</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-affects-element">@affects-element</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-group-attributes">~group-attributes</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code></para></section><section xml:id="pattern-entity-digital-generic-ref"><title><code>~entity-digital-generic-ref</code></title><para>TAN-core: Reference to an external digital entity that is not a TAN file</para><para>Formal Definition</para><synopsis>
   ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+) | <code><link linkend="attribute-which">@which</link></code>)</synopsis><para>Used by: <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code></para></section><section xml:id="pattern-entity-digital-tan-other-ref"><title><code>~entity-digital-tan-other-ref</code></title><para>TAN-core: Reference to an external digital entity that is a TAN file; unlike other types, the keyword-ref option much be turned on and off for specific elements (e.g., not advisable for <code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code>)</para><para>Formal Definition</para><synopsis>
   (<code><link linkend="attribute-href">@href</link></code> | (<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-checksum">&lt;checksum&gt;</link></code>*, <code><link linkend="element-location">&lt;location&gt;</link></code>+))</synopsis><para>Used by: <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code></para></section><section xml:id="pattern-entity-digital-tan-self-ref"><title><code>~entity-digital-tan-self-ref</code></title><para>TAN-core: Reference to self as digital entity (i.e., TAN file)</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="element-master-location">&lt;master-location&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-entity-nondigital-ref"><title><code>~entity-nondigital-ref</code></title><para>TAN-core: Reference to an external non-digital entity (e.g., agents, roles, works, topics)</para><para>Formal Definition</para><synopsis>
   ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>)</synopsis><para>Used by: <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-checksum">~checksum</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-relationship">~relationship</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code></para></section><section xml:id="pattern-entity-tok-def"><title><code>~entity-tok-def</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-token-definition">&lt;token-definition&gt;</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code></para></section><section xml:id="pattern-error-flag"><title><code>~error-flag</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-flags">@flags</link></code></synopsis><para>Used by: <code><link linkend="pattern-change-list">~change-list</link></code></para></section><section xml:id="pattern-feature"><title><code>~feature</code></title><para>TAN-mor: TAN-R-mor files declare the morphological features that are allowed for a given language</para><para>Formal Definition</para><synopsis><code><link linkend="element-feature">&lt;feature&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-feature-list">~feature-list</link></code>, <code><link linkend="pattern-category">~category</link></code></para></section><section xml:id="pattern-feature-list"><title><code>~feature-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-feature">&lt;feature&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para></section><section xml:id="pattern-feature-pattern"><title><code>~feature-pattern</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-code">@code</link></code>, (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
         
            ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>))))</synopsis><para>Used by: <code><link linkend="pattern-feature">~feature</link></code></para></section><section xml:id="pattern-feature-pattern-no-code"><title><code>~feature-pattern-no-code</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | (<code><link linkend="element-comment">&lt;comment&gt;</link></code>* &amp; 
      
         ((<code><link linkend="element-IRI">&lt;IRI&gt;</link></code>+, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>) | <code><link linkend="attribute-which">@which</link></code>)))</synopsis><para>Used by: <code><link linkend="pattern-category-feature">~category-feature</link></code></para></section><section xml:id="pattern-feature-qty-test"><title><code>~feature-qty-test</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-feature-qty-test">@feature-qty-test</link></code></synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para></section><section xml:id="pattern-feature-test"><title><code>~feature-test</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-feature-test">@feature-test</link></code></synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para></section><section xml:id="pattern-filter"><title><code>~filter</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-context">@context</link></code></synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para></section><section xml:id="pattern-func-param-flags"><title><code>~func-param-flags</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-flags">@flags</link></code></synopsis><para>Used by: <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code></para></section><section xml:id="pattern-func-param-pattern"><title><code>~func-param-pattern</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-regex">@regex</link></code></synopsis><para>Used by: <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code></para></section><section xml:id="pattern-func-replace"><title><code>~func-replace</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-replace">&lt;replace&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-filt-repl">~decl-filt-repl</link></code></para></section><section xml:id="pattern-grammar-attr"><title><code>~grammar-attr</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-morphology">@morphology</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-morph">~morph</link></code></para></section><section xml:id="pattern-group-attributes"><title><code>~group-attributes</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-type">@type</link></code>?, <code><link linkend="attribute-affects-element">@affects-element</link></code>?<code><link linkend="attribute-type">@type</link></code>, <code><link linkend="attribute-n">@n</link></code>?<code><link linkend="attribute-type">@type</link></code>, <code><link linkend="attribute-n">@n</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-body-group">~body-group</link></code></para></section><section xml:id="pattern-group-ref"><title><code>~group-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-group">@group</link></code></synopsis><para>Used by: <code><link linkend="pattern-non-class-2-opt">~non-class-2-opt</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-help-opt"><title><code>~help-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-help">@help</link></code></synopsis><para>Used by: <code><link linkend="pattern-inclusion">~inclusion</link></code></para></section><section xml:id="pattern-href-opt"><title><code>~href-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-href">@href</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-loc-self">~loc-self</link></code>, <code><link linkend="pattern-loc-src">~loc-src</link></code></para></section><section xml:id="pattern-id-option"><title><code>~id-option</code></title><para>TAN-class-2: Option to include an internal id. Not needed in TAN-LM files.</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmlid">@xml:id</link></code>{empty}</synopsis></section><section xml:id="pattern-inclusion"><title><code>~inclusion</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-include">@include</link></code>, <code><link linkend="attribute-help">@help</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-work-equiv">~work-equiv</link></code>, <code><link linkend="pattern-div-type-equiv">~div-type-equiv</link></code>, <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-realignment">~realignment</link></code>, <code><link linkend="pattern-alignment-inclusion-opt">~alignment-inclusion-opt</link></code>, <code><link linkend="pattern-TAN-key-item">~TAN-key-item</link></code>, <code><link linkend="pattern-feature-pattern">~feature-pattern</link></code>, <code><link linkend="pattern-feature-pattern-no-code">~feature-pattern-no-code</link></code>, <code><link linkend="pattern-category">~category</link></code>, <code><link linkend="pattern-test-pattern">~test-pattern</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-decl-filt-norm">~decl-filt-norm</link></code>, <code><link linkend="pattern-func-replace">~func-replace</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code>, <code><link linkend="pattern-decl-pattern-default">~decl-pattern-default</link></code>, <code><link linkend="pattern-decl-pattern-no-id">~decl-pattern-no-id</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code>, <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-key-item">~key-item</link></code>, <code><link linkend="pattern-source-item">~source-item</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code>, <code><link linkend="pattern-see-also-item">~see-also-item</link></code>, <code><link linkend="pattern-relationship">~relationship</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code>, <code><link linkend="pattern-decl-alias">~decl-alias</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-inclusion-att"><title><code>~inclusion-att</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-include">@include</link></code></synopsis><para>Used by: <code><link linkend="pattern-inclusion">~inclusion</link></code></para></section><section xml:id="pattern-inclusion-item"><title><code>~inclusion-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-inclusion-list">~inclusion-list</link></code></para></section><section xml:id="pattern-inclusion-list"><title><code>~inclusion-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-inclusion">&lt;inclusion&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-internal-id"><title><code>~internal-id</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmlid">@xml:id</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-id-ref-opt">~decl-id-ref-opt</link></code>, <code><link linkend="pattern-source-id-opt">~source-id-opt</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code>, <code><link linkend="pattern-decl-div">~decl-div</link></code>, <code><link linkend="pattern-id-option">~id-option</link></code>, <code><link linkend="pattern-decl-group-type">~decl-group-type</link></code>, <code><link linkend="pattern-inclusion-item">~inclusion-item</link></code>, <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-role-list">~role-list</link></code>, <code><link linkend="pattern-decl-alias">~decl-alias</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-internal-idrefs"><title><code>~internal-idrefs</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-idrefs">@idrefs</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-alias">~decl-alias</link></code></para></section><section xml:id="pattern-IRI-gen"><title><code>~IRI-gen</code></title><para>TAN-core: Any generic IRI identifier.</para><para>Formal Definition</para><synopsis>anyURI (pattern [a-zA-Z][\-.+a-zA-Z0-9]+:\S+)</synopsis><para>Used by: <code><link linkend="pattern-IRI-gen-ref">~IRI-gen-ref</link></code></para></section><section xml:id="pattern-IRI-gen-ref"><title><code>~IRI-gen-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-IRI">&lt;IRI&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code>, <code><link linkend="pattern-entity-nondigital-ref">~entity-nondigital-ref</link></code></para></section><section xml:id="pattern-item"><title><code>~item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-align">&lt;align&gt;</link></code>+<code><link linkend="element-item">&lt;item&gt;</link></code><code><link linkend="element-div">&lt;div&gt;</link></code>{empty}<code><link linkend="element-ana">&lt;ana&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code>, <code><link linkend="pattern-body-group">~body-group</link></code></para></section><section xml:id="pattern-item-picker"><title><code>~item-picker</code></title><para>TAN-core: String that specifies a single item from a sequence: digits or "<code>last(</code>-digit)?" Similar to seq-picker.</para><para>Formal Definition</para><synopsis>string (pattern ((last|max)|((last|max)-\d+)|(\d+))|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-item-pos-ref">~item-pos-ref</link></code></para></section><section xml:id="pattern-item-pos-ref"><title><code>~item-pos-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-pos">@pos</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para></section><section xml:id="pattern-key-item"><title><code>~key-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-key">&lt;key&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-key-list">~key-list</link></code></para></section><section xml:id="pattern-key-list"><title><code>~key-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-key">&lt;key&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-keyword-ref"><title><code>~keyword-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-which">@which</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code>, <code><link linkend="pattern-entity-nondigital-ref">~entity-nondigital-ref</link></code>, <code><link linkend="pattern-metadata-human">~metadata-human</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code></para></section><section xml:id="pattern-lang-of-content"><title><code>~lang-of-content</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmllang">@xml:lang</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-nontextual-reference">~nontextual-reference</link></code>, <code><link linkend="pattern-metadata-desc">~metadata-desc</link></code></para></section><section xml:id="pattern-lang-outside"><title><code>~lang-outside</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-source-list">~source-list</link></code>, <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code>, <code><link linkend="pattern-decl-pattern-language">~decl-pattern-language</link></code>, <code><link linkend="pattern-decl-morph">~decl-morph</link></code>, <code><link linkend="pattern-decl-lexi">~decl-lexi</link></code></para></section><section xml:id="pattern-lexeme"><title><code>~lexeme</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-l">&lt;l&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-lexicon-attr"><title><code>~lexicon-attr</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-lexicon">@lexicon</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-lexeme">~lexeme</link></code></para></section><section xml:id="pattern-loc-self"><title><code>~loc-self</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-master-location">&lt;master-location&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-self-ref">~entity-digital-tan-self-ref</link></code></para></section><section xml:id="pattern-loc-src"><title><code>~loc-src</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-location">&lt;location&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code></para></section><section xml:id="pattern-locus"><title><code>~locus</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="element-locus">&lt;locus&gt;</link></code>+</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-matches-m"><title><code>~matches-m</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-matches-m">@matches-m</link></code></synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para></section><section xml:id="pattern-matches-tok"><title><code>~matches-tok</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-matches-tok">@matches-tok</link></code></synopsis><para>Used by: <code><link linkend="pattern-test-pattern">~test-pattern</link></code></para></section><section xml:id="pattern-metadata-desc"><title><code>~metadata-desc</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, (<code><link linkend="attribute-xmllang">@xml:lang</link></code>?, 
   string (pattern (.|\n)+))</synopsis><para>Used by: <code><link linkend="pattern-metadata-human">~metadata-human</link></code></para></section><section xml:id="pattern-metadata-human"><title><code>~metadata-human</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-name">&lt;name&gt;</link></code>+, <code><link linkend="element-desc">&lt;desc&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-entity-digital-tan-other-ref">~entity-digital-tan-other-ref</link></code>, <code><link linkend="pattern-entity-digital-generic-ref">~entity-digital-generic-ref</link></code>, <code><link linkend="pattern-entity-digital-tan-self-ref">~entity-digital-tan-self-ref</link></code>, <code><link linkend="pattern-entity-nondigital-ref">~entity-nondigital-ref</link></code>, <code><link linkend="pattern-entity-tok-def">~entity-tok-def</link></code></para></section><section xml:id="pattern-modal-claim"><title><code>~modal-claim</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-adverb">@adverb</link></code></synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-morph"><title><code>~morph</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-m">&lt;m&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-n"><title><code>~n</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-n">@n</link></code></synopsis><para>Used by: <code><link linkend="pattern-text-div">~text-div</link></code>, <code><link linkend="pattern-group-attributes">~group-attributes</link></code></para></section><section xml:id="pattern-n-val"><title><code>~n-val</code></title><para>TAN-core: Acceptable values of <code><link linkend="attribute-n">@n</link></code>, used by class 1 and class 2 files; this is related to div-range-ref, in that it allows ranges of items, but ignores "last", "max", or "all" keyterms.</para><para>Formal Definition</para><synopsis>string (pattern (\w+|\d+-\d+)(\s+(\w+|\d+-\d+))*)</synopsis><para>Used by: <code><link linkend="pattern-name-change">~name-change</link></code>, <code><link linkend="pattern-n">~n</link></code></para></section><section xml:id="pattern-name-change"><title><code>~name-change</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-rename">&lt;rename&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code></para></section><section xml:id="pattern-non-class-2-opt"><title><code>~non-class-2-opt</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-group">@group</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-alignment">~alignment</link></code></para></section><section xml:id="pattern-nonsource-rights"><title><code>~nonsource-rights</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-rights-excluding-sources">&lt;rights-excluding-sources&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-nontextual-reference"><title><code>~nontextual-reference</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="attribute-xmllang">@xml:lang</link></code> | <code><link linkend="attribute-units">@units</link></code>)?, text</synopsis><para>Used by: <code><link linkend="pattern-object-element">~object-element</link></code></para></section><section xml:id="pattern-object"><title><code>~object</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="attribute-object">@object</link></code> | 
   (<code><link linkend="element-object">&lt;object&gt;</link></code> | <code><link linkend="element-claim">&lt;claim&gt;</link></code>+)+)</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-object-constraint"><title><code>~object-constraint</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-object-datatype">@object-datatype</link></code>, <code><link linkend="attribute-object-lexical-constraint">@object-lexical-constraint</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-decl-verb">~decl-verb</link></code></para></section><section xml:id="pattern-object-datatype"><title><code>~object-datatype</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-object-datatype">@object-datatype</link></code></synopsis><para>Used by: <code><link linkend="pattern-object-constraint">~object-constraint</link></code></para></section><section xml:id="pattern-object-element"><title><code>~object-element</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-object">&lt;object&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-complex-object">~complex-object</link></code></para></section><section xml:id="pattern-object-lexical-constraint"><title><code>~object-lexical-constraint</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-object-lexical-constraint">@object-lexical-constraint</link></code></synopsis><para>Used by: <code><link linkend="pattern-object-constraint">~object-constraint</link></code></para></section><section xml:id="pattern-other-body-attributes"><title><code>~other-body-attributes</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-bitext-relation">@bitext-relation</link></code>, <code><link linkend="attribute-reuse-type">@reuse-type</link></code>?, ?<code><link linkend="attribute-affects-element">@affects-element</link></code>?<code><link linkend="attribute-xmllang">@xml:lang</link></code>{empty}<code><link linkend="attribute-lexicon">@lexicon</link></code>, <code><link linkend="attribute-morphology">@morphology</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-period-filter"><title><code>~period-filter</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-when">&lt;when&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code></para></section><section xml:id="pattern-place-filter"><title><code>~place-filter</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-where">@where</link></code></synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-pointer-to-div-item"><title><code>~pointer-to-div-item</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="attribute-ref">@ref</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para></section><section xml:id="pattern-pointer-to-div-range"><title><code>~pointer-to-div-range</code></title><para>TAN-class-2:    Pointer (link) to a div in a <code>TAN-T(</code>EI) file</para><para>Formal Definition</para><synopsis>{empty}<code><link linkend="attribute-ref">@ref</link></code></synopsis><para>Used by: <code><link linkend="pattern-anchor-div-ref-item">~anchor-div-ref-item</link></code>, <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-claim-div-ref-item">~claim-div-ref-item</link></code>, <code><link linkend="pattern-tok-regular">~tok-regular</link></code></para></section><section xml:id="pattern-progress"><title><code>~progress</code></title><para>TAN-core: specifies whether the creation and editing of the data is still in progress. Default value is true.</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-in-progress">@in-progress</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body">~TAN-body</link></code></para></section><section xml:id="pattern-rationale"><title><code>~rationale</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="attribute-claim-basis">@claim-basis</link></code> | <code><link linkend="element-claim-basis">&lt;claim-basis&gt;</link></code>+)</synopsis><para>Used by: <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-realignment"><title><code>~realignment</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-realign">&lt;realign&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-reanchor-div-ref-item"><title><code>~reanchor-div-ref-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-div-ref">&lt;div-ref&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-realignment">~realignment</link></code></para></section><section xml:id="pattern-relationship"><title><code>~relationship</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-relationship">&lt;relationship&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-see-also-item">~see-also-item</link></code></para></section><section xml:id="pattern-report"><title><code>~report</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-report">&lt;report&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code></para></section><section xml:id="pattern-reuse-type-attr"><title><code>~reuse-type-attr</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-reuse-type">@reuse-type</link></code></synopsis><para>Used by: <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-alignment-attributes-non-class-2">~alignment-attributes-non-class-2</link></code></para></section><section xml:id="pattern-rights-holder"><title><code>~rights-holder</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-rights-holder">@rights-holder</link></code></synopsis><para>Used by: <code><link linkend="pattern-nonsource-rights">~nonsource-rights</link></code>, <code><link linkend="pattern-source-rights">~source-rights</link></code></para></section><section xml:id="pattern-role-list"><title><code>~role-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-role">&lt;role&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-role-ref"><title><code>~role-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-roles">@roles</link></code></synopsis><para>Used by: <code><link linkend="pattern-agent-list">~agent-list</link></code>, <code><link linkend="pattern-agent-role-list">~agent-role-list</link></code></para></section><section xml:id="pattern-see-also-item"><title><code>~see-also-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-see-also">&lt;see-also&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-see-also-list">~see-also-list</link></code></para></section><section xml:id="pattern-see-also-list"><title><code>~see-also-list</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-see-also">&lt;see-also&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-seg-ref"><title><code>~seg-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-seg">@seg</link></code></synopsis><para>Used by: <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-claim-div-ref-item">~claim-div-ref-item</link></code></para></section><section xml:id="pattern-seq-picker"><title><code>~seq-picker</code></title><para>TAN-core: String that specifies a range of items in a sequence: digits or "<code>last(</code>-digit)?" joined by hyphens (ranges) or commas. Similar to item-picker.</para><para>Formal Definition</para><synopsis>string (pattern ((last|max|all|\*)|((last|max)-\d+)|(\d+))(\s*-\s*(((last|max))|((last|max)-\d+)|(\d+)))?(\s*[, ]\s*(((last|max))|((last|max)-\d+)|(\d+))(\s+-\s+(((last|max))|((last|max)-\d+)|(\d+)))?)*|.*\?\?\?.*)</synopsis><para>Used by: <code><link linkend="pattern-seg-ref">~seg-ref</link></code>, <code><link linkend="pattern-feature-qty-test">~feature-qty-test</link></code>, <code><link linkend="pattern-seq-pos-ref">~seq-pos-ref</link></code>, <code><link linkend="pattern-char-ref">~char-ref</link></code></para></section><section xml:id="pattern-seq-pos-ref"><title><code>~seq-pos-ref</code></title><para>Formal Definition</para><synopsis>{empty}<code><link linkend="attribute-pos">@pos</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code></para></section><section xml:id="pattern-set-of-claims"><title><code>~set-of-claims</code></title><para>Formal Definition</para><synopsis>?, ?, +</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-simple-object"><title><code>~simple-object</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-object">@object</link></code></synopsis><para>Used by: <code><link linkend="pattern-object">~object</link></code></para></section><section xml:id="pattern-simple-rationale"><title><code>~simple-rationale</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-claim-basis">@claim-basis</link></code></synopsis><para>Used by: <code><link linkend="pattern-rationale">~rationale</link></code></para></section><section xml:id="pattern-simple-subject"><title><code>~simple-subject</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-subject">@subject</link></code></synopsis><para>Used by: <code><link linkend="pattern-subject">~subject</link></code></para></section><section xml:id="pattern-simple-textual-reference"><title><code>~simple-textual-reference</code></title><para>Formal Definition</para><synopsis>(
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} | <code><link linkend="attribute-work">@work</link></code>), <code><link linkend="attribute-ref">@ref</link></code>, <code><link linkend="attribute-seg">@seg</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-textual-reference">~textual-reference</link></code></para></section><section xml:id="pattern-source-id-opt"><title><code>~source-id-opt</code></title><para>TAN-A-div: TAN-A-div sources must be named</para><para>TAN-A-tok: TAN-A-tok sources must be named</para><para>TAN-core: Parameter to indicate whether <code><link linkend="element-source">&lt;source&gt;</link></code> should be allowed to take xml:id (forbidden for TAN files with only one source; mandated otherwise)</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-xmlid">@xml:id</link></code><code><link linkend="attribute-xmlid">@xml:id</link></code><code><link linkend="attribute-xmlid">@xml:id</link></code>?{empty}</synopsis><para>Used by: <code><link linkend="pattern-source-item">~source-item</link></code></para></section><section xml:id="pattern-source-item"><title><code>~source-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-source">&lt;source&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-source-list">~source-list</link></code></para></section><section xml:id="pattern-source-list"><title><code>~source-list</code></title><para>TAN-A-div: TAN-A-div files must have one or more sources</para><para>TAN-A-tok: TAN-A-tok files take exactly two sources</para><para>TAN-c: claims made of textual objects should be done in the context of TAN-A-div files</para><para>TAN-LM-lang: TAN-LM files point only to one source</para><para>TAN-LM: TAN-LM files point only to one source</para><para>TAN-class-3: Class 3 files allow zero or many sources</para><para>Formal Definition</para><synopsis><code><link linkend="element-source">&lt;source&gt;</link></code>+<code><link linkend="element-source">&lt;source&gt;</link></code>, <code><link linkend="element-source">&lt;source&gt;</link></code>{empty}{empty}<code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code><code><link linkend="element-source">&lt;source&gt;</link></code><code><link linkend="element-source">&lt;source&gt;</link></code>*<code><link linkend="element-source">&lt;source&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-head">~TAN-head</link></code></para></section><section xml:id="pattern-source-ref"><title><code>~source-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-src">@src</link></code></synopsis><para>Used by: <code><link linkend="pattern-anchor-div-ref-item">~anchor-div-ref-item</link></code>, <code><link linkend="pattern-tok-with-src-and-cont">~tok-with-src-and-cont</link></code></para></section><section xml:id="pattern-source-refs"><title><code>~source-refs</code></title><para>TAN-LM-core: Because TAN-LM files depend on only one source, no id references to sources are needed</para><para>Formal Definition</para><synopsis><code><link linkend="attribute-src">@src</link></code>{empty}{empty}</synopsis><para>Used by: <code><link linkend="pattern-div-type-ref-cluster">~div-type-ref-cluster</link></code>, <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-reanchor-div-ref-item">~reanchor-div-ref-item</link></code>, <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code>, <code><link linkend="pattern-decl-supp-div-type">~decl-supp-div-type</link></code>, <code><link linkend="pattern-decl-rename-div-n">~decl-rename-div-n</link></code>, <code><link linkend="pattern-tok-source-ref-opt">~tok-source-ref-opt</link></code>, <code><link linkend="pattern-decl-tok-def">~decl-tok-def</link></code></para></section><section xml:id="pattern-source-rights"><title><code>~source-rights</code></title><para>TAN-class-2: All sources are TAN files, so no source rights should be declared--they're already stated</para><para>Formal Definition</para><synopsis>{empty}<code><link linkend="element-rights-source-only">&lt;rights-source-only&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-source-item">~source-item</link></code></para></section><section xml:id="pattern-split"><title><code>~split</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-split-leaf-div-at">&lt;split-leaf-div-at&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-subject"><title><code>~subject</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="attribute-subject">@subject</link></code> | <code><link linkend="element-subject">&lt;subject&gt;</link></code>+)</synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-TAN-body"><title><code>~TAN-body</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-body">&lt;body&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para></section><section xml:id="pattern-TAN-body-core"><title><code>~TAN-body-core</code></title><para>TAN-A-div: Redefining TAN-body-core not only defines what is in the body of a TAN-A-div but also excludes groups from it.</para><para>Formal Definition</para><synopsis><code><link linkend="element-equate-works">&lt;equate-works&gt;</link></code>*, <code><link linkend="element-equate-div-types">&lt;equate-div-types&gt;</link></code>*, <code><link linkend="element-split-leaf-div-at">&lt;split-leaf-div-at&gt;</link></code>*, <code><link linkend="element-realign">&lt;realign&gt;</link></code>*, <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>?<code><link linkend="pattern-TAN-R-mor-body">~TAN-R-mor-body</link></code>
{[TAN-A-tok (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>} OR 

{[TAN-key (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   <code><link linkend="attribute-affects-element">@affects-element</link></code>?} OR 

{[TAN-T (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   <code><link linkend="attribute-xmllang">@xml:lang</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>):]   <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>}, (
{[TAN-A-tok (<code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>):]   <code><link linkend="element-group">&lt;group&gt;</link></code>} OR 

{[TAN-key (<code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>):]   <code><link linkend="element-group">&lt;group&gt;</link></code>} OR 

{[TAN-class-2 (<code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>):]   <code><link linkend="element-group">&lt;group&gt;</link></code>*} OR 

{[TAN-core (<code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-body-group-opt">~body-group-opt</link></code>):]   <code><link linkend="element-group">&lt;group&gt;</link></code>} | 
{[TAN-A-tok (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-align">&lt;align&gt;</link></code>} OR 

{[TAN-c (<code><link linkend="pattern-item">~item</link></code>):]   +} OR 

{[TAN-key (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-item">&lt;item&gt;</link></code>} OR 

{[TAN-T (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-div">&lt;div&gt;</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-item">~item</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-item">~item</link></code>):]   <code><link linkend="element-ana">&lt;ana&gt;</link></code>})+</synopsis><para>Used by: <code><link linkend="pattern-TAN-body">~TAN-body</link></code></para></section><section xml:id="pattern-TAN-c-decl"><title><code>~TAN-c-decl</code></title><para>Formal Definition</para><synopsis/><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-TAN-c-decl-core"><title><code>~TAN-c-decl-core</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="element-work">&lt;work&gt;</link></code>* &amp; <code><link linkend="element-place">&lt;place&gt;</link></code>* &amp; <code><link linkend="element-unit">&lt;unit&gt;</link></code>* &amp; <code><link linkend="element-person">&lt;person&gt;</link></code>* &amp; <code><link linkend="element-modal">&lt;modal&gt;</link></code>* &amp; <code><link linkend="element-version">&lt;version&gt;</link></code>* &amp; <code><link linkend="element-scriptum">&lt;scriptum&gt;</link></code>* &amp; <code><link linkend="element-topic">&lt;topic&gt;</link></code>* &amp; <code><link linkend="element-verb">&lt;verb&gt;</link></code>*)</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code>, <code><link linkend="pattern-TAN-c-decl">~TAN-c-decl</link></code></para></section><section xml:id="pattern-TAN-c-item"><title><code>~TAN-c-item</code></title><para>Formal Definition</para><synopsis>+</synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para></section><section xml:id="pattern-TAN-head"><title><code>~TAN-head</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-head">&lt;head&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para></section><section xml:id="pattern-TAN-key-decl"><title><code>~TAN-key-decl</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-group-type">&lt;group-type&gt;</link></code>*</synopsis><para>Used by: <code><link linkend="pattern-declaration-items">~declaration-items</link></code></para></section><section xml:id="pattern-TAN-key-item"><title><code>~TAN-key-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-item">&lt;item&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para></section><section xml:id="pattern-TAN-LM-item"><title><code>~TAN-LM-item</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-ana">&lt;ana&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code></para></section><section xml:id="pattern-TAN-R-mor-body"><title><code>~TAN-R-mor-body</code></title><para>TAN-mor: TAN-R-mor body consists of zero or more assert, report, category, or options</para><para>Formal Definition</para><synopsis><code><link linkend="element-for-lang">&lt;for-lang&gt;</link></code>+, 
   ((<code><link linkend="element-feature">&lt;feature&gt;</link></code>* | <code><link linkend="element-category">&lt;category&gt;</link></code>*) &amp; <code><link linkend="element-assert">&lt;assert&gt;</link></code>* &amp; <code><link linkend="element-report">&lt;report&gt;</link></code>*)</synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-TAN-root"><title><code>~TAN-root</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-id">@id</link></code>, <code><link linkend="attribute-TAN-version">@TAN-version</link></code>, <code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="element-head">&lt;head&gt;</link></code>, <code><link linkend="element-body">&lt;body&gt;</link></code>, <code><link linkend="element-tail">&lt;tail&gt;</link></code>?</synopsis><para>Used by: <code><link linkend="element-TAN-A-div">&lt;TAN-A-div&gt;</link></code>, <code><link linkend="element-TAN-A-tok">&lt;TAN-A-tok&gt;</link></code>, <code><link linkend="element-TAN-c">&lt;TAN-c&gt;</link></code>, <code><link linkend="element-TAN-key">&lt;TAN-key&gt;</link></code>, <code><link linkend="element-TAN-mor">&lt;TAN-mor&gt;</link></code>, <code><link linkend="element-TAN-T">&lt;TAN-T&gt;</link></code>, <code><link linkend="element-TAN-LM">&lt;TAN-LM&gt;</link></code></para></section><section xml:id="pattern-TAN-tail"><title><code>~TAN-tail</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tail">&lt;tail&gt;</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para></section><section xml:id="pattern-TAN-ver"><title><code>~TAN-ver</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-TAN-version">@TAN-version</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para></section><section xml:id="pattern-test-pattern"><title><code>~test-pattern</code></title><para>TAN-mor: Test pattern attributes for determining whether to return the message provided by text.</para><para>Formal Definition</para><synopsis><code><link linkend="pattern-certainty-stamp">~certainty-stamp</link></code>?, 
   (<code><link linkend="pattern-inclusion">~inclusion</link></code> | 
      (<code><link linkend="attribute-context">@context</link></code>?, (<code><link linkend="attribute-matches-m">@matches-m</link></code> | <code><link linkend="attribute-matches-tok">@matches-tok</link></code> | <code><link linkend="attribute-feature-test">@feature-test</link></code> | <code><link linkend="attribute-feature-qty-test">@feature-qty-test</link></code>), text))</synopsis><para>Used by: <code><link linkend="pattern-assert">~assert</link></code>, <code><link linkend="pattern-report">~report</link></code></para></section><section xml:id="pattern-text-div"><title><code>~text-div</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-div">&lt;div&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-item">~item</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code></para></section><section xml:id="pattern-textual-reference"><title><code>~textual-reference</code></title><para>Formal Definition</para><synopsis>(<code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code> | <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code>){empty}</synopsis><para>Used by: <code><link linkend="pattern-complex-subject">~complex-subject</link></code>, <code><link linkend="pattern-object-element">~object-element</link></code>, <code><link linkend="pattern-locus">~locus</link></code>, <code><link linkend="pattern-complex-rationale">~complex-rationale</link></code></para></section><section xml:id="pattern-tok-attr-core"><title><code>~tok-attr-core</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-ed-stamp">~ed-stamp</link></code>?, <code><link linkend="attribute-chars">@chars</link></code>?</synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code>, <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para></section><section xml:id="pattern-tok-cert-opt"><title><code>~tok-cert-opt</code></title><para>Formal Definition</para><synopsis>{empty}
   
      (<code><link linkend="attribute-cert">@cert</link></code> | (<code><link linkend="attribute-cert">@cert</link></code>, <code><link linkend="attribute-cert2">@cert2</link></code>))?</synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code></para></section><section xml:id="pattern-tok-regular"><title><code>~tok-regular</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tok">&lt;tok&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-split">~split</link></code>, <code><link linkend="pattern-complex-text-ref">~complex-text-ref</link></code>, <code><link linkend="pattern-alignment-content-non-class-2">~alignment-content-non-class-2</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-tok-sequence"><title><code>~tok-sequence</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tok">&lt;tok&gt;</link></code>, <code><link linkend="element-tok">&lt;tok&gt;</link></code>*, <code><link linkend="element-tok">&lt;tok&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-alignment-content-non-class-2">~alignment-content-non-class-2</link></code>, <code><link linkend="pattern-TAN-LM-item">~TAN-LM-item</link></code></para></section><section xml:id="pattern-tok-sequence-attr-core"><title><code>~tok-sequence-attr-core</code></title><para>Formal Definition</para><synopsis><code><link linkend="pattern-tok-attr-core">~tok-attr-core</link></code>, 
{[TAN-LM-lang (<code><link linkend="pattern-pointer-to-div-item">~pointer-to-div-item</link></code>):]   {empty}} OR 

{[TAN-class-2 (<code><link linkend="pattern-pointer-to-div-item">~pointer-to-div-item</link></code>):]   <code><link linkend="attribute-ref">@ref</link></code>}, 
   (<code><link linkend="attribute-val">@val</link></code> | <code><link linkend="attribute-pos">@pos</link></code> | (<code><link linkend="attribute-val">@val</link></code>, <code><link linkend="attribute-pos">@pos</link></code>))</synopsis><para>Used by: <code><link linkend="pattern-tok-with-src-and-cont">~tok-with-src-and-cont</link></code>, <code><link linkend="pattern-tok-with-cont-but-no-src">~tok-with-cont-but-no-src</link></code>, <code><link linkend="pattern-tok-without-cont-or-src">~tok-without-cont-or-src</link></code></para></section><section xml:id="pattern-tok-source-ref-opt"><title><code>~tok-source-ref-opt</code></title><para>Formal Definition</para><synopsis>{empty}
{[TAN-class-2 (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   <code><link linkend="attribute-src">@src</link></code>} OR 

{[TAN-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}} OR 

{[TAN-LM-core (<code><link linkend="pattern-source-refs">~source-refs</link></code>):]   {empty}}</synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code></para></section><section xml:id="pattern-tok-with-cont-but-no-src"><title><code>~tok-with-cont-but-no-src</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tok">&lt;tok&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code></para></section><section xml:id="pattern-tok-with-src-and-cont"><title><code>~tok-with-src-and-cont</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tok">&lt;tok&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code></para></section><section xml:id="pattern-tok-without-cont-or-src"><title><code>~tok-without-cont-or-src</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-tok">&lt;tok&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-sequence">~tok-sequence</link></code></para></section><section xml:id="pattern-token-value-ref"><title><code>~token-value-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-val">@val</link></code></synopsis><para>Used by: <code><link linkend="pattern-tok-regular">~tok-regular</link></code>, <code><link linkend="pattern-tok-sequence-attr-core">~tok-sequence-attr-core</link></code></para></section><section xml:id="pattern-type"><title><code>~type</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-type">@type</link></code></synopsis><para>Used by: <code><link linkend="pattern-group-attributes">~group-attributes</link></code>, <code><link linkend="pattern-text-div">~text-div</link></code></para></section><section xml:id="pattern-units"><title><code>~units</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-units">@units</link></code></synopsis><para>Used by: <code><link linkend="pattern-nontextual-reference">~nontextual-reference</link></code></para></section><section xml:id="pattern-URI-tag"><title><code>~URI-tag</code></title><para>TAN-core: Tag URN, mandatory pattern for the IRI name of every TAN file </para><para>Formal Definition</para><synopsis>anyURI (pattern tag:([\-a-zA-Z0-9._%+]+@)?[\-a-zA-Z0-9.]+\.[A-Za-z]{2,4},\d{4}(-(0\d|1[0-2]))?(-([0-2]\d|3[01]))?:\S+)</synopsis><para>Used by: <code><link linkend="pattern-TAN-root">~TAN-root</link></code></para></section><section xml:id="pattern-verb"><title><code>~verb</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-verb">@verb</link></code></synopsis><para>Used by: <code><link linkend="pattern-set-of-claims">~set-of-claims</link></code>, <code><link linkend="pattern-other-body-attributes">~other-body-attributes</link></code>, <code><link linkend="pattern-claim">~claim</link></code></para></section><section xml:id="pattern-when-claim"><title><code>~when-claim</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-when">@when</link></code></synopsis><para>Used by: <code><link linkend="pattern-comment">~comment</link></code>, <code><link linkend="pattern-change-list">~change-list</link></code></para></section><section xml:id="pattern-work-equiv"><title><code>~work-equiv</code></title><para>Formal Definition</para><synopsis><code><link linkend="element-equate-works">&lt;equate-works&gt;</link></code></synopsis><para>Used by: <code><link linkend="pattern-TAN-body-core">~TAN-body-core</link></code></para></section><section xml:id="pattern-work-ref"><title><code>~work-ref</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-work">@work</link></code></synopsis><para>Used by: <code><link linkend="pattern-simple-textual-reference">~simple-textual-reference</link></code>, <code><link linkend="pattern-complex-textual-reference-set">~complex-textual-reference-set</link></code></para></section><section xml:id="pattern-work-refs"><title><code>~work-refs</code></title><para>Formal Definition</para><synopsis><code><link linkend="attribute-work">@work</link></code></synopsis><para>Used by: <code><link linkend="pattern-work-equiv">~work-equiv</link></code></para></section></section></chapter>