Below is a list of 111 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.Used by function tan:get-context-prepped()

Assertions of multiple TAN-A-div 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.Used by function tan:get-context-prepped()

Mismatched sets of statistics may not be merged.General rule not affecting specific attibutes or elements.Used by function tan:merge-analyzed-stats()

No <div> that is a member of a complex realignment may be used to align all members of a work (@src should be used instead of @work)Affects: @work<align> <realign>Used by template ŧ TAN-A-div-errors

In class 1 files, alternative editions must share the same source.Affects: <see-also> <relationship>Used by template ŧ class-1-errors

In class 1 files, alternative editions must share the same work.Affects: <see-also> <relationship>Used by template ŧ class-1-errors

In class 1 files, alternative editions must share the same work-version, if supplied.Affects: <see-also> <relationship>Used by template ŧ class-1-errors

In class 1 files, resegmented copies must have identical transcriptions, after TAN normalization.Affects: <see-also> <relationship>Used by template ŧ class-1-errors ŧ class-1-copy-errors

A class 1 file and its model must have the same work.Affects: <see-also> <relationship>Used by template ŧ class-1-errors

A class 1 file may have no more than one model.Affects: <see-also> <relationship>Used by template ŧ class-1-errors

If a class 1 file diverges from the structure of its model a warning will be generated specifying where differences exist.Affects: <see-also> <relationship>No variables, keys, functions, or named templates depend upon this warning.

A work element may invoke no more than one inclusion.Affects: @include<work>Used by template ŧ class-1-errors

Leaf div references must be unique.Affects: @n<div>Used by template ŧ prep-verbosely ŧ class-1-errors

Every leaf div must have at least some non-space text.Affects: <div>Used by template ŧ class-1-errors

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

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

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

To avoid ambiguous numerals, no div type should mix Roman and alphabet numerals.Affects: @n<div-type>Used by template ŧ arabic-numerals

@n suffices for labeling text in a <div>; the @n's value should not appear in the text.Affects: @n<div>No variables, keys, functions, or named templates depend upon this warning.

concatenated @n's suffice for labeling text in a <div>; the <div>'s reference should not appear in the text.Affects: @n<div>No variables, keys, functions, or named templates depend upon this warning.

@n's taking digit values should not begin with 0.Affects: @n<div>Used by template ŧ prep-class-1

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

No source may be given more than one token definition.Affects: <token-definition>Used by function tan:prep-class-2-doc-pass-2()

@old and @new may not share the same valueAffects: @old @new<rename>Used by template ŧ prep-class-2-doc-pass-2

No value of @new or @old may appear more than once for a given div type in a given source.Affects: @old @new<rename>Used by template ŧ prep-class-2-doc-pass-2

Any element taking @cont must be followed by at least one sibling of the same type.Affects: @contNo variables, keys, functions, or named templates depend upon this error.

@val must wholly match a token in the target.Affects: @valUsed by function tan:get-toks()

A @val set to '.+', a regular expression that matches any string, is equivalent to the omission of @valThe value '.+' will match any string.Affects: @valNo variables, keys, functions, or named templates depend upon this warning.

A <tok> may not duplicate any sibling <tok>.Affects: <align> <tok> <ana>Used by template ŧ class-2-errors

@old must be found in every div type of every sourceAffects: @old<rename>Used by template ŧ prep-class-2-doc-pass-2

Claims involving verbs whose object is constrained must use <object>, not @object.Affects: @object-datatype @object-lexical-constraint<claim> <verb>Used by template ŧ prep-tan-claims

Verbs that have object constraints must not be combined with other verbs in @verb.Affects: @object-datatype @object-lexical-constraint<claim> <verb>Used by template ŧ prep-tan-claims

<object>s taking strings must match the predefined @object-datatype for the verb.Affects: @object-datatype<object>Used by template ŧ prep-tan-claims

<object>s taking strings for verbs that have lexical constraints must match those lexical constraints.Affects: @object-lexical-constraint<object>Used by template ŧ prep-tan-claims

Every <claim> must have at least one subject, either @subject (self or ancestral <body>) or a child <subject>Affects: @subject<claim> <subject>Used by template ŧ prep-tan-claims

Any predefined strictures on verbs must be respected.Affects: @verb<claim>Used by template ŧ prep-tan-claims

Every <claim> must have at least one subject, either @subject (self or ancestral <body>) or a child <subject>Affects: @verb<claim>Used by template ŧ prep-tan-claims

Distribution must be applied to groups of equal size.Affects: <realign>Used by template ŧ prep-tan-a-div-pass-b

Every div type reference must be valid in every sourceAffects: @div-type-ref<div-type-ref> <equate-div-types> <rename-div-ns> <suppress-div-types>Used by template ŧ prep-class-2-doc-pass-2Used by function tan:group-by-IRIs()

Items that share IRI values should not be equated.Affects: <equate-works> <equate-div-types>Used by function tan:group-by-IRIs()

