Olympia: The Age of Gods PBEM (Oct 4 2000)

promote

promote who
* time: 0 days
* priority: 1

Advance the given unit so that it appears before the noble issuing promote in the location list.

The noble to be promoted should be stacked immediately beneath the promoting noble, or appear later in the location list at the same level.

Examples:

Before:

Osswid the Constructor [5499], accompanied by:
   Feasel the Wicked [502]

Osswid issues `promote 502':

Feasel the Wicked [502]
Osswid the Constructor [5499]

Before:

Osswid the Constructor [5499], accompanied by:
   Feasel the Wicked [502]
Candide [1269]

Osswid issues `promote 1269':

Candide [1269]
Osswid the Constructor [5499], accompanied by:
   Feasel the Wicked [502]

A common mistake is to think that promote can be used to swap the stack leader and someone in the stack. For example, if you have

Osswid the Constructor [5499], accompanied by:
   Feasel the Wicked [502]

and Osswid issues `promote 502', you do NOT get this:

Feasel the Wicked [502] accompanied by:
   Osswid the Constructor [5499]

instead you get two separate stacks, with the Feasel stack ahead of the Osswid stack in the location report:

Feasel the Wicked [502]
Osswid the Constructor [5499]

To swap stack leaders, you need some combination of stack and unstack commands.