1





MGT(6)                                                     MGT(6)


NNAAMMEE
       mgt  - game record display/editor for the oriental game of
       go

SSYYNNOOPPSSIISS
       mmggtt [-m filename] [-s] [-t] [files]

DDEESSCCRRIIPPTTIIOONN
       Go is an ancient oriental strategy game based on the  cap-
       turing of territory.  The players alternate putting stones
       on the board, trying to surround as many  empty  intersec-
       tions as possible.

       MMggtt  allows the user to examine Go game tree files created
       through the Macintosh(tm) programs  SSmmaarrtt--GGoo  ((ttmm))  or  GGoo
       EExxpplloorreerr  ((ttmm))..   MMggtt  also has basic Go game tree editing
       capabilities and may be used to create or edit  game  tree
       files.   The  on-line material provided by a rather exten-
       sive and growing database allows many  hours  of  instruc-
       tional enjoyment of various studies and tutorials concern-
       ing the game of Go.

       MMaaiillggoo is a utility which manages E-mail  Go  games  using
       mmggtt  as  the  Go  board editor.  It is included in the mmggtt
       package.

       The mmggtt program was originally developed to be a companion
       for  the  series,  "From  My  Go  Teacher",  archived bsd-
       server.ucsf.edu for ftp.  Also available is  the  Internet
       GO  Board communications program, 'go', also by Greg Hale,
       which connects up two terminals in real-time  anywhere  in
       the world, and the clients for the Internet Go Server.

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
       --mm ffiilleennaammee
               Invoke a set of options used by the mmaaiillggoo program
               for managing email games.  If a filename is speci-
               fied  for  loading (see below), the game record is
               loaded, and mmggtt automatically moves to the end  of
               the  main  variation of the game record.  The game
               can be modified without confirmation.  If the game
               record has been modified, it will be automatically
               saved, on exit, to the  filename  specified  after
               the -m and mmggtt will return success (zero).  If the
               game record has not been modified, or has not been
               allowed  to be saved, then mmggtt will return failure
               (nonzero).


       --ss      Change save format used to write save files.   The
               default  save  format  is the long format Smart-Go
               file.  Using this option results in  short  format
               Smart-Go files.




                           9 July 1993                          1





MGT(6)                                                     MGT(6)


       --tt      Invoke  tutor  mode where you select variations by
               playing on the board.  The key for making  a  move
               has  special  behavior in this mode.  See the sec-
               tion on the "space or 0" keyboard  command  for  a
               description.


       ffiilleess   These  are  the  files to be loaded.  The Unix and
               IBM version support  wildcards.   If  no  file  is
               specified,  mmggtt  loads  a  blank  board.   If  you
               attempt to modify a file that was loaded, mmggtt will
               prompt for confirmation the first time.


