File: mgt.doc

package info (click to toggle)
mgt 2.31-7
  • links: PTS
  • area: main
  • in suites: bullseye, sid, stretch
  • size: 460 kB
  • ctags: 582
  • sloc: ansic: 4,852; sh: 411; pascal: 329; makefile: 88; csh: 3
file content (726 lines) | stat: -rw-r--r-- 23,659 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726































































                                                                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