home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / comdore / 64apps / diverkey.bny / HINST < prev    next >
Text File  |  1987-04-20  |  4KB  |  131 lines
  1.                    Diversi-Hack(tm)
  2.                     By Bill Basham
  3.                Copyright 1987 DSR, Inc.
  4.                      Version 1.1 
  5.                      INSTRUCTIONS
  6.  
  7. Diversi-Hack is included free on the Diversi-Cache and Diversi-Key
  8. program disks.  To legally use Diversi-Hack, you must purchase either
  9. Diversi-Cache or Diversi-Key.  Ordering information is included
  10. below.
  11.  
  12. INTRODUCTION:
  13.  
  14. Diversi-Hack requires an Apple //gs.  With Diversi-Hack installed,
  15. you can then interrupt your other programs at any time, and enter the
  16. Apple //gs built-in monitor.  While in the monitor, you can examine
  17. and change anything in the //gs memory, and then continue your
  18. program where it left off.
  19.  
  20. INSTALLATION:
  21.  
  22. Diversi-Hack is a location-independent binary file which you can BRUN
  23. under ProDOS or DOS 3.3, or even change to a system file.  You
  24. install Diversi-Hack with "BRUN HACK".  A beep means the program was
  25. already installed, or no memory is available.
  26.  
  27. Note: To avoid the beep, POKE 0,0.
  28.  
  29. Diversi-Hack stays installed when you boot your other programs, even
  30. with ctrl-open-apple-reset.
  31.  
  32. REMOVAL:
  33.  
  34. You can remove Diversi-Hack by turning the power switch off for 10
  35. seconds or so, but this will eventually wear out the switch.  You can
  36. simulate a power-off re-boot as follows:
  37.  
  38. 1. Hold OPEN-APPLE_SHIFT_CONTROL keys down.
  39. 2. Press and release RESET key.
  40. 3. Wait for 2 beeps.
  41. 4. Release OPEN-APPLE_SHIFT_CONTROL keys.
  42.  
  43. This will remove Diversi-Hack, and clear your Ramdisk (if any).
  44.  
  45. CALLING DIVERSI-HACK:
  46.  
  47. Diversi-Hack installs itself as a "Desk Accessory".  To activate
  48. Diversi-Hack, press CONTROL_OPEN-APPLE_ESCAPE, like you do to enter
  49. the //gs control panel.  Then choose "Diversi-Hack" from the desk
  50. accessory menu.  Then, press "P" to print the text screen, or "M" to 
  51. enter the monitor.
  52.  
  53. Some programs run with interrupts disabled, meaning you can't get to
  54. the Desk Accessories or Diversi-Hack.
  55.  
  56. PRINTING THE TEXT SCREEN:
  57.  
  58. Diversi-Hack will print the current 40 or 80 column text screen to
  59. the printer in slot #1.  Inverse and "mouse-text" are printed as
  60. their corresponding characters.
  61.  
  62. USING THE MONITOR:
  63.  
  64. Press "M" to enter the Apple //gs monitor.  To return to the program,
  65. enter the letter "Q" and press return:
  66.  
  67. Q <ret>
  68.  
  69. A description of the //gs system monitor is contained in the //gs
  70. Firmware Reference Manual.  Diversi-Hack allows you to "Hack" out the
  71. machine language structure of a running program, but it's very easy
  72. to "Hack" the program to an unpleasant termination.
  73.  
  74. If you want to continue your program with "Q", be very careful not to
  75. change any bytes with the monitor, or know what you're doing when you
  76. change things.
  77.  
  78. SAVE AREAS:
  79.  
  80. The system saves the text screen, stack and zero-page before calling
  81. Diversi-Hack, and restores it when you return with "Q".  If you want
  82. to examine the interrupted program's zero-page, screen, or stack, you
  83. can look into the saved location as follows:
  84.  
  85. Program Addresses:      Moved to:
  86.  
  87. 0/0.FF                  E0/1C00.1CFF    0-page
  88. 0/100.1FF               E0/300.3FF      stack
  89. 0/400.7FF               E0/C00.FFF      text screen (40 col)
  90. 1/400.7FF               E0/1000.13FF    text screen alt. (80-col 1/2)
  91. Stack Pointer           E0/1D9C         (RTI at +5)
  92.  
  93. SENDING KEYTROKES TO A PRINTER:
  94.  
  95. Diversi-Hack lets you send characters to a printer, which is very
  96. useful for setting printer options in the middle of a running
  97. program.  From the monitor, you enter control-Y and press return:
  98.  
  99. ctrl-Y <ret>
  100.  
  101. When you do this, everything you type gets sent to the printer in
  102. slot #1.  To send to a different slot, first type:  10D:Cn, where n
  103. is the slot #.
  104.  
  105. Your keystrokes are sent to the printer with the high bit ON.  To
  106. send with the high bit OFF, hold the open-apple key down while
  107. typing.
  108.  
  109. You get out of this printer mode by typing:
  110.  
  111. OPEN-APPLE_DELETE       (exit printer mode)
  112.  
  113.  
  114. *** How to Order ***
  115.  
  116. To order, please send your check to:
  117.  
  118. DSR, Inc.
  119. 34880 Bunker Hill
  120. Farmington, MI 48018-2728
  121.  
  122. The cost of our programs is as follows:
  123.  
  124. Diversi-DOS     $30
  125. Diversi-Copy    $30
  126. Diversi-Cache   $35 / Includes free Diversi-Hack
  127. Diversi-Key     $45 / Includes free Diversi-Hack
  128.  
  129. We only sell our programs by mail-order, and will notify you of
  130. future program updates which you may purchase for $5 each.
  131.