This is a text file. PHost places all commands sent through the Command Processor's `xtern' command here. Add-on programs may make use of this.

The first line contains the turn number, followed by a space and the timestamp, so add-ons can check if the file is current. On the very first turn, this file contains just the single digit "0".

Following lines contain the actual commands, in the form "player number: command", where "player number" is the number from 1 to 11, and "command" is what followed the `xtern' command. As of PHost 3.4b, there are no limits of line length.

You can use the `xtern' command as a replacement for comments in command messages. EchoView does this to mark auto-generated messages: these start with `xtern echoview TYPE'.

It is recommended that add-ons recognize a command `cmd' also when spelled as `name: cmd', where `name' is the name of the add-on. This makes it clear whom a command belongs to.

This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.