File: mailgo.doc

package info (click to toggle)
mgt 2.31-7
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 460 kB
  • ctags: 582
  • sloc: ansic: 4,852; sh: 411; pascal: 329; makefile: 88; csh: 3
file content (198 lines) | stat: -rw-r--r-- 6,037 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



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