<rename>

The element rename provisionally reassigns values of @n's in class 1 sources, or their calculated ref value, to another value.

Values of @n will be renamed before attempting to rename references. Only the first renaming match will be applied.

Formal Definition

~ed-stamp?, 
   (~inclusion | (
      
         ((@n, @new) | (@ref, @new)) | ~complex-rename))

Defined at: TAN-class-2.rng

Used by: ~alter-class-2

[Caution]Caution

When renaming references, ranges must be predictably calculated.

[Caution]Caution

At least one instance of an @n value should be found in each source.

[Caution]Caution

@by may be applied only to those @n and @ref values that are calculable as integers.

[Caution]Caution

In a <rename>, the number of values in @ref and @new must be identical.

[Caution]Caution

Every div type reference must be valid in every source

[Caution]Caution

@new may not take the same value as what it replaces.

[Important]Important

Only the first of multiple <rename>s that apply to a particular <div> will be applied.

[Important]Important

If a <div> is renamed, and the target reference is subject to <reassign> instructions, the following message will appear. <reassign> targets a reference that has been altered by <rename>. Any reassignments will treat the newly created <div>, not the original.

[Caution]Caution

No alter action should result in the mixing of leaf <div>s and non-leaf <div>s.

Example 8.173. <rename>

   <head>
      .........
      <alter src="fra">
         <skip div-type="sec"/>
         <rename ref="1 1-3" new="1 1 1-3"/>
         <rename ref="3 1-3" new="3 1 1-3"/>
         <rename ref="4 1-3" new="4 1 1-3"/>
         <rename ref="5 1-4" new="5 1 1-4"/>
         <rename ref="5 7-9" new="5 2 3-5"/>
         .........
      </alter>
      .........
   </head>


[Note]Note

Taken from ar.cat.tan-a-div