Version 3 (modified by jpawlick, 13 years ago) (diff) |
---|
This command clears the command queue except for the final command. It is provided to facilitate an atomic way to replace all commands with a single command without introducing a period of no action (the idea is that if you want to replace everything with "ro 5 180 0", you say: "t ro 5 180 0 [NEWLINE] n fm 0", and your quagent will instantly start rotating and forget all prior commands).
Parameters:
- This command does not accept any parameters.
Reports:
- done immediately.
- popped if popped by po before execution.
- forgotten if deleted by fa or fm.
- replaced if replaced by a command scheduled with 'r'.
- Causes all but one other actions to report forgotten.
Example:
- User sends: "n mi 16 0 0 1"
- Bot starts moving.
- User sends: "t mi 17 0 90 1"
- User sends: "t mi 18 0 135 1"
- User sends: "t mi 19 0 180 1"
- User sends: "n fm 20"
- Bot replies "cp fm 20 done"
- Bot replies "cp mi 16 forgotten"
- Bot replies "cp mi 17 forgotten"
- Bot replies "cp mi 18 forgotten"
- Bot starts moving backwards (by the instruction "mi 19").