| 1 |
WHAT IS ITWEAK? |
| 2 |
|
| 3 |
'itweak' is an interactive debugging utility for the Icon programming |
| 4 |
language. The idea is that you compile your Icon program to ucode |
| 5 |
files (.u1, .u2). 'itweak' then tweaks the ucode, inserting potential |
| 6 |
breakpoints. The resulting ucode files are linked with a debugging |
| 7 |
run-time and off you go. The 'itweak' system provides you with most of |
| 8 |
the facilities you would expect from an interactive debugger, |
| 9 |
including the ability to evaluate a wide range of Icon expressions. |
| 10 |
|
| 11 |
PREREQUISITES |
| 12 |
|
| 13 |
'itweak' requires Icon 8.10 or higher. It is completely written in |
| 14 |
Icon, and thus as portable as Icon itself. |
| 15 |
|
| 16 |
INSTANT ITWEAK -- UNIX |
| 17 |
|
| 18 |
Assuming you have the itweak distribution in the form of a file named |
| 19 |
'itweak-<version>.tar.gz' (where <version> is a version designator): |
| 20 |
uncompress and untar the file. This can be done in a single step, |
| 21 |
|
| 22 |
gunzip < itweak-<version>.tar.gz | tar xvf - |
| 23 |
|
| 24 |
This will create an installation directory in the current directory. |
| 25 |
The name of the installation directory will be 'itweak-<version>'. |
| 26 |
|
| 27 |
To install itweak, type 'make' in the installation directory. Run a |
| 28 |
demo session by typing 'make demo'. |
| 29 |
|
| 30 |
OTHER SYSTEMS -- NOT SO INSTANT |
| 31 |
|
| 32 |
For systems other than Unix, and for more information, please refer to |
| 33 |
the documentation. |
| 34 |
|
| 35 |
DOCUMENTATION |
| 36 |
|
| 37 |
There is a description in the form of an HTML file. |