*POP

This command is accepted for compatibility with earlier versions of PP. Use unique names for PP objects.

VERY IMPORTANT: text contents are not preserved with this command.

The *POP command restores the values of the indices as saved at the last *PUSH command, and releases the stack level. If there has been no previously unpopped push, an error occurs.

*POP cannot work selectively: all the indices saved at the last *PUSH are restored. But if the last *PUSH only saved some of the indices, the values of those not pushed will not be altered by the *POP. It is therefore possible to return a local index value to the level above.

*POP is often used at the end of an insert file to restore the indices as they were at the beginning of the insert file (where a *PUSH is used).

There is only one form of the command, as follows:

[*pop]