Provided by: mgt_2.31-7_amd64 bug

NAME

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

SYNOPSIS

       mgt [-m filename] [-s] [-t] [files]

DESCRIPTION

       Go  is an ancient oriental strategy game based on the capturing of territory.  The players
       alternate putting stones on the board, trying to surround as many empty  intersections  as
       possible.

       Mgt  allows  the  user  to  examine  Go  game tree files created through the Macintosh(tm)
       programs Smart-Go (tm) or Go Explorer (tm).  Mgt 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 extensive and growing database allows  many  hours  of  instructional
       enjoyment of various studies and tutorials concerning the game of Go.

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

       The mgt program was originally developed to be a companion for the  series,  "From  My  Go
       Teacher",  archived  bsdserver.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.

COMMAND LINE OPTIONS

       -m filename
               Invoke a set of options used by the mailgo program for managing email games.  If a
               filename is specified for loading (see below), the game record is loaded, and  mgt
               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
               mgt will return success (zero).  If the game record has not been modified, or  has
               not been allowed to be saved, then mgt will return failure (nonzero).

       -s      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.

       -t      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 section on the
               "space or 0" keyboard command for a description.

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

OPERATION

       Mgt 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.

       ]       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 filename.  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 whenever this node is visited.  If the  player  is  forced  by  such  a
               token, the current player turn is 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
               created with a null node.  Subsequent invocations of the "v" command  will  create
               the "B", "C"... variations.

       !       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 models 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 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.

       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  informational  properties  of  the
               current  file  are displayed 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, playerWhite, 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.

ENVIRONMENT SETTINGS

       All  of  the  characters  used  for  the  commands  and  the  display are configurable via
       environment variables.  For the ascii interface, use:

       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 commands.  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 capital letter, and ESC keys are anything  which  is  not  a  capital
       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  characters.   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, you can do this most easily by
       editing a file which sets the environment.  Vi can insert most of the  control  characters
       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 mgt and the other functions will be unavailable.  If
       multiple contradictory specifications occur in the mgt 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 environment variables with the SET command.

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

COMMENT FORMATTING

       Comments  are expected to consist of long lines, each of which is one paragraph.  A single
       long line will be formatted to fit the display.  Line breaks will be ignored if  they  are
       preceeded by a space, but will be respected otherwise.

DISPLAYS

       All displays have in common the purpose of displaying a go tree.
    A B C D E F G H  S T
   +---------------  ---+   -Suppose this is the second
 19|. . . # . . . .  . .|19| line of the comment.  Since
 18|. O O # # # O .  . .|18| there is some more of the
 17|. # # O O O O .  . .|17| comment above us unseen,
 16|. # O + . . . .  . .|16| the - appears to the left
 15|. # O . O . . .  . .|15| of 'Suppose'.
 14|. . # O . . . .  . .|14|
 13|. . # . . . . .  . .|13|
 12|. . . . . . . .  . .|12|
 11|. . . . . . . .  . .|11| And here, when there is
 10|. . . + . . . .  . .|10| more of the comment
  9|. . . . . . . .  . .| 9| below, the '+'
  8|. . . . . . . .  . .| 8|+appears to our left.
  7|. . . . . . . .  . .| 7|
  6|. . . . . . . .  . .| 6|   Node #173: Name
  5|. . . . . . . .  . .| 5|-B: variation 1 hit 'B' to see
  4|. . . + . . . .  . .| 4| C: variation 2 hit 'C'
  3|. . . . . . . .  . .| 3| D: variation 3 etc...
  2|. . . . . . . .  . .| 2| E: variation 4
  1|. . . . . . . .  . .| 1|+F: variation 5
   +---------------  ---+    ? for help    read   long
    A B C D E F G H  S T
 Black #11 at 'D19'               #: 0      > O: 0 <

       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.

FILES

       wrapmgt - prepare short format Smart-Go files for mailing

       mailgo - email go game management

       mgt2short - script to convert Smart-Go files to short format

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

       The  From My Go Teacher tutorial lessons, and many professional 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.

BUGS

       Comment editing is limited to 120 screen lines.

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

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

AUTHORS

       Greg Hale

       Jeff Boscole

       Adrian Mariano (adrian@bsdserver.ucsf.edu)

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

SEE ALSO

       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                                     MGT(6)