<gap>

<gap> (gap) indicates a point where material has been omitted in a transcription, whether for editorial reasons described in the TEI header, as part of sampling practice, or because the material is illegible, invisible, or inaudible. 3.4.3 Additions, Deletions, and Omissions
Module core — 3 Elements Available in All TEI Documents
In addition to global attributes att.duration (att.duration.w3c (@dur)) (att.duration.iso (@dur-iso)) att.editLike (@cert, @resp, @evidence, @source) (att.dimensions (@unit, @quantity, @extent, @precision, @scope) (att.ranging (@atLeast, @atMost, @min, @max)) )
reason gives the reason for omission. Sample values include sampling, inaudible, irrelevant, cancelled.
Status Optional
Datatype 1–∞ occurrences of  

<rng:ref name="data.word"/>
data.word
separated by whitespace
Values any short indication of the reason for the omission.
hand in the case of text omitted from the transcription because of deliberate deletion by an identifiable hand, signifies the hand which made the deletion.
Status Optional
Datatype 

<rng:ref name="data.pointer"/>
data.pointer
Values must be one of the hand identifiers declared in the document header (see section 11.4.1 Document Hands).
agent In the case of text omitted because of damage, categorizes the cause of the damage, if it can be identified.
Status Optional
Datatype 

<rng:ref name="data.enumerated"/>
data.enumerated
Sample values include:
rubbing
damage results from rubbing of the leaf edges
mildew
damage results from mildew on the leaf surface
smoke
damage results from smoke
Used by
model.global.edit
May contain
core: desc gloss
tagdocs: altIdent equiv
Declaration 

<rng:element name="gap">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.duration.w3c.attributes"/>
 <rng:ref name="att.duration.iso.attributes"/>
 <rng:ref name="att.editLike.attributes"/>
 <rng:ref name="att.dimensions.attributes"/>
 <rng:ref name="att.ranging.attributes"/>
 <rng:optional>
  <rng:attribute name="reason">
   <rng:list>
    <rng:oneOrMore>
     <rng:ref name="data.word"/>
    </rng:oneOrMore>
   </rng:list>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="hand">
   <rng:ref name="data.pointer"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="agent">
   <rng:ref name="data.enumerated"/>
  </rng:attribute>
 </rng:optional>
 <rng:zeroOrMore>
  <rng:ref name="model.glossLike"/>
 </rng:zeroOrMore>
</rng:element>
element gap
{
   att.global.attributes,
   att.duration.w3c.attributes,
   att.duration.iso.attributes,
   att.editLike.attributes,
   att.dimensions.attributes,
   att.ranging.attributes,
   attribute reason { list { data.word+ } }?,
   attribute hand { data.pointer }?,
   attribute agent { data.enumerated }?,
   model.glossLike*
}
Example
<gap extent="4" unit="chars" reason="illegible"/>
Example
<gap extent="1" unit="essay" reason="sampling"/>
Note
The gap, unclear, and del core tag elements may be closely allied in use with the damage and supplied elements, available when using the additional tagset for transcription of primary sources. See section 11.5.2 Use of the <gap>, <del>, <damage>, <unclear>, and <supplied> Elements in Combination for discussion of which element is appropriate for which circumstance.