Fixed warning in model.c
[rodin/chimara.git] / interpreters / nitfol / options.texi
1 @item -ignore
2 @itemx -no-ignore
3 @itemx -i
4 Ignore Z-machine strictness errors.  Normally nitfol checks for illegal and undefined Z-machine behaviour and alerts the user.  If you're playing someone else's buggy game, this can be annoying and you should use this option.
5
6 @item -fullname
7 @itemx -no-fullname
8 @itemx -f
9 For running under Emacs or DDD.  Tells nitfol to give machine-recognizeable markers when stack frames are displayed instead of displaying the line. Only useful if you are using nitfol as an inferior debugger.
10
11 @item -command @var{file}
12 @itemx -x @var{file}
13 Read commands from this file.  Load a script from a file for playback in the game.
14
15 @item -pirate
16 @itemx -no-pirate
17 @itemx -P
18 Aye, matey.  Make the piracy opcode not branch, letting the game know the game disc is not ``genuine.'' Infocom never used this opcode and neither should you, but if obscurity amuses you...
19
20 @item -quiet
21 @itemx -no-quiet
22 @itemx -q
23 Do not print introductory messages.  For GDB compatibility.
24
25 @item -spell
26 @itemx -no-spell
27 Perform spelling correction.  Normally Z-machine games are unforgiving of typos (though they do have an @code{oops} command). If you type in a word which isn't in the game's dictionary and have typo correction enabled, nitfol will search for a word which is off by one letter by a substitution, deletion, insertion or transposition.
28
29 @item -expand
30 @itemx -no-expand
31 Expand one letter abbreviations.  Early Z-machine games don't include @kbd{x} as a synonym for @kbd{examine} and such.  If the first word in a sentence is one letter long and not recognized by the game, this will attempt to expand it to a full word.
32
33 @item -symbols @var{file}
34 @itemx -s @var{file}
35 Specify symbol file for game.  If you want to perform source-level debugging, you will need to specify a symbol file, which contains the names of variables and tells nitfol how source code corresponds to object code.
36
37 @item -tandy
38 @itemx -no-tandy
39 @itemx -t
40 Censors some Infocom games.  Some version 3 games perform minor wording changes when this bit is set to appease the sensitivity of Tandy Corporation.
41
42 @item -transcript @var{wfile}
43 @itemx -T @var{wfile}
44 Write transcript to this file.  This transcript begins as soon as the game starts.
45
46 @item -debug
47 @itemx -no-debug
48 @itemx -d
49 Enter debugger immediatly.  Imitate GDB by not automatically starting the story.
50
51 @item -prompt @var{string}
52 Specify debugging prompt.  This is the prompt nitfol prints when it is waiting for a debugging command (as opposed to the > the game story prints when waiting for a game command).  DDD requires this to be @samp{(gdb) }.
53
54 @item -path @var{string}
55 Look for games in this directory.  If nitfol cannot find the requested game in the current directory, it looks through the directories listed in the given colon separated string.  The directories specified here are also used to search for gamefiles from saved games.   If this option is not used, nitfol looks at the @code{INFOCOM_PATH} environment variable.
56
57 @item -autoundo
58 @itemx -no-autoundo
59 Ensure @code{@@save_undo} is called every turn.  If a turn passes with no @code{@@save_undo} between, this option performs the @code{@@save_undo} automagically.  Could cause problems with some games which have a different concept of a turn.
60
61 @item -stacklimit @var{number}
62 @itemx -S @var{number}
63 Exit when the stack is this deep.  If a game is infinitely recursing, nitfol will allocate large amounts of memory and take a long time before the problem is reported.  This option makes it fatal to recurse more than the given number of stack frames.  Setting this to 0 makes nitfol allow as many as fit contiguously in memory.  The Z-machine Standards Document recommends games use no more than 1024 words of total stack (frames and pushed data) in ZIP, which roughly works out to 90 routine calls deep.
64
65 @item -alias @var{string}
66 @itemx -a @var{string}
67 Specify an alias.  Adds an alias which will be expanded in read lines before tokenisation.  The alias is of the form @var{name} @var{value}; you will need to use quotes around it on the commandline.
68
69 @item -ralias @var{string}
70 Specify an recursive alias.  Adds an alias whose result is checked for further alias expansion.  Identical syntax to adding a normal alias.
71
72 @item -unalias @var{string}
73 Remove an alias.  Removes an alias previously added by -alias.  Useful for removing aliases in preference files.
74
75 @item -random @var{number}
76 @itemx -r @var{number}
77 Set random seed.  Normally the random number generator is initialized with the time of day.  If this option is used with a non-zero argument, the given number will be used to initialize the generator and for @code{@@random 0}.
78
79 @item -mapsym @var{string}
80 Specify mapping glyphs.  Nitfol draws maps using ASCII characters; you can choose which characters it uses to draw rooms.  Defaults to @samp{*udb@@UDB+}, which is, in order: empty room, room with down exit, room with up exit, room with up and down exits, room with player, room with player and up exit, room with player and down exit, room with player and up and down exits, bend symbol.
81
82 @item -mapsize @var{number}
83 Specify map size.  Determines the number of lines to be used for the map.
84
85 @item -maploc @var{string}
86 Specify map location.  Nitfol creates a Glk window for the map it generates.  The map can be placed @samp{above}, @samp{below}, to the @samp{right}, or the @samp{left}, of the main game window.  Follow this option with one those locations.
87
88 @item -terpnum @var{number}
89 Specify interpreter number.  Each port of Infocom's Z-machine interpreter was given a number.  @samp{1} for their own DECSystem-20, @samp{2} for Apple IIe, @samp{3} for Macintosh, @samp{4} for Amiga, @samp{5} for Atari ST, @samp{6} for IBM PC, @samp{7} for Commodore 128, @samp{8} for Commodore 64, @samp{9} for Apple IIc, @samp{10} for Apple IIgs, @samp{11} for Tandy Color.  Giving this option makes nitfol claim to be running on the specified system.  A few games change their behaviour slightly depending on which machine type they run.  By default nitfol claims to be on an Apple IIe, as this makes Beyond Zork not do character graphics.
90
91 @item -terpver @var{string}
92 Specify interpreter version.  Infocom's interpreters were given versions, typically a capital letter.  Nitfol defaults to @samp{N}, Frotz uses @samp{F}, and ZIP uses @samp{B}.  Any single character version is allowed.  Multicharacter options are read as a number instead of an ASCII character.  Only known effect upon games is the letter printed by banners and the @samp{version} command.  Version 6 games interpret this as a number instead of a letter.
93