OOPPEERRAATTIIOONN
       MMggtt  can  be  used to view and edit game records, or as an
       electronic game board for a two person  game.   There  are
       many  keyboard  commands which execute the various editing
       and display functions.


       >       Step down the game tree to the next move.  Stop at
               the  end  of  a  variation  and do not visit other
               variations.


       <       Move back up the game tree.  (Previous move)


        .      Go to the next node using a tree  traversal  which
               will  visit  all  nodes.   Sometimes  the order of
               traversal can be confusing.


       ,       Go to the previous node --  the  opposite  of  "."
               forward movement.


       e       Go to end of the current variation.


       b       Go to beginning of the game tree.


       }       Go forward like the "." command until a comment.


       {       Go backwards like the "," command until a comment.


       g       Go to a specified node.  Type in the desired  node
               number.





                           9 July 1993                          2





MGT(6)                                                     MGT(6)


       ]       Move  forward until there is a variation branch in
               the game tree.


       [       Move backwards until there is a  variation  branch
               in the game tree.


       k and i Scroll the game tree variation window up and down.
               A - at the top of the variation window, and a + at
               the  bottom  indicate  that  more  variations  are
               available.


       j and u Scroll comment window up and down.  A - at the top
               of  the  comment,  and  a + at the bottom indicate
               that more comments are available.


       #       Load new file.  Will prompt  for  confirmation  if
               the current file has been modified.


       r       Load  previous  file.   (Reverse  through the file
               list)


       f       Load next file.  (Forward through the file list)


       w       Write out Smart-Go file.  Will prompt for a  file-
               name.   The  special filename * will save with the
               current name (which appears  in  the  upper  right
               corner).


       space or 0
               Make a move.  The current player turn is indicated
               by the > < around the captured stones on the lower
               right.   Normally,  this adds the move to the game
               tree and moves to a new node.  In tutor  mode,  it
               checks  the various game continuations.  If one of
               them contains the move you made, it moves to  that
               variation.   If  not,  it prints an error message.
               The game tree cannot be modified in tutor mode.


       p       Pass.  Enter a pass move.


       o       Other player.  Changes whose turn it is, adding  a
               token  in  the game tree to force the change when-
               ever this node  is  visited.   If  the  player  is
               forced by such a token, the current player turn is



                           9 July 1993                          3





MGT(6)                                                     MGT(6)


               indicated by } { characters on the lower right.


       t       Toggle stone color.   Changes  whose  turn  it  is
               without  adding any tokens in the game tree.  This
               will not work if the game tree has a PLayer  token
               (generated by the o key) at the current node.


       z       Set/unset black stones.


       x       Set/unset white stones.


       q or ESC.
               Quit.   q  will prompt for confirmation.  ESC will
               not prompt for confirmation.


       v       Create a variation below the  current  node.   The
               variation will initially contain a null node.  You
               must move to that variation to make a move in  it.
               If  the  "v" command is invoked at a node which is
               at the end of a variation, variation "A"  is  cre-
               ated  with a null node.  Subsequent invocations of
               the "v" command will create the "B", "C"... varia-
               tions.


       !       Cut  tree.   Moves the current node and everything
               below it to a temporary  holding  buffer.   (Moves
               your  location  back to the parent of the node you
               are one when you invoke it.)


       ^       Paste tree.  Pastes the temporary  holding  buffer
               in  after the current node.  Usually the  opposite
               of cutting the tree.


       c       Edit the current comment.  The editor has two mod-
               els  of  operation.   The  default  model has been
               vaguely designed after emacs.  That means that the
               editor   commands  are  either  'control-key'   or
               'escape-key'.   The  controls   are   configurable
               through  an  environment  variable.   The notation
               "^key" is  used  to  indicate  control  keys,  and
               "]key"  is  used  to indicate keys which should be
               preceeded by the escape character.

               On some terminals, instead  of  ESC-key,  you  can
               press  Alt-key  or Meta-key.  (On the IBM version,
               you can use the Alt key.)  Under VMS, the ESC  key



                           9 July 1993                          4





MGT(6)                                                     MGT(6)


               does not work.  VMS users may need to redefine the
               edit keys.

               The second edit model was vaguely  designed  after
               vi.  That means that the editor has a command mode
               for cursor movement, etc. and an insert  mode  for
               inserting  text.   The  vi  model editor starts in
               insert mode.  The ESC key changes mode from insert
               mode to command mode.  If pressed in command mode,
               the ESC key exits the comment editor and saves the
               comment.   The  letters below are typed in command
               mode to obtain the specified function.   To  leave
               command  mode  and enter insert mode, you must use
               the function which is listed as  the  insert  mode
               command.  This defaults to 'R'.   To select the vi
               like mode of operation, put _ASCEDVI in  your  MGT
               environment variable.

               Defaults are:
                          Command                emacs   vi
                   cursor up    (previous line)  ^P      k
                   cursor down  (next line)      ^N      j
                   page up      (prev page)      ]p      ^B
                   page down    (next page)      ]n      ^F
                   cursor left  (back)           ^B      h
                   cursor right (forward)        ^F      l
                   beginning of line             ^A      0
                   end of line                   ^E      $
                   beginning of comment          ]<      H
                   end of comment                ]>      L
                   delete one character          ^D      x
                   delete to end of line (kill)  ^K      D
                   toggle insert mode            ^I      R
                   save comment                  ]z      w
                   exit, don't save comment      ^W      q

               Pressing  c on a comment larger than the 120 lines
               allocated for comments will cause the extra to  be
               lost.   Also,  on  terminals which generate IBM PC
               arrow key codes, the  arrow  keys  will  correctly
               move  the  cursor  within the comment editor.  The
               arrow keys only work in the emacs based model.


       d       Delete node.  Deletes the current node,  replacing
               it  with  its  child.   If the current node has no
               child, then clear the properties  of  the  current
               node.


       n       Name  the  current node.  You will be prompted for
               the name.





                           9 July 1993                          5





