ZDEBUGTOOL(1)

NAME
zdebugtool - sneak into the depths of INFOCOM adventures

SYNOPSIS
zdebugtool [ -ghamotvdc ] [ -0123 ] [ file ]

DESCRIPTION
This little tool gives you an insight into the inner workings and hidden secrets of the classic INFOCOM (tm) text adventures.

It works with every INFOCOM game, whether it is an old standard one like Zork I or Deadline or one of the newer graphics games like Shogun or Zork Zero.

Additionally, it can be used to analyze the save files of all such games.

OPTIONS

-g  display name of game

-h  display game header structure

-a  display alphabet

-m  display macros

-o  display object list

-t  display object tree

-v  display (global) variables

-d  display dictionary

-c  check data file

-0  suppress enumeration

-1  suppress attributes

-2  decimal enumeration

-3  suppress property stuff

AUTHOR
This program was written by me, Paul David Doherty, in 1992.

Some ideas incorporated in this program came from other people involved with INFOCOM interpreters and debuggers, especially Mark Howell, Mike Threepoint, and Paul Smith. Sascha Wildner sent me some bug reports. Thanks a lot.

If you want to report any bugs or make any suggestions, you can contact me via Email. My address: h0142kdd@rz.hu-berlin.de
[ note: this email address is from 1993, it doesn't work any more. -- BW ]

This man page created from PDD's preformatted DebugTool.man by B. Watson, for SlackBuilds.org.

COPYRIGHTS
This program is freely distributable. However, it is not in the Public Domain, so please don't distribute modified versions without notifying me.

BUGS
There are no known bugs.

However, if you use the -t option, you should set the stack to 10000 (because the recursions will eat some stack).

Also, as the -t option performs quite a few jumps in the file, it can take a long time if the file is on a disk. It is advisable to put it on your hard disk or into RAM.

The program is written without using any Amiga-specific functions. I have tried to make it work on little-endian machines as well as big-endian ones. However, I had no possibility to test whether it compiles (and works) on any system apart from the Amiga.

VERSION HISTORY
1.00 (31.5.1992)

First public release.

1.01 (18.7.1992)

Externalised global variables. Made minor changes concerning the header flags.

1.02 (25.7.1992)

Added -c option.

1.03 (4.8.1992)

Minor changes again.

1.10 (1.11.1992)

Changed -v option to -d. Added (new) -v option. Added property stuff (in -o option) and -3 option. Changed attributes format (in -o and -t). Expanded -t option to seek for closed chains. Added debugging info. Minor fixes.

1.11 (6.5.1993)

Updated header flags and offsets.