Inclusions may not introduce duplicate values of @xml:id.Affects: @include<inclusion>No variables, keys, functions, or named templates depend upon this error.

For any element with @include, at least one element of the same name must be found in target inclusion document.Affects: @include<inclusion>No variables, keys, functions, or named templates depend upon this error.

Inclusions may not be circular.Affects: @include<inclusion>Used by variable $erroneously-looped-docUsed by template ŧ resolve-attr-include

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

Every inclusion should have at least one document available.Affects: @include<inclusion>No variables, keys, functions, or named templates depend upon this error.

Every element with a <location> should have at least one document available.Affects: <location> <inclusion> <see-also> <source> <key>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> <key>Used by template ŧ core-errors

No element may point to a TAN file that has an identical @id value; the only exception is a <see-also> pointing to an older or new version.Affects: <location> <inclusion> <see-also> <source> <key>Used by template ŧ core-errors

A <div> may be referred to in a <realign> no more than once (whether <anchor-div-ref> or <div-ref>).Affects: <anchor-div-ref> <div-ref> <realign>Used by template ŧ TAN-A-div-errors

Every atomic reference in a @ref must correspond to a <div> in every source mentioned by @src.Affects: @ref @srcUsed by function tan:pick-prepped-class-1-data() tan:cull-prepped-class-1-data() tan:convert-ref-to-div-fragment()

If @ref points to a leaf div, it must be unique.Affects: @refUsed by function tan:convert-ref-to-div-fragment()

A defective reference is a value of @ref that corresponds to a <div> 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 <div>.Affects: @ref<div-ref> <align>No variables, keys, functions, or named templates depend upon this warning.

Every range in a @ref must correspond to one or more <div>s in every source mentioned by @src.Affects: @ref @srcUsed by function tan:convert-ref-to-div-fragment()

Any <see-also> whose <relationship> is defined as requiring a target TAN file must point to a file whose root element is a TAN file.Affects: <see-also> <relationship>Used by template ŧ core-errors

Any <see-also> whose <relationship> is defined as requiring a target TAN-c file must point to a TAN file whose root element is <TAN-c>.Affects: <see-also> <relationship>Used by template ŧ core-errors

Any <see-also> whose <relationship> is defined as requiring a target copy must point to a TAN file whose root element is identical.Affects: <see-also> <relationship>Used by template ŧ core-errors

<see-also> may have the <relationship> of a different work version only if both are class 1 files and both share the same work.Affects: <see-also> <relationship>Used by template ŧ core-errors

@seg may not be applied to any element that is not a leaf divAffects: @segUsed by template ŧ prep-tan-a-div-pass-a ŧ insert-seg-into-leaf-divs-in-hierarchy-fragment

Sequences may not include values less than 1.Affects: @pos @chars @seg @feature-qty-testUsed by template ŧ insert-seg-into-leaf-divs-in-hierarchy-fragment ŧ prep-tan-morUsed by function tan:get-toks() tan:sequence-error()

Sequences may not include values greater than the maximum allowed.Affects: @pos @chars @seg @feature-qty-testUsed by template ŧ insert-seg-into-leaf-divs-in-hierarchy-fragment ŧ prep-tan-morUsed by function tan:get-toks() tan:sequence-error()

Sequences may not include ranges that go from a larger value to a smaller, e.g., 4 - 2.Affects: @pos @chars @seg @feature-qty-testUsed by template ŧ insert-seg-into-leaf-divs-in-hierarchy-fragment ŧ prep-tan-morUsed by function tan:get-toks() tan:sequence-error()

Splits may be made only at leaf divs.Affects: <split-leaf-div-at>No variables, keys, functions, or named templates depend upon this error.

No source may be split more than once in the same place.Affects: <split-leaf-div-at> <tok>Used by template ŧ segment-tokd-prepped-class-1 ŧ TAN-A-div-errors

Splits may not be made at the first token in a div.Affects: <split-leaf-div-at> <tok>Used by template ŧ segment-tokd-prepped-class-1

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 <agent> 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-errors

Any TAN file marked as being no longer in progress should have at least one master-location.Affects: @in-progress<master-location>No variables, keys, functions, or named templates depend upon this warning.

@xml:id values may not be repeated in the same document.Affects: @xml:idUsed by template ŧ core-attribute-errors

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

Every idref in an attribute must point to the @xml:id value of the appropriate corresponding element.Affects: @who @ed-who @roles @src @lexicon @morphology @reuse-type @bitext-relation @feature @includeUsed by template ŧ resolve-attr-include ŧ core-errors ŧ core-attribute-errorsUsed by function tan:resolve-doc() tan:idrefs-loop()

All idrefs in an attribute must be unique.Affects: @who @ed-who @roles @src @lexicon @morphology @reuse-type @bitext-relation @feature @includeUsed by template ŧ core-attribute-errors

