Below is a list of 123 specifically defined TAN errors.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.

Token-based assertions of multiple class 2 TAN documents that share the same class 1 source may be compared or collated only if those class 2 documents adopt identical token definitions.General rule not affecting specific attibutes or elements.No variables, keys, functions, or named templates depend upon this error.

Assertions of multiple TAN-A documents that share the same class 1 source may be compared or collated only if they suppress, or fail to suppress, the same div types.General rule not affecting specific attibutes or elements.No variables, keys, functions, or named templates depend upon this error.

Mismatched sets of statistics may not be merged.General rule not affecting specific attibutes or elements.No variables, keys, functions, or named templates depend upon this error.

Every @href in a catalog.tan.xml file must point to a document that is available.Affects: @hrefUsed by template ŧ catalog-expansion-terse, ŧ cut-faulty-hrefs.Used by function tan:collection().

@root should match the target's root element nameAffects: @rootUsed by template ŧ catalog-expansion-terse.

In a catalog.tan.xml, @id should match the target's root element @idAffects: @idUsed by template ŧ catalog-expansion-terse.

Different TAN files should have unique @ids..Affects: @idUsed by template ŧ catalog-expansion-terse.

@href values in catalog.tan.xml should be uniqueAffects: @hrefUsed by template ŧ catalog-expansion-terse.

If a local catalog.tan.xml file lacks a reference to a TAN file being validated, a warning will appear.Affects: @idUsed by template ŧ core-expansion-verbose.

A TAN file being validated verbosely will include errors reported in any local catalog.tan.xmlGeneral rule not affecting specific attibutes or elements.Used by template ŧ core-expansion-verbose.

Every character must be locatable in every token in every ref in every source.Affects: @chars<tok>Used by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation, ŧ mark-dependencies-pass-2-for-validation.

Class 1 files must share the same source as any redivision or companion version.Affects: <redivision> <companion-version>Used by template ŧ core-expansion-terse.

Class 1 files must share the same work as any model, redivision, or companion version.Affects: <model> <redivision> <companion-version>Used by template ŧ core-expansion-terse.

Class 1 files must share the same work-version, if supplied, as any redivision.Affects: <redivision>Used by template ŧ core-expansion-terse.

Class 1 files must have identical transcriptions, after TAN normalization, as any redivision.Affects: <redivision>Used by template ŧ class-1-expansion-verbose-pass-3, ŧ class-1-expansion-verbose-pass-1.

If a class 1 file diverges from the structure of its model a warning will be generated specifying where differences exist.Affects: <model>Used by template ŧ class-1-expansion-verbose-pass-2.

Most div references are unique.Affects: @n<div>Used by template ŧ core-expansion-normal.

Every leaf div must have at least some non-space text.Affects: <div>Used by template ŧ core-expansion-normal.

No text may begin with a modifying character.Affects: <div>Used by template ŧ core-expansion-normal.

No text may have a spacing character followed by a modifying character.Affects: <div>Used by template ŧ core-expansion-normal.

No text may have Unicode characters that are disallowed, e.g., U+A0, NO BREAK SPACE.Affects: <div>Used by template ŧ core-expansion-normal.

A class 1 <source> may not point to a TAN file.Affects: <source>Used by template ŧ check-referred-doc.

An @n's value should not appear in the text.Affects: @n<div>Used by template ŧ class-1-expansion-verbose-pass-2.

A <div>'s reference (self and ancestor @ns, concatenated) should not appear in the text.Affects: @n<div>Used by template ŧ class-1-expansion-verbose-pass-2.

An @n taking digit values should not begin with 0.Affects: @n<div>Used by template ŧ dependency-adjustments-pass-1, ŧ resolve-numerals, ŧ core-expansion-terse.

No reference may point to a mixture of leaf and non-leaf <div>s.Affects: <div>Used by template ŧ core-expansion-normal.

Sources are integral parts of a class 2 TAN file. Access to at least one non-faulty copy is absolutely mandatory.Affects: <source>Used by template ŧ check-referred-doc.

No source may be given more than one token definition.Affects: <token-definition>Used by template ŧ core-expansion-terse.

@new may not take the same value as what it replaces.Affects: @new<rename>Used by template ŧ core-expansion-terse.

