promote

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.