File: frotz.6

package info (click to toggle)
frotz 2.40-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 468 kB
  • ctags: 891
  • sloc: ansic: 6,774; makefile: 143; sh: 63
file content (446 lines) | stat: -rw-r--r-- 12,340 bytes parent folder | download
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
.\" -*- nroff -*-
.TH FROTZ 6 2.40
.SH NAME
frotz \- interpreter for Infocom and other Z-Machine games

.SH SYNOPSIS
.B frotz
.RI [ options "] " file

.SH DESCRIPTION
.B Frotz
is a Z-Machine interpreter.  The Z-machine is a virtual machine designed
by Infocom to run all of their text adventures.  It went through multiple
revisions during the lifetime of the company, and two further revisions
(V7 and V8) were created by Graham Nelson after the company's demise.
The specification is now quite well documented; this version of Frotz
supports version 1.0.
.P
This version of Frotz fully supports all these versions of the Z-Machine
except for version 6.  Version 6 is semi-supported by displaying the
outlines of V6 graphics with the picture number in the bottom-right
corner.

.P
This port supports old-style sound effects through the OSS sound driver.


.SH OPTIONS
.TP
.B \-a
Watch attribute setting.  Setting and clearing of attributes on objects
will be noted in debugging messages.
.TP
.B \-A
Watch attribute testing.  Every time the z-machine tests an attribute
value, the test and the result will be reported.
.TP
.B \-b <colorname>
Sets the default background color.  <colorname> corresponds to one of the
Z-machine colors, which are as follows:
.br
.B black red green yellow blue magenta cyan white
.br
If color support is disabled or not available on your terminal, this
option does nothing.
.TP
.B \-c N
Sets the number of context lines used.  By default, after a ``[MORE]''
prompt, and assuming there is enough output pending, Frotz will allow all
the currently visible lines to scroll off the screen before prompting
again.  This switch specifies how many lines of text Frotz will hold
over and display at the top of the next screen.
.TP
.B \-d
Disable color.
.TP
.B \-e
Enable sound.  If you've disabled sound in a config file and want to hear
sound effects, use this.
.TP
.B \-f <colorname>
Sets the default foreground color.  <colorname> corresponds to one of the
Z-machine colors, which are as follows
.br
.B black red green yellow blue magenta cyan white
.br
If color support is disabled or is not available on your terminal, this
option does nothing.
.TP
.B \-F
Force color mode.  If you've disabled color in a config file and want to
Frotz to display colors, use this.
.TP
.B \-h N
Manually sets the screen height.  Though most curses libraries are intelligent
enough to determine the current width from the terminal, it may sometimes
be necessary to use this option to override the default.
.TP
.B \-l N
Sets the left margin, for those who might have specific formatting needs.
.TP
.B \-o
Watch object movement.  This option enables debugging messages from the
interpreter which describe the moving of objects in the object tree.
.TP
.B \-O
Watch object location.  These debugging messages detail the locations of
objects in the object tree.
.TP
.B \-p
Plain ASCII output only.  This inhibits the output of accented letters
and other characters from the Latin-1 character set, replacing them with
reasonable alternatives.  This may be necessary on devices lacking these
characters.
.TP
.B \-P
Alter the piracy opcode.  The piracy opcode was never used by Infocom.  
This switch is really only useful for those who like to toy around with
Z-code.
.TP
.B \-q
Quiet.  Turns off sound effects.  Useful when running Frotz on a remote
machine and you don't want to bother whoever's near the console with weird
noises.
.TP
.B \-Q
No Quetzal.  By default, Frotz uses the new Quetzal save format when you
save your game.  If for some reason you want to save or restore using the
old Frotz format, use this flag.
.TP
.B \-r N
Sets the right margin.
.TP
.B \-s N
Set the random number seed value.  The given seed value is used as the initial
seed value on every restart. This is helpful for testing games like
.B Curses
which make random decisions before the first input (such that the hot
key Alt\-S does not really help).
.TP
.B \-S N
Set the transcript width.  By default your transscript files are formatted
to a width of 80 columns per line, regardless of the current screen width.
This switch allows you to change this setting. In particular, use \-S 0
to deactivate automatic line splitting in transscript files.
.TP
.B \-t
Sets the z-machine's
.I Tandy bit,
which may affect the behavior of certain Infocom games.  For example,
Zork I pretends not to have sequels, and Witness has its language
toned down.
.TP
.B \-u N
Sets the number of slots available for Frotz's multiple undo hotkey (see
below).  This defaults to twenty, which should be sufficient for most
purposes.  Setting too high a number here may be dangerous on machines
with limited memory.
.TP
.B \-w N
Manually sets the screen width.  Again, this should not be necessary
except in special circumstances.
.TP
.B \-x
Expand the abbreviations "g", "x", and "z" to "again", "examine", and
"wait".  This switch is for use iwth old Infocom games that lack these
common abbreviations which were introduced in later games.  Use it with
caution: A few games might use "g", "x" or "z" for different purposes.
.TP
.B \-Z N
Error checking mode.  
.br
0 = don't report errors.  1 = report first error
.br
2 = report all errors, 3 = exit after any error.
.br
Default is 0 (don't report errors).


.SH CONFIGURATION FILES
On startup,
.B frotz
will first check the system's frotz.conf then $HOME/.frotzrc for
configuration information.  The configuration file uses a simple
.br
<variable> <whitespace> <value> syntax.

.PP
Color names may be any of the following:
.br
black\ |\ red\ |\ green\ |\ blue\ |\ magenta\ |\ cyan\ |\ white

.PP
.BR color
\ \ yes\ |\ no
.br
Use color text.  Default is "yes" if supported.

.PP
.BR foreground 
\ \ <colorname>
.br
Set foreground color.  Default is terminal's default forground color.

.PP
.BR background
\ \ <colorname>
.br
Set background color.  Default is terminal's default background color.

.PP
.BR errormode
\ \ never\ |\ once\ |\ always\ |\ never
.br
Set error reporting mode.  Default is "once".

.PP
.BR zcode_path
\ \ /path/to/zcode/files:/another/path
.br
Set path to search for zcode game files.  This is just like the $PATH
environmental variable except that you can't put environmental variables
in the path or use other shortcuts.  For example, "$HOME/games/zcode" is
illegal because the shell can't interpret that $HOME variable.

.PP
.BR ascii
\ \ on\ |\ off
.br
Use plain ASCII only.  Default is "off".

.PP
.BR sound
\ \ on\ |\ off
.br
Turn sound effects on or off.  Default is "on".

.PP
.BR randseed
\ \ <integer>
.br
Set random number seed.  Default comes from the Unix epoch.

.PP
.BR undo_slots
\ \ <integer>
.br
Set number of undo slots.  Default is 500.

.PP
.BR tandy
\ \ on\ |\ off
.br
Set Tandy bit.  Default is off.  This may affect the behavior of certain
Infocom games.  For example, Zork I pretends not to have sequels, and
Witness has its language toned down.

.PP
.BR piracy
\ \ on\ |\ off
.br
Alter the piracy opcode.  Default is off.  The piracy opcode was never
used by Infocom. This option is only useful for those who like to toy
around with Z-code.

.PP 
.BR quetzal
\ \ on\ |\ off
.br
Use Quetzal save format.  Default is on.  If for some reason you want to
save or restore using the old Frotz format, set this to "off".

.PP 
.BR expand_abb
\ \ on\ |\ off
.br
Expand abbreviations.  Default is off.  Expand the abbreviations "g", "x",
and "z" to "again", "examine", and "wait".  This switch is for use with
old Infocom games that lack these common abbreviations which were
introduced in later games.  Use it with caution.  A few games might use
the "g", "x", or "z" for different purposes.

.P
The following options are really only useful for weird terminals, weird 
curses libraries or if you want to force a certain look (like play in
40-column mode).

.PP
.BR screen_height
\ \ <integer>
.br
Manually set screen height.  Most curses libraries are intelligent enough
to determine the current width of the terminal.  You may need to use this
option to override the default.

.PP
.BR screen_width
\ \ <integer>
.br
Manually set screen width.  Again, this should not be necessary except in
special circumstances.

.PP
.BR script_width
\ \ <integer>
.br
Set the transcript width.  Default is 80 columns per line, regardless of
the current screen width.  This switch allows you to change this setting.
You may set this to "0" to deactivate automatic line-splitting in
transcript files.

.PP
.BR context_lines
\ \ <integer>
.br
Set the number of context lines used.  By default, after a ``[MORE]''
prompt, and assuming there is enough output pending, frotz will allow all
the currently visible lines to scroll off the screen before prompting
again.  This switch specifies how many lines of text frotz will hold over
and display at the top of the next screen.  Default is "0".

.PP
.BR left_margin
\ \ <integer>
.br
Set the left margin.  This is for those who might have special formatting
needs.

.PP
.BR right_margin
\ \ <integer>
.br
Set the right margin.

.P
The following options are mainly useful for debugging or cheating.

.PP
.BR attrib_set
\ \ on\ |\ off
.br
Watch attribute setting.  Setting and clearing of attributes on objects
will be noted in debugging messages.  Default is "off"

.PP
.BR attrib_test
\ \ on\ |\ off
.br
Watch attribute testing.  Every time the z-machine tests an attribute
value, the test and the result will be reported.  Default is "off".

.PP
.BR obj_move
\ \ on\ |\ off
.br
Watch object movement.  This option enables debugging messages from the
interpreter which describe the movement of objects in the object tree.
Default is "off".

.PP
.BR obj_loc
\ \ on\ |\ off
.br
Watch object location.  These debugging messages detail the locations of
objects in the object tree.


.SH GAME-STATE SAVE FILES
In this Debian version,
Frotz creates the directory
.IR $HOME /.infocom
to place saved games into.
The default name for saved games is
.IR $HOME /.infocom/ <gamename> . <ext> ,
where
.I <gamename>
is the stem of the name of the game file,
and
.I <ext>
is
.B sav
if Quetzal format is in use, or
.B frotz
otherwise.


.SH ENVIRONMENT
If the ZCODE_PATH environmental variable is defined, frotz will search
that path for game files.  If that doesn't exist, INFOCOM_PATH will be
searched.


.PP
Latest information on Unix Frotz is here:
.br
http://www.cs.csubak.edu/~dgriffi/frotz/

.PP
The latest release of Unix Frotz is here:
.br
ftp://ftp.gmd.de/if-archive/infocom/interpreters/frotz/

.PP
See this website for a list of mirrors:
.br
http://www.ifarchive.org

.PP
See this website for more information on Infocom past, present, and
future; and where to get new Z-Machine games and the old ones by Infocom:
.br
http://www.csd.uwo.ca/Infocom/

.PP
Frotz for other platforms:
.br
http://www.geocities.com/SiliconValley/Heights/3222/frotz.html


.SH CAVEATS
.PP
The Z Machine itself has trouble with the concept of resizing a terminal.  
It assumes that once the screen height and width are set, they will never
change; even across saves.  This made sense when 24x80 terminals were the
norm and graphical user interfaces were mostly unknown.  I'm fairly sure
there's a way around this problem, but for now, don't resize an xterm in
which frotz is running.  Also, you should try to make sure the terminal
on which you restore a saved game has the same dimensions as the one on
which you saved the game.

.PP
You can use a path like "/usr/local/games/zcode:$HOME/zcode" with
$ZCODE_PATH or $INFOCOM_PATH because the shell will digest that $HOME
variable for you before setting $ZCODE_PATH. While processing frotz.conf
and $HOME/.frotzrc, a shell is not used. Therefore you cannot use
environmental variables in the "zcodepath" option within the config files.

.PP
This manpage is not intended to tell users HOW to play interactive
fiction.  Refer to the file HOW_TO_PLAY included in the Unix Frotz
documentation or visit one of the following sites:
.br
http://www.csd.uwo.ca/Infocom/faq.html
.br
http://www.ifarchive.org

.SH BUGS
This program has no bugs.  no bugs.  no bugs.  no *WHAP* thank you.

.SH AUTHORS
.B Frotz
was written by Stefan Jokisch in 1995-7.
.br
The Unix port was done by Galen Hazelwood.  
.br
Currently the Unix port is maintained by David Griffith.


.SH "SEE ALSO"
.BR nitfol (6)
.BR rezrov (6)
.BR jzip (6)
.BR xzip (6)
.BR inform (1)