NAME

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

SYNOPSIS

       mailgo [-r] [-n] [-c] [-e] [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 you give the filename -- then mailgo will
       read its input from stdin, allowing you to redirect messages  into  mailgo  directly  from
       your  mailer.   Your  mail  program  may  not  support  redirecting messages into external
       programs.  Check it's man page to find out.  This option to use stdin as the input is only
       valid  if you give mailgo no other arguments.  (Technical note:  mgt is instructed to read
       its input from /dev/tty if you use this feature.)

       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  switch  causes  the  program to delete any extraneous files it might have created
       during a previous run which was abnormally terminated.  These files have the form: MailGo*

       To edit the mailgo headers (including mail addresses, file names and game  record  format)
       or  the  game  record, use the -e switch with the file name of the mailgo file you wish to
       edit.  The file may be a saved mailgo mail message or a processed mailgo game  file.   The
       -e  option  will  not  mail changes because of the possibility of confusing addresses.  To
       mail edited files, use 'mailgo <file>' for edited mail messages and 'mailgo -r <file>' for
       edited files which have been previously processed by mailgo.

       mailgo  also  supports  go  board  sizes  of 9x9, 13x13 and 19x19.  Handicaps maybe set to
       values of 2-4 for 9x9 games, 2-5 for 13x13 games and 2-9 for 19x19 games.  Any other board
       size or handicap must be set behind mailgo's back.

FILE FORMAT

        ---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.  In any game record format, if very long comments are created, there is  a
       danger  of  causing mailer problems.  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.

       When  a  new  game is started, the first mailgo message contains the line NEWGAME inserted
       before the FORMAT line.  This is used to check for the overwriting of old game records.

FILES

       mgt

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

BUGS

       mailgo tries to handle the case where you start a new game but do not make the first move.
       If  after  the first move you have a reason to convince mgt that you have changed the game
       record without really changing anything, you should enter and exit the comment editor.

AUTHOR

       Adrian Mariano (adrian@bsdserver.ucsf.edu)

                                         23 November 1992                               MAILGO(6)