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
|
MAILGO(6) MAILGO(6)
NNAAMMEE
mailgo - shell script for using mgt to automate email go
games
SSYYNNOOPPSSIISS
mmaaiillggoo [[--rr]] [[--nn]] [[--cc]] [[--ee]] [[ffiilleennaammee]]
DDEESSCCRRIIPPTTIIOONN
mmaaiillggoo helps manage email games by processing Smart-Go
game records received by mail, invoking mgt, and automati-
cally sending your next move back.
Invoking mmaaiillggoo with no flags instructs the program to
search the specified file for a go game, ignoring mail
headers or other such garbage. mmaaiillggoo will invoke the
game processor specified in the environment variable
MAILGO or of this variable is undefined, will attempt to
run mmggtt from the inherited path. If you give the filename
-- then mmaaiillggoo will read its input from stdin, allowing
you to redirect messages into mmaaiillggoo 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 mmaaiillggoo 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 oppo-
nent'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 mmaaiillggoo..
mmaaiillggoo also supports go board sizes of 9x9, 13x13 and
23 November 1992 1
MAILGO(6) MAILGO(6)
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 mmaaiillggoo
FFIILLEE FFOORRMMAATT
---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 dan-
ger of causing mailer problems. The short format is simi-
lar 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 mmaaiillggoo 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,
mmaaiillggoo will query for confirmation.
When a new game is started, the first mailgo message con-
tains the line NEWGAME inserted before the FORMAT line.
This is used to check for the overwriting of old game
records.
FFIILLEESS
mgt
Smart-Go.def, the Smart-Go format definition.
23 November 1992 2
MAILGO(6) MAILGO(6)
BBUUGGSS
mmaaiillggoo 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.
AAUUTTHHOORR
Adrian Mariano (adrian@bsdserver.ucsf.edu)
23 November 1992 3
|