The values of @n in <equate> should not have duplicates.Affects: @n<equate>Used by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

At least one @n value in an equate should be found in every source.Affects: @n<equate>Used by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

@by may be applied only to those @n and @ref values that are calculable as integers.Affects: @by<rename>Used by template ŧ core-expansion-terse.

In adjustment actions involving @n, at least one value should be found in each source.Affects: @n<rename> <skip> <equate>Used by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

In a <rename> the quantity of values in @ref and @new must be identical.Affects: @new @ref<rename>Used by template ŧ core-expansion-terse.

No adjustment action should result in the mixing of leaf <div>s and non-leaf <div>s.Affects: @new<reassign> <rename> <adjustments> <to>Used by template ŧ strip-divs-to-reset.

Only the first of multiple adjustment actions will be applied. Action priority: skip, ref-based rename, then for every @n n-based rename, equate.Affects: <rename> <skip> <equate>Used by template ŧ dependency-adjustments-pass-1.

Claims involving verbs whose constrained content requires specification of units must use <object> or <subject> with @units..Affects: @content-datatype @content-lexical-constraint @units<claim> <verb> <object> <subject>Used by template ŧ core-expansion-terse.

A claim with a verb that has content constraints must not allow other verbs.Affects: @content-datatype @content-lexical-constraint<claim> <verb>Used by template ŧ core-expansion-terse.

<subject>s' and <object>s' content must be castable to any datatype constraints defined by the verb.Affects: @content-datatype<subject> <object>Used by template ŧ core-expansion-terse.

<subject>s' and <object>s' content must match any lexical constraints defined by the verb.Affects: @content-lexical-constraint<subject> <object>Used by template ŧ core-expansion-terse.

<object> or <subject> with @units may be used only with verbs with constrained content.Affects: @content-datatype @content-lexical-constraint @units<claim> <verb> <object> <subject>Used by template ŧ core-expansion-terse.

Every <claim> must have or inherit at least one verb.Affects: @verb<claim>Used by template ŧ core-expansion-terse.

Every <claim> must respect constraints defined by the verb.Affects: @verb<claim>Used by template ŧ core-expansion-terse.

No <claim> with a verb that disallows an element may have another verb that requires that same element.Affects: @verb<claim>Used by template ŧ core-expansion-terse.

Every div type reference must be valid in every sourceAffects: @div-type<skip>Used by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

For any element with @include, at least one element of the same name must be found in target inclusion document.Affects: @include<inclusion>Used by template ŧ apply-inclusions-and-adjust-vocabulary.

Inclusions/vocabularies may not be invoked circularly.Affects: <inclusion> <vocabulary>Used by variable $erroneously-looped-doc.Used by template ŧ resolve-critical-dependencies-loop, ŧ check-referred-doc.Used by function tan:resolve-doc-loop().

Inclusions are integral parts of any TAN file. Access to at least one copy is absolutely mandatory.Affects: @include<inclusion>Used by template ŧ resolve-critical-dependencies-loop, ŧ check-referred-doc.Used by function tan:get-1st-doc().

The vocabulary of a file may not include it.Affects: <inclusion> <vocabulary> <TAN-voc>Used by template ŧ check-referred-doc.

The @TAN-version for inclusions and vocabularies should match the current version.Affects: @TAN-version<inclusion> <vocabulary>Used by template ŧ resolve-critical-dependencies-loop.

An inclusion must point to a TAN fileAffects: <inclusion>Used by template ŧ check-referred-doc.

<successor>, <predecessor>, and <companion-version> must point to TAN files of the same type.Affects: <successor> <predecessor> <companion-version>Used by template ŧ check-referred-doc.

<model> and <redivision> must point to class 1 TAN filesAffects: <model> <redivision>Used by template ŧ check-referred-doc.

<annotation> must point to class 2 TAN filesAffects: <annotation>Used by template ŧ check-referred-doc.

<vocabulary> must point to TAN-voc files.Affects: <vocabulary>Used by template ŧ resolve-critical-dependencies-loop, ŧ check-referred-doc.

<morphology> must point to TAN-mor files.Affects: <morphology>Used by template ŧ check-referred-doc.

