The element change
declares a change made to the current file. Must credit an <agent>
, specified by @who
, and a time the change was made, specified by @when.
Collectively, <change>
elements are called the changelog, the revision history of the document.
The editor has discretion as to how long or detailed a <change>
should be, or how many should be retained in a changelog. Ideally, <change>
s documenting every published version should be retained.
<change>
elements may appear in any order, but it is good practice to put the most recent at the top.
Formal Definition
~ed-stamp
?,@when
,@flags
?,@who
, text
Defined at:
TAN-core.rng
Example 8.107. <change>
<TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="2018"> <head> ......... <resp who="xslt1" roles="stylesheet1"/> <change when="2016-07-07T16:36:28.867-04:00" who="kalvesmaki">Reformatted file at ar.cat.eng.1926.edghill.sem.xml to the structure of the copy of the model.</change> <change who="xslt1" when="2017-11-02T22:27:59.302-04:00">TAN file updated to 2018 schemas.</change> </head> ......... </TAN-T>
Note | |
---|---|
Taken from ar.cat.eng.1926.edghill.obj |
Example 8.108. <change>
<TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="2018"> <head> ......... <resp who="xslt1" roles="stylesheet1"/> <change when="2016-06-22T08:04:25.003-04:00" who="kalvesmaki">Reformatted according to first model found. Backup made at file:/C:/Users/jdkalv/Dropbox/TAN/library/TAN-2018/examples/ar.cat.eng.1926.edghill.sem-201606220804250030400.xml.</change> <change when="2016-01-26-04:00" who="kalvesmaki">Started new file.</change> <change who="xslt1" when="2017-11-02T22:29:17.742-04:00">TAN file updated to 2018 schemas.</change> </head> ......... </TAN-T>
Note | |
---|---|
Taken from ar.cat.eng.1926.edghill.sem |