File: mailgo.6

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 (126 lines) | stat: -rw-r--r-- 4,654 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
.TH MAILGO 6  "23 November 1992"
.SH NAME
mailgo - shell script for using mgt to automate email go games
.SH SYNOPSIS
.B mailgo [\-r] [\-n] [\-c] [\-e] [filename]
.SH DESCRIPTION
.B mailgo
helps manage email games by processing Smart-Go game records received by
mail, invoking mgt, and automatically sending your next move back.
.LP
Invoking 
.B mailgo 
with no flags instructs the program to search the specified file for a
go game, ignoring mail headers or other such garbage.  
.B mailgo 
will invoke the game processor specified in the environment variable
MAILGO or of this variable is undefined, will attempt to run 
.B mgt
from the inherited path.  If you give the filename -- then 
.B mailgo
will read its input from stdin, allowing you to redirect messages
into 
.B mailgo
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
.B mailgo
no other arguments.  (Technical note:  mgt is instructed to read its 
input from /dev/tty if you use this feature.)
.LP
If your opponent loses your move, you can resend the game with the \-r
switch.
.LP
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 opponent'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.
.LP
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*
.LP
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
.B mailgo.
.LP
.B mailgo 
also supports go board sizes of 9x9, 13x13 and 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
.B mailgo
's back.
.SH FILE FORMAT
.LP
.sp
.if
 Leading garbage ignored

 ---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
.fi
.LP
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.
.LP
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
danger of causing mailer problems. 
The short format is similar 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 
.B mailgo
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, 
.B mailgo
will query for confirmation.
.LP
When a new game is started, the first mailgo message contains the line
NEWGAME inserted before the FORMAT line.  This is used to check for
the overwriting of old game records.  
.SH FILES
mgt
.LP
Smart-Go.def, the Smart\-Go format definition.
.sp
.SH BUGS
.LP
.B mailgo 
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. 
.fi
.sp
.SH AUTHOR
Adrian Mariano (adrian@bsdserver.ucsf.edu)