Attributes that take a regular expression must use escape sequences recognized by XML schema or TAN escape extensions (\k{}). See http://www.w3.org/TR/xmlschema-2/#regexs for details.Affects: @regex @matches-m @matches-tok @valUsed by template ŧ core-attribute-errors

@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: @hrefUsed by template ŧ core-attribute-errors

An IRI may appear no more than once in a TAN document.Affects: <IRI>Used by template ŧ tan-key-errors ŧ core-errors

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

No file may import keys that have duplicate IRIs.Affects: <key> <IRI>Used by template ŧ core-errors

No single set of references may mix Roman numerals, alphabetic numerals, and numerals that are ambiguously either.Affects: @n @refUsed by template ŧ arabic-numerals

A <alias> may not mix idrefs from different elements.Affects: @idrefs<alias>Used by template ŧ core-errors

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

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

The only @href in a TAN document that may point to the same document id that of <master-location>Affects: @hrefUsed by function tan:get-1st-doc()

<div>s may not be mixed with other elements: a <div> must parent either only <div>s or none at all, and may have as siblings only other <div>s.Affects: <div>Used by template ŧ core-errors

A <div> must not mix @include with any other attributes.Affects: <div>Used by template ŧ core-errors

A <div> must have either @type + @n or @include but not both.Affects: <div>Used by template ŧ core-errors

@rend should be used to represent a break, not actual textAffects: @rend<tei:lb> <tei:pb> <tei:cb>No variables, keys, functions, or named templates depend upon this warning.

A breaking element without @break="no" should have at least one space on either side; one with @break="no" should have no nearby spacesAffects: <tei:lb> <tei:pb> <tei:cb>Used by template ŧ prep-class-1

Names may not duplicate reserved TAN keywords for the affected element.Affects: <name>Used by template ŧ tan-key-errors

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

@affects-element must include only names of TAN elements that accept @whichAffects: @affects-element<item> <group>Used by template ŧ tan-key-errors

Every item in a reserved TAN-key must have at least one IRI with a tag URN in the TAN namespaceAffects: <IRI> <item>Used by template ŧ tan-key-errors

Any ana with an @xml:id must point to no more than one token.Affects: @xml:id<tok>Used by template ŧ class-2-errors

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 ŧ prep-tan-lm

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

Every condition of a relevant <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.

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

Every <feature> inclusion must support every language that has been declared.Affects: @include<feature>Used by template ŧ prep-tan-mor

Codes for (@xml:id or @code) features must be case-indifferently unique within a given category.Affects: @code @xml:id<option>Used by template ŧ prep-tan-mor

@feature-test and @context must point to one or more feature @codes or @xml:ids a space or +Affects: @feature-test @context<report> <assert>Used by template ŧ prep-tan-mor

Every token must be locatable in every cited ref in every source.Affects: <tok>Used by function tan:get-toks()

<tok> must reference a leaf <div>.Affects: <tok>Used by function tan:get-toks()

Date attributes must be castable either as xs:dateTime or xs:dateAffects: @when @ed-when @when-accessed @from @toUsed by template ŧ core-attribute-errors

Future dates are not permitted.Affects: @when @ed-when @when-accessed @from @toUsed by template ŧ core-attribute-errors

@from must predate @toAffects: @from @toUsed by template ŧ core-attribute-errors

An element's @which must have a value that corresponds to a <name>, either in the core TAN keyword or an associated TAN-key file, that is marked as applying to that element.Affects: @which<key>Used by template ŧ resolve-keyword

Keywords (values of @which) must be unique for a given element name.Affects: @which<key>Used by template ŧ resolve-keyword ŧ core-errors

Any element that takes @which must have keywords defined for that element.Affects: @which<key>Used by template ŧ resolve-keyword

Keys are integral parts of a document. Access to at least one version is absolutely mandatory.Affects: @which<key>Used by template ŧ core-errorsUsed by function tan:get-1st-doc()

If fn:doc-available() for an @href returns false, the following message will be returned.@href points to file that is either (1) not available, (2) not valid XML, or (3) at a server not trusted by the validation engine.Affects: @hrefNo variables, keys, functions, or named templates depend upon this warning.

If @when-accessed predates one or more dates in a target file, a warning will be returned.Affects: <location> <inclusion> <see-also> <source> <key>No variables, keys, functions, or named templates depend upon this warning.

If a target file does not explicitly give the <body>'s @in-progress the value of true() a warning will be returned.Target file is marked as being in progress.Affects: <location> <inclusion> <see-also> <source> <key>No variables, keys, functions, or named templates depend upon this warning.

Every validated TAN file will include the following message at its root.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-div> <TAN-A-tok> <TAN-LM> <TAN-key> <TAN-c> <TAN-mor>No variables, keys, functions, or named templates depend upon this warning.

If a target file has a <see-also> marked as a new version (update) a warning will be returned.Affects: <location> <inclusion> <see-also> <source> <key>No variables, keys, functions, or named templates depend upon this warning.