<?xml version="1.0" encoding="utf-8"?>
<!--
    Copyright TEI Consortium. 
    Dual-licensed under CC-by and BSD2 licences 
    See the file COPYING.txt for details
    $Date: 2012-08-15 18:26:15 +0100 (Wed, 15 Aug 2012) $
    $Id: att.datable.custom.xml 10770 2012-08-15 17:26:15Z martindholmes $
-->
<classSpec xmlns="http://www.tei-c.org/ns/1.0" module="namesdates" xml:id="DATABLECUSTOM" type="atts"
  predeclare="true" ident="att.datable.custom">
  <desc>provides attributes for normalization of elements that contain datable events to a custom dating system
    (i.e. other than the Gregorian used by W3 and ISO).</desc>
    <attList>
    <attDef ident="when-custom" usage="opt">
      <desc>supplies the value of a date or time in some standard form.</desc>
      <datatype minOccurs="1" maxOccurs="unbounded">
        <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.word"/>
      </datatype>
      <valDesc>Any string representing a valid date, time, or one of a variety of combinations.</valDesc>
      <exemplum xml:lang="en">
        <p>The following are examples of custom date or time formats that are <emph>not</emph> valid ISO or W3C format
                    normalizations, normalized to a different dating system</p>
        <egXML xmlns="http://www.tei-c.org/ns/Examples">
          <p>Alhazen died in Cairo on the 
            <date when="1040-03-06" when-custom="431-06-12">
              12th day of Jumada t-Tania, 430 AH
            </date>.</p>
          <p>The current world will end at the 
            <date when="2012-12-21" when-custom="13.0.0.0.0">end of B'ak'tun 13</date>.</p>
          <p>The Battle of Meggidu
            (<date when-custom="Thutmose_III:23">23rd year of reign of Thutmose III</date>).</p>
          <p>Esidorus bixit in pace annos LXX plus minus sub
            <date when-custom="Ind:4-10-11">die XI mensis Octobris indictione IIII</date></p>
        </egXML>
        <p>Not all custom date formulations will have Gregorian equivalents.</p>
        <p>The <att>when-custom</att> attribute and other custom dating are not contrained to a datatype by the TEI, but
        individual projects are recommended to regularize and document their dating formats.</p>
      </exemplum>
    </attDef>
    <attDef ident="notBefore-custom" usage="opt">
      <equiv/>
      <desc>specifies the earliest possible date for the event in some custom standard form.</desc>
      <datatype minOccurs="1" maxOccurs="unbounded">
        <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.word"/>
      </datatype>
      <valDesc>A normalized form of temporal expression.</valDesc>
      </attDef>
    <attDef ident="notAfter-custom" usage="opt">
      <equiv/>
      <desc>specifies the latest possible date for the event in some custom standard form.</desc>
      <datatype minOccurs="1" maxOccurs="unbounded">
        <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.word"/>
      </datatype>
      <valDesc>A normalized form of temporal expression.</valDesc>
      </attDef>
    <attDef ident="from-custom" usage="opt">
      <equiv/>
      <desc>indicates the starting point of the period in some standard form.</desc>
      <datatype minOccurs="1" maxOccurs="unbounded">
        <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.word"/>
      </datatype>
      <valDesc>A normalized form of temporal expression.</valDesc>
    </attDef>
      <attDef ident="to-custom" usage="opt">
        <equiv/>
        <desc>indicates the ending point of the period in some standard form.</desc>
        <datatype minOccurs="1" maxOccurs="unbounded">
          <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.word"/>
        </datatype>
        <valDesc>A normalized form of temporal expression.</valDesc>
      </attDef>
      <attDef ident="datingPoint" usage="opt">
        <desc>supplies a pointer to some location defining a named point in time with reference to which the datable item is understood to have occurred</desc>
        <datatype>
          <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.pointer"/>
        </datatype>
      </attDef>
      <attDef ident="datingMethod" usage="opt">
        <desc>supplies a pointer to a <gi>calendar</gi> element or other means of interpreting the values of the custom dating attributes.</desc>
        <datatype>
          <ref xmlns="http://relaxng.org/ns/structure/1.0" name="data.pointer"/>
        </datatype>
      </attDef>
  </attList>
  <listRef>
    <ptr target="#NDDATE"/>
  </listRef>
</classSpec>