MGT(6)                                                     MGT(6)


       s       Score the game.  After selecting  this,  move  the
               cursor around and remove the dead groups with 0 or
               space.  You can undo one (and only one) kill  with
               the  u  key.   Pressing return will score the game
               and print the  (Japanese)  score  in  the  comment
               area.   If  you  missed some dead groups, continue
               removing them.  Press q  when  you  wish  to  exit
               scoring mode.  You will be prompted to either keep
               the score information as a comment for the current
               node or restore the old comment.


       Ctrl-I  Enter info mode.  In this mode, the various infor-
               mational properties of the current file  are  dis-
               played  and may be edited.  To edit an item, press
               the letter associated with it, and enter  the  new
               text.   This letter must be entered in upper case.
               To see a list of letters, press  ?.   The  comment
               window  scrolling  keys  can be used to scroll the
               info display.  The supported info properties  are:
               Size,  Handicap,  playerBlack,  bLackrank, player-
               White, whIterank, Gamename,  Event,  rouNd,  Date,
               Place,  Time,  Result,  gameComment, sOurce, User,
               Komi.  The capital letters in this  list  indicate
               which letter selects that info property.


       Ctrl-T  Toggle tutor mode.  (See the section on space or 0
               for explanation.)


       Ctrl-W  Toggle the format used for writing Smart-Go  files
               between long and short.


       Ctrl-L  Refresh the screen.


       Ctrl-F  Save the current screen to a file.


       ?       Display a help screen.


       12346789
               Move  the cursor around.  Assumes standard numeric
               keypad orientation.


EENNVVIIRROONNMMEENNTT SSEETTTTIINNGGSS
       All of the characters used for the commands and  the  dis-
       play  are configurable via environment variables.  For the
       ascii interface, use:




                           9 July 1993                          6





MGT(6)                                                     MGT(6)


       setenv MGT '_ASCCOM:q><.,eb}{][gwzxv\!lm#^cdn
                           spotrfLWTFI012346789kiju&
                   _ASCCHAR:#O:+-.+|-++++
                   _ASCINV _ASCED:PNpnBFAE<>DKIzO'
              (command should appear all on one line with a
               single space separating _ASC... from the
               previous string.)


       to get the default characters.  (This is csh syntax.   For
       other  shells,  the syntax will be different.)  Place this
       line in your .cshrc so the alternate characters are always
       in effect.

       The  _ASCCOM string allows you to change the keyboard com-
       mands.  Upper case letters stand for control characters.

       The _ASCCHAR string specifies the display characters.  For
       example,  to  use @ for black stones, change the # to @ in
       the _ASCCHAR string.  You need only include one of the two
       declarations  ("_ASCCOM:" or "_ASCCHAR:") if you only want
       to change the commands or characters but not both.

       To set the default display  type  to  inverse  video,  use
       _ASCINV in the MGT environment variable.

       To  set the comment editor commands, use _ASCED in the MGT
       environment variable.

       For the _ASCED environment variable setting in  the  emacs
       based editor model, control keys are specified with a cap-
       ital letter, and ESC keys are anything which is not a cap-
       ital  letter.   This  is  the key string for the defaults:
       PNpnBFAE<>DKIzO.  Note that ^V, ^O, ^C  and  ^Z  are  poor
       characters  to  use for anything if you have berkeley unix
       because the berkeley tty drivers interpret  these  charac-
       ters.   The  ^V  character  is the quoting character which
       quotes the following character.  You will need to press it
       twice  for mgt to see it.  The other characters have to be
       quoted by first pressing ^V or mgt will not recognize your
       keypress.   You  cannot  use ^H or ^? for anything because
       the  editor  always  interprets   these   as   destructive
       backspace.

       For  the  _ASCED  environment  variable  setting in the vi
       based editor model, no special processing is done  on  the
       characters.   In  order  to specify control keys, you must
       place actual  control  characters  into  your  environment
       string.   The  default string has two control commands (^B
       and ^F) defined.  This is the default:  kj^B^Fhl0$HLxDRwq.
       The  vi  based  editor  model may be selected be including
       _ASCEDVI in the environment variable.

       If you wish to include control characters in your  string,



                           9 July 1993                          7





MGT(6)                                                     MGT(6)


       you  can  do this most easily by editing a file which sets
       the environment.  Vi can insert most of the control  char-
       acters directly.

       In all cases, when you set your own keys, you must set all
       of the keys, and they must appear in  the  correct  order.
       If  you  give  assign the same key to different functions,
       then an arbitrary one will be used by mmggtt  and  the  other
       functions  will be unavailable.  If multiple contradictory
       specifications occur in the mmggtt environment variable,  the
       last  that appear will be used by the program.  Any option
       not specified will assume the  default  values  identified
       above.

       With  the  IBM  version,  the same effects may be achieved
       under DOS 4.0 or DOS 5.0 with a SET command placed in  the
       AUTOEXEC.BAT  file.   Under  previous DOS versions, quotes
       were interpreted literally and "|", ">" and "<" characters
       have special meanings and thus cannot be put into environ-
       ment variables with the SET command.

       Under VMS, the command is just MGT = "_ASCCHAR:..."


CCOOMMMMEENNTT FFOORRMMAATTTTIINNGG
       Comments are expected to consist of long  lines,  each  of
       which  is  one paragraph.  A single long line will be for-
       matted to fit the display.  Line breaks will be ignored if
       they  are preceeded by a space, but will be respected oth-
       erwise.

