Provided by: mgt_2.31-6_i386 bug

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)