If a linking element points to a file that must be resolved, that file must be a TAN file.Affects: <location> <inclusion> <source> <vocabulary> <redivision> <model> <annotation> <predecessor> <successor>Used by template ŧ resolve-critical-dependencies-loop.Used by function tan:resolve-doc-loop().

An element that has a <location> and is key for validation should have at least one document available.Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by function tan:get-1st-doc().

Every TAN file referred to by way of an element containing <location> should have an @id that matches the <IRI> of the parent of the <location>Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by template ŧ check-referred-doc.

No element may point to a TAN file that has an identical @id value; the only exception is <predecessor> and <successor>.Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by template ŧ check-referred-doc.

If an element not essential to validation has no <location> that points to a document a warning should be returned.Affects: <location> <algorithm> <see-also>Used by function tan:get-1st-doc().

In a <reassign>, the token referred to at <from-tok> must precede the one referred to by <through-tok>.Affects: <reassign> <from-tok> <through-tok>Used by template ŧ expand-reassigns.

No token may be adjusted by more than one <reassign>.Affects: <reassign>Used by template ŧ dependency-adjustments-pass-2.

If a <div> is renamed, and the target reference is subject to <reassign> instructions, the following message will appear.<reassign> targets a reference that has been altered by <rename>. Any reassignments will treat the newly created <div>, not the original.Affects: <reassign> <rename>Used by template ŧ dependency-adjustments-pass-2.

A <reassign> may be applied only to leaf <div>s.Affects: <reassign>Used by template ŧ dependency-adjustments-pass-2.

Every part of a @ref must correspond to a <div> in every source.Affects: @ref @srcUsed by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

If a reference to a work is not found in some sources for that work, a warning will be returned.Affects: @ref @workUsed by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

In a @ref range the first reference should precede the second.Affects: @refUsed by template ŧ class-2-expansion-terse class-2-expansion-terse-for-validation.

Sequences may not include values less than 1.Affects: @pos @chars @feature-qty-testUsed by template ŧ mark-tok-pos.Used by function tan:sequence-error().

Sequences may not include values greater than the maximum allowed.Affects: @pos @chars @feature-qty-testUsed by template ŧ mark-tok-pos.Used by function tan:sequence-error().

Ranges in sequences must go from a lesser value to a greater.Affects: @pos @chars @feature-qty-testUsed by template ŧ check-and-expand-ranges.Used by function tan:sequence-error().

Any range in either an @n or in a @ref in an adjustment action must be predictably calculated.Affects: @ref @n<skip> <rename> <reassign> <adjustments>Used by template ŧ check-and-expand-ranges.

Every TAN file must have at least one organization or person with an <IRI> that is a tag URI whose namespace matches the namespaces of @id in the root element.Affects: @id<agent>Used by template ŧ core-expansion-terse.

Any TAN file without a to-do list will be treated as being no longer in progress and should have at least one master-location.Affects: <master-location> <to-do>Used by template ŧ core-expansion-terse.

@xml:id values may not be repeated in the same document.Affects: @xml:id @idUsed by template ŧ core-expansion-terse-attributes-to-elements.

All text must be normalized (Unicode NFC).Affects: <desc> <div> <name> <IRI>Used by template ŧ core-expansion-normal.

Every idref in an attribute must point to a vocabulary item (by @xml:id or name) that is of the appropriate corresponding element.Affects: @who @ed-who @roles @src @lexicon @morphology @reuse-type @bitext-relation @feature @include @licensor @period @rights @work @type @adverb @group @verb @where @relationship @topic @subject @object @unitsUsed by template ŧ core-expansion-terse-attributes.

All idrefs in an attribute must be unique.Affects: @who @ed-who @roles @src @lexicon @morphology @reuse-type @bitext-relation @feature @include @licensor @period @rights @work @type @adverb @group @verb @where @relationship @topic @subject @object @unitsUsed by template ŧ core-expansion-terse-attributes.

Attributes that take regular expressions must use escape sequences recognized by XML schema or TAN escape extensions (\u{}). See http://www.w3.org/TR/xmlschema-2/#regexsAffects: @regex @matches-m @matches-tok @rgxUsed by template ŧ core-expansion-terse-attributes-to-elements.

@href must have <location> or <master-location> as a parent; any other parent will trigger a quick fix to populate the element with the IRI + name pattern of the target file.Affects: @href<location> <master-location>Used by template ŧ core-expansion-terse-attributes-to-elements.

An IRI may appear no more than once in a TAN document.Affects: <IRI>Used by template ŧ core-expansion-terse, ŧ check-referred-doc.

An IRI that names a TAN file must match that file's @id exactly.Affects: <IRI>Used by template ŧ check-referred-doc.

No file may import vocabularies with items that have duplicate IRIs.Affects: <vocabulary> <IRI>Used by template ŧ check-referred-doc.

An @xml:id on a vocabulary item need not duplicate a <name> (except in a TAN-mor file).Affects: @xml:id @idUsed by template ŧ core-expansion-terse.

<alias> references must not be circular.Affects: @idrefs<alias>Used by function tan:resolve-alias-loop().

No <master-location> may have an @href that points to a compressed archive.Affects: @href<master-location>Used by template ŧ core-expansion-terse-attributes-to-elements.

The only @href in a TAN document that may point to another document with the same document id is that of <master-location> or <see-also>Affects: @href<location> <master-location>Used by function tan:get-1st-doc().

No @href should point to the URI of the document itself.Affects: @href<location> <master-location>Used by template ŧ first-stamp-shallow-copy, ŧ core-expansion-terse-attributes-to-elements.

Files should match the version kept at <master-location>.Affects: <master-location>Used by template ŧ class-2-expansion-verbose, ŧ core-expansion-normal.

Any IRI beginning urn: must continue with a name that is part of the official IANA Registry of URN Namespaces. See RFC 2414, https://tools.ietf.org/html/rfc8141, and https://www.iana.org/assignments/urn-namespaces/urn-namespaces.xhtmlAffects: <IRI>Used by template ŧ core-expansion-terse.

Files must be correlated with the proper TAN version.Affects: @TAN-versionUsed by template ŧ core-expansion-terse dependency-adjustments-pass-1, ŧ core-expansion-terse.

Multiple idrefs in a single attribute should not point to the same entity.Affects: @who @ed-who @roles @src @lexicon @morphology @reuse-type @bitext-relation @feature @include @licensor @period @rights @work @type @adverb @group @verb @where @relationship @topic @subject @object @unitsUsed by template ŧ core-expansion-terse-attributes, ŧ core-expansion-terse-attributes-to-elements.

Text that represents a line, column, or page break should be moved into a @rend within a <lb>, <pb>, or <cb>.Affects: @rend<tei:lb> <tei:pb> <tei:cb>Used by template ŧ core-expansion-terse dependency-adjustments-pass-1 normalize-tei-space.

A milestone element without @break set to false should have at least one space on either side.Affects: <tei:lb> <tei:pb> <tei:cb>Used by template ŧ core-expansion-terse dependency-adjustments-pass-1 normalize-tei-space.

A milestone element with @break set to false should have no nearby spacesAffects: <tei:lb> <tei:pb> <tei:cb>Used by template ŧ core-expansion-terse dependency-adjustments-pass-1 normalize-tei-space.

When using a category-based morphology, the number of feature codes in an <m> may not exceed the number of categories.Affects: <m>Used by template ŧ tan-a-lm-expansion-terse.

Every feature code in an <m> must be found in the target morphology file.Affects: <m>Used by template ŧ tan-a-lm-expansion-terse.

Every condition of a relevant dependency morphology <assert> (<report>) must be true (false) otherwise an error will be returned.Affects: <m>No variables, keys, functions, or named templates depend upon this error.

Features may not be repeated within a given category.Affects: @type<category> <feature>Used by template ŧ dependency-adjustments-pass-1 core-expansion-terse.

Codes for features must be case-indifferently unique within a given category.Affects: @code<feature>Used by template ŧ dependency-adjustments-pass-1 core-expansion-terse.

Every token must be locatable in every cited ref in every source.Affects: @pos @val @rgx<tok> <from-tok> <through-tok>Used by template ŧ expand-reassigns, ŧ class-2-expansion-terse class-2-expansion-terse-for-validation, ŧ mark-tok-pos, ŧ mark-dependencies-pass-2-for-validation.

Names may not duplicate names reserved by standard TAN vocabulary for the affected element.Affects: <name>Used by template ŧ core-expansion-terse.