DDIISSPPLLAAYYSS
       All displays have in common the purpose of displaying a go
       tree.

       AASSCCIIII ddiissppllaayy::
           AA BB CC DD EE FF GG HH  SS TT
          ++------------------------------  ------++   --SSuuppppoossee tthhiiss iiss tthhee sseeccoonndd
        1199||.. .. .. ## .. .. .. ..  .. ..||1199|| lliinnee ooff tthhee ccoommmmeenntt..  SSiinnccee
        1188||.. OO OO ## ## ## OO ..  .. ..||1188|| tthheerree iiss ssoommee mmoorree ooff tthhee
        1177||.. ## ## OO OO OO OO ..  .. ..||1177|| ccoommmmeenntt aabboovvee uuss uunnsseeeenn,,
        1166||.. ## OO ++ .. .. .. ..  .. ..||1166|| tthhee -- aappppeeaarrss ttoo tthhee lleefftt
        1155||.. ## OO .. OO .. .. ..  .. ..||1155|| ooff ''SSuuppppoossee''..
        1144||.. .. ## OO .. .. .. ..  .. ..||1144||
        1133||.. .. ## .. .. .. .. ..  .. ..||1133||
        1122||.. .. .. .. .. .. .. ..  .. ..||1122||
        1111||.. .. .. .. .. .. .. ..  .. ..||1111|| AAnndd hheerree,, wwhheenn tthheerree iiss
        1100||.. .. .. ++ .. .. .. ..  .. ..||1100|| mmoorree ooff tthhee ccoommmmeenntt
         99||.. .. .. .. .. .. .. ..  .. ..|| 99|| bbeellooww,, tthhee ''++''
         88||.. .. .. .. .. .. .. ..  .. ..|| 88||++aappppeeaarrss ttoo oouurr lleefftt..
         77||.. .. .. .. .. .. .. ..  .. ..|| 77||
         66||.. .. .. .. .. .. .. ..  .. ..|| 66||   NNooddee ##117733:: NNaammee
         55||.. .. .. .. .. .. .. ..  .. ..|| 55||--BB:: vvaarriiaattiioonn 11 hhiitt ''BB'' ttoo sseeee
         44||.. .. .. ++ .. .. .. ..  .. ..|| 44|| CC:: vvaarriiaattiioonn 22 hhiitt ''CC''



                           9 July 1993                          8





MGT(6)                                                     MGT(6)


         33||.. .. .. .. .. .. .. ..  .. ..|| 33|| DD:: vvaarriiaattiioonn 33 eettcc......
         22||.. .. .. .. .. .. .. ..  .. ..|| 22|| EE:: vvaarriiaattiioonn 44
         11||.. .. .. .. .. .. .. ..  .. ..|| 11||++FF:: vvaarriiaattiioonn 55
          ++------------------------------  ------++    ?? ffoorr hheellpp    rreeaadd   lloonngg
           AA BB CC DD EE FF GG HH  SS TT
        BBllaacckk ##1111 aatt ''DD1199''               ##:: 00      >> OO:: 00 <<

       The bottom line indicates that Black has  just  made  move
       #11.   On  the bottom right, the angle brackets around the
       white stone indicate that it is White's turn.  Above that,
       the  word  "read"  indicates that the Smart-Go file hasn't
       been modified, and "long" indicates that the default  save
       format  is  the long format.  "Read" will change to "edit"
       if you modify the file, and it will  say  "tutor"  if  you
       enter tutor mode.

FFIILLEESS
       wrapmgt - prepare short format Smart-Go files for mailing

       mailgo - email go game management

       mgt2short - script to convert Smart-Go files to short for-
       mat

       RULES - an introduction to the game in Smart-Go format.

       The FFrroomm MMyy GGoo TTeeaacchheerr tutorial lessons, and many  profes-
       sional game records all available at bsdserver.ucsf.edu

       Internet go, a program to play go over internet, available
       on bsdserver.ucsf.edu

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


BBUUGGSS
       Comment editing is limited to 120 screen lines.

       Most, but not all, of the  Smart-Go  properties  are  sup-
       ported.

       Send   bug   reports   to  "adrian@bsdserver.ucsf.edu"  or
       "hale@scam.Berkeley.EDU"


AAUUTTHHOORRSS
       Greg Hale

       Jeff Boscole

       Adrian Mariano (adrian@bsdserver.ucsf.edu)

       Mike Dobbins (mdobbins@asns.tredydev.unisys.com)




                           9 July 1993                          9





MGT(6)                                                     MGT(6)


SSEEEE AALLSSOO
       rec.games.go - a newsgroup on the game
       Graded go problems for beginners, vol 1-4, Ishi Press
       In the Beginning, Ishi Press.
       The Treasure Chest Enigma, Ishi Press.




















































                           9 July 1993                         10