1
AGiliTY, notes for DOS ports
2
----------------------------------------
4
(For a general introduction to this program, see the file README.AGI)
9
To run an AGT game file, run *agil* with the game file name as an
10
argument; don't include any extensions. For example, to run MYGAME, enter
14
Command line options can be seen by running agil without any
15
arguments, but most of them were intended for debugging the
16
interpreter and will not be of general interest. The one exception is
17
the -d command, which outputs metacommand debugging information which
18
will be of interest to authors developing AGT games.
24
The DOS global configuration file is the file AGIL.CFG in the same
25
directory as the executable; it can be used to set options you want to
26
hold for all games run with AGiliTy.
28
You can provide individual configuration of a particular game by
29
creating or editing the game-specific configuration file, which should
30
be in the same directory as the game data file(s) and should be named
31
<game name>.CFG; e.g. MYGAME.CFG. Options specified in the
32
game-specific file take precedence over ones in the global
36
The DOS port supports several additional options:
38
BIOS, which causes all output to go through the BIOS routines.
40
COLORS, which allows the interface color scheme to be
42
COLORS <normal> <highlight> <background> <reverse fore> <reverse back>
43
e.g COLORS LIGHTGRAY YELLOW BLACK WHITE BLUE, which is the default.
44
The colors are black, blue, green, cyan, red, magenta, brown,
45
lightgray, darkgray, lightblue, lightgreen, lightcyan, lightred,
46
lightmagenta, yellow, and white. Only the first eight can be used
47
as the background colors; all sixteen can be used for the other three
49
(The spellings COLOURS, lightgrey, and darkgrey are also recognized.)
51
COMPASS, which causes the possible exits to be listed on the status
54
NAVARROW-- Use the keys on the numeric keypad for entering
55
movement commands instead of for editing.
58
Define the text to be inserted on the line when a given function key is
59
typed. <key> can be 'F1', 'F2', 'F3', ..., 'F12'. (If NAVARROW is set,
60
then 'HOME', 'END', 'PGUP', 'PGDN', 'UP', 'DOWN', 'LEFT', 'RIGHT',
61
'INS', 'DEL', 'PLUS', and 'MINUS' can also be redefined.) The
62
default definitions are listed below. A '+' at the end of the last
63
word of the text will be converted to a newline.
65
HISTORY -- This specifies the size of the command history list.
66
A value of 0 indicates no limit (the interpreter will remember
67
every line you typed since the beginning of the game). For DOS, the
72
PATH -- This should contain a space-separated list of directories
73
which will be searched for AGT games.
75
BLOCK_CURSOR -- Use a block cursor instead of the usual flashing underbar.
77
50_LINE -- Display in 50-line mode.
83
The following keys can be used when typing in commands:
84
<Backspace>, <Delete> -- do what you would expect.
85
<Left Arrow>, <Right Arrow> -- Move left/right.
86
<Home> or <Ctrl-A> -- Move to beginning of the line.
87
<End> or <Ctrl-E> -- Move to end of the line.
88
<Up Arrow>, <Down Arrow> -- Scroll through past commands.
89
<Ctrl-K> -- Kill to end of line.
90
<Ctrl-Y> -- Yank back the last thing killed.
92
<F1>-<F12> -- These can be configured with strings of your choice;
93
see the KEY option above. By default, they are:
107
If NAVARROW is set, then the keys on the numeric keypad will generate
108
generate movement commands instead of being used for editing; these
109
can also be redefined with KEY:
125
The program *agtout* prints out the contents of AGT game files,
126
in human readable format, writing the output to standard output.
127
Under DOS, you will probably want to redirect the output to a file and
128
then view it with an editor; e.g.
129
AGTOUT MYGAME > MYGAME.LST
130
which will cause the output to go to MYGAME.LST.
131
Running it without arguments will give a list of command line options.
134
As described in README.AGI, AGT game files can be converted to the AGX
135
format by using AGT2AGX.EXE. Just type (for example):
137
C:\AGT> AGT2AGX MYGAME
139
This will create the file MYGAME.AGX from the other game files
140
You can use the '-o' option to give the output file a different name.
143
C:\AGT> AGT2AGX MYGAME -o THEGAME
145
will cause MYGAME.DA1...MYGAME.DA6, MYGAME.TTL, etc. to be converted into
149
NOTES ON THE DIFFERENT DOS RELEASES
151
There are now two binary releases for DOS: a 32-bit version and a
152
16-bit version. As of 1.0, only the 32-bit version is being actively
155
The 16-bit compiler is packaged as "agil092olddos.zip"; its only
156
benifit is that it will run on old (pre-386) computers that won't
157
run the 32-bit version. If you actually are in this situation, you
158
should drop me a note so that I know you exist.
160
The 32-bit version is built with the DJGPP compiler and packaged
161
with the supplementary program "cwsdpmi.exe", a freeware DPMI server
162
which should be left in the same directory as "agil.exe". More
163
information on DJGPP (including the source code to "cwsdpmi.exe") can
165
http://www.delorie.com/djgpp/
167
The copyright notice for CWSDPMI.EXE follows:
169
==================================================================
170
CWSDPMI is Copyright (C) 1995-1997 Charles W Sandmann (sandmann@clio.rice.edu)
171
1206 Braelinn, Sugar Land, TX 77479
173
This is release 4. The files in this binary distribution may be
174
redistributed under the GPL (with source) or without the source code
177
* CWSDPMI.EXE or CWSDPR0.EXE are not modified in any way except via
180
* Notice to users that they have the right to receive the source code
181
and/or binary updates for CWSDPMI. Distributors should indicate a
182
site for the source in their documentation.
183
==================================================================
b'\\ No newline at end of file'
added
removed
terps/agility/readme.dos
