att.deprecated

att.deprecated 非推奨の機能を将来のリリースでどのように扱うかを示す属性を提供する。
モジュールtagdocs — Documentation Elements
構成att.combinable [att.identified [attDef classSpec constraintSpec dataSpec elementSpec macroSpec moduleSpec paramSpec schemaSpec] valDesc valItem valList] defaultVal
属性属性
validUntil定義されている構文が削除される前の日付を提供する．
状態 任意
データ型 date
Schematron

<sch:rule context="tei:*[@validUntil]">
<sch:let name="advance_warning_period"
 value="current-date() + xs:dayTimeDuration('P60D')"/>
<sch:let name="me_phrase"
 value="if (@ident) then concat('The ', @ident ) else concat('This ', local-name(.), ' of ', ancestor::tei:*[@ident][1]/@ident )"/>
<sch:assert test="@validUntil cast as xs:date ge current-date()">
 <sch:value-of select=" concat( $me_phrase, 'construct is outdated (as of ', @validUntil, '); ODD processors may ignore it, and its use is no longer supported' )"/>
</sch:assert>
<sch:assert role="nonfatal"
 test="@validUntil cast as xs:date ge $advance_warning_period">
 <sch:value-of select="concat( $me_phrase, ' construct becomes outdated on ', @validUntil )"/>
</sch:assert>
</sch:rule>
Schematron

<sch:rule context="tei:*[@validUntil][ not( self::valDesc | self::valList | self::defaultVal )]">
<sch:assert test="child::tei:desc[ @type eq 'deprecationInfo']"> A deprecated construct should include, whenever possible, an explanation, but this <sch:value-of select="name(.)"/> does not have a child <desc type="deprecationInfo"></sch:assert>
</sch:rule>
解説

この属性の値は，（yyyy-mm-ddの形式で）日付を表し，属性がODDに追加された日付より後である必要がある。技術的には，この属性は，指定された日付まで定義されているマークアップ言語の将来のリリースで構造を残す意図のみを表明し，その日付以降に何が起こるかについて主張しない。実際には，validUntil日付の直後に定義されるマークアップ言語の将来のリリースからコンストラクトが削除されることが期待されます。

ODDプロセッサは，通常，validUntil日付が過去のものである仕様要素を処理しない．ODDプロセッサは，通常，validUntilの日付を持つコンストラクトについてユーザに警告する。例えば，そのような構造のドキュメントには，warning：deprecatedというフレーズが赤で表示される。