Names may not be duplicates of, case-variants of, or hyphen variants of other names for the same element.Affects: <name>Used by template ŧ core-expansion-normal.

@affects-element may take names only of those TAN elements that accept @whichAffects: @affects-element<item> <group>Used by template ŧ core-expansion-terse.

Every item in a reserved TAN-voc must have at least one IRI with a tag URN in the TAN namespaceAffects: <IRI> <item>Used by template ŧ core-expansion-terse.

@affects-element may take the value "vocabulary" only in official TAN-voc files.Affects: @affects-element<item> <group>Used by template ŧ core-expansion-terse.

Each <name> in standard TAN vocabulary must already be normalized.Affects: <name>Used by template ŧ core-expansion-terse.

Future dates are not permitted.Affects: @when @ed-when @accessed-when @from @toUsed by template ŧ core-expansion-terse-attributes-to-elements.

@from must predate @toAffects: @from @toUsed by template ŧ core-expansion-terse-attributes-to-elements.

An element's @which must have a value that corresponds to a <name>, either in a standard TAN vocabulary or an associated TAN-voc file, that is marked as applying to that element.Affects: @which<vocabulary>Used by template ŧ core-expansion-terse-attributes.

Names must be unique for vocabulary items assigned to a given element name.Affects: <name> <item>Used by template ŧ check-referred-doc.

Vocabularies are integral parts of a document. Access to at least one version is absolutely mandatory.Affects: <vocabulary>Used by template ŧ resolve-critical-dependencies-loop, ŧ check-referred-doc, ŧ first-stamp-shallow-copy.Used by function tan:get-1st-doc().

A @which in a <vocabulary> may point only to items in the standard TAN file vocabularies.TAN-voc.xmlAffects: @which<vocabulary>Used by template ŧ first-stamp-shallow-copy.

If an @href points to a local file that is not available, a warning will be returned.@href points to file that is either (1) not available or (2) not valid XMLAffects: @href<location> <master-location>Used by template ŧ core-expansion-terse-attributes-to-elements, ŧ check-referred-doc.Used by function tan:get-1st-doc().

If @accessed-when predates one or more dates in a target file, a warning will be returned.Affects: @accessed-when<location> <inclusion> <see-also> <source> <vocabulary>Used by template ŧ check-referred-doc.

If a target file has children items in the <to-do>the corresponding comments will be returned as warnings.Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by template ŧ check-referred-doc.

Users should be warned about versions of TAN that are under development.This version of TAN is under development, and is subject to change. Participants in developing the TAN schemas, functions, and guidelines are welcome. See http://textalign.net for details.Affects: <TAN-T> <TEI> <TAN-A> <TAN-A-tok> <TAN-A-lm> <TAN-voc> <TAN-mor>Used by template ŧ core-expansion-terse dependency-adjustments-pass-1, ŧ core-expansion-terse.

If a target file has a <successor> a warning will be returned, noting the update.Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by template ŧ check-referred-doc.

Users should be warned about TAN files whose last change was made by an algorithm.Affects: <TAN-T> <TEI> <TAN-A> <TAN-A-tok> <TAN-A-lm> <TAN-voc> <TAN-mor>Used by template ŧ core-expansion-terse dependency-adjustments-pass-1, ŧ check-referred-doc, ŧ core-expansion-terse.

If an element's <location> is faulty and if a catalog file entry is found pointing to a document with the same IRI, location information on those alternative locations will be returnedAffects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by template ŧ check-referred-doc.

If a target file points only to non-local locations and no internet is available, the following message will be returned.No internet available.Affects: <location> <inclusion> <see-also> <source> <vocabulary> <redivision> <annotation> <model> <predecessor> <successor> <algorithm>Used by function tan:get-1st-doc().

If an @href points to a file that is not local, and no internet is available, a warning will be returned.No internet access.Affects: @href<location> <master-location>Used by template ŧ check-referred-doc.

If the internet is available, and an @href points to a non-local file that is not available, a warning will be returned.@href points to non-local file that is either (1) not available, (2) not valid XML, or (3) at a server not trusted by the validation engine.Affects: @href<location> <master-location>Used by template ŧ check-referred-doc.