MAILGO(6)

NAME
mailgo - shell script for using mgt to automate email go games

SYNOPSIS
mailgo [-r] [-n] [-c] [filename]

DESCRIPTION
mailgo helps manage email games by processing Smart-Go game records received by mail, invoking mgt, and automatically sending your next move back.

Invoking mailgo with no flags instructs the program to search the specified file for a go game, ignoring mail headers or other such garbage. mailgo will invoke the game processor specified in the environment variable MAILGO or of this variable is undefined, will attempt to run mgt from the inherited path.

If your opponent loses your move, you can resend the game with the -r switch.

To start a new game, use the -n switch. Without a file, you will be prompted for your address, your opponent's address, and the filename for both your and your opponent's local game record. The game processor will then be invoked for you to make the first move. If a filename is specified, the address and filename data is taken from that file.

The -c flag causes the program to delete any extraneous files it might have created during a previous run which was abnormally terminated.

FILE FORMAT

 Leading garbage ignored
 ---GoGaMeStArT---
 TO: opponent@hissite
 TOFILE: his_game_record
 FROM: me@mysite
 FROMFILE: my_game_record
 FORMAT: format_code
 (
 Smart-Go game data
 )
 ---GoGaMeEnD---
 Trailing garbage ignored

The game data file contains a leading tag to indicate the start of the data. It contains both addresses, as should be used to mail the game files, and it contains the files to store the games in. In the example above, you are playing opponent@hissite, and the game is being stored in my_game_record.

The file format used can be either long, short, or extrashort indicated by L, S, and E respectively. The long format uses the full size Smart-Go file saved with no options from mgt. The extrashort format uses mgt with the -s option to save short format files. This format may cause problems for some mailers, however, because the lines will grow longer than 512 bytes. The short format is similar to the extrashort format but has extra newlines inserted. The short format is the default when selecting format from the prompt, but the long format is the default if a file contains no FORMAT line. When mailgo is used normally, the file specified on the command line is removed at successful completion, and the new game is saved to the file specified in the received game record. If the destination file does not look like a mailgo file, mailgo will query for confirmation.

FILES
mgt

Smart-Go.def, the Smart-Go format definition.

BUGS

If you attempt to start a new game, but are not the first player to make a real move, then you will have to convince mgt that you have changed the game record. Do this by pressing z twice on a blank spot to set and remove a black stone.

AUTHOR
Adrian Mariano (adrian@u.washington.edu)