Zoom has a built-in source-level debugger for games compiled with Inform. To work, it requires that you compile with Inform's -k option - this creates the gameinfo.dbg file that Zoom uses to find out how the Z-Code file relates to the source files. While debugging, it is recommended that you leave all files where Inform does, and run Zoom from the directory that the game was compiled in. Zoom will make an effort to find files if you don't do this, but it may not be able to find everything. Note that Zoom's debugger does not currently work in version 6 games.
Zoom's debug mode is intended to reach those parts that Infix can't. It does not provide the kind of object manipulation commands that Infix does, instead providing commands to single step through code, set breakpoints and even evaluation Inform expressions. It is a useful tool to help track down bugs that crash the interpreter, or problems with algorithms that Infix is too 'coarse' to track down.
To start Zoom in debug mode under X-windows, use the '-D' option
when starting Zoom (ie
zoom -D buggygame.z5). In the
Mac OS X version, run the Zoom application and tick the 'Debug
mode' checkbox in the initial open dialog. If Zoom can
successfully start debug mode, the game will be introduced with a
prompt similar to the following:
= loading symbols from 'gameinfo.dbg' = = Welcome to Zoom's symbolic debug mode = 664 symbols, 345 known routines, in 10 files = Type 'h' for help = == Parser:33 (Main) == [ Main; InformLibrary.play(); ]; = :
= : is Zoom's debug prompt: it indicates you can now
use debugging commands. Debug prompts are usually in blue on
white, and begin with an '=' sign, to distinguish them from the
game text. Debug commands all consist of a single letter. Some of
them can be followed by a parameter.
These commands control how the program is being run. They include commands to set breakpoints and step through the program.
Parser:33) - this sets a breakpoint at the given line in a particular file; the other form is simple
Main), which sets a breakpoint at the start of the specified function. Functions use the names that Inform gives them in the symbol file: these are usually the names that you give them, but to break in a function declared as part of an object, you need to use the 'Object.Function' form, and for a function in a class, 'Class::Function'.
s, but 'steps over' functions (ie, single steps to the next statement in the current function)
These commands allow you to inspect the current state of play of a program, by printing out the values of variables, for instance.
p location.n_to, for example). Zoom supports the following operators in expressions:
+ - * / % & | ~ . .& .# -> -->
Zoom written by Andrew Hunter. Mail any suggestions, bug reports or abuse to email@example.com