home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d986 / memon.lha / MeMon / MeMon.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  5.6 KB  |  168 lines
  1.  
  2.  
  3.                                  MeMon 1.1
  4.                 
  5.                         By David Ekholm, Datadosen
  6.  
  7.  
  8. -----------------------------------------------------------------------------
  9. Introduction
  10. -----------------------------------------------------------------------------
  11.  
  12. **** This requires version 2.0 or higher of the Amiga O.S. ****
  13.  
  14. This program has two uses. One is to convert numbers between decimal,
  15. hexadecimal, binary, and ASCII and the other is to monitor and alter
  16. addresses in memory.
  17.  
  18. MeMon is designed to be so neat and pretty that all programmers will want to
  19. have It on their harddisk. Why?
  20.   -MeMon is mouse- and FULLY keyboard driven.
  21.   -MeMon uses 2.0 gadgets
  22.   -MeMon reads its settings from the ToolType field.
  23.   -MeMon adjust gadgets to the system font.
  24.   -MeMon has a small icon and program size.
  25.  
  26. MeMon is a nice tool for every programmer in need of converting numbers
  27. between different bases, needing to know what code the © character has etc.
  28.  
  29. MeMon is also a perfect tool to help in debugging or just to learn how
  30. the hardware registers on the Amiga work.
  31.  
  32. If you don't know much about computers remember that poking around in memory
  33. may very likely cause a system failure. You use the program on your own risk.
  34.  
  35. MeMon is freely distributable, as long as it is kept intact with this
  36. document and the program remains unaltered.
  37.  
  38. If you have any suggestions or problems, let me know:
  39.  
  40. David Ekholm
  41. Mantalsv. 33
  42. s-175 43 Järfälla
  43. Sweden
  44.  
  45. Phone/modem: int+46-8-580-15668
  46.  
  47. FidoNet: 2:201/411.57
  48. Internet: david-ek@dsv.su.se
  49.  
  50.  
  51.  
  52. -----------------------------------------------------------------------------
  53. Using MeMon
  54. -----------------------------------------------------------------------------
  55. To start:
  56.  
  57. Workbench: Double-click on MeMon's icon to start the program.
  58.  
  59. Shell:     Type MeMon [MEMORY=YES|NO] [MONITOR=YES|NO] [SIGN=YES|NO]
  60.             [CLEAR=YES|NO] [LENGTH=LONG|WORD|BYTE] [ADDRESS=<hexaddress>]
  61.  
  62. MeMon will open a small window with some gadgets. They are explained below.
  63.  
  64.  
  65. Mem: Memory gadget. Enables memory to be monitored and altered.
  66.      Use mouse or M key to select.
  67.  
  68. Mon: Monitor gadget. If selected, MeMon will monitor selected address every
  69.      video frame. Unselect to poke in write-only registers.
  70.      Use mouse or O key to select.
  71.  
  72. Sgn: Sign gadget. This gadget affects how the decimal number field displays
  73.      numbers. If selected. MeMon will treat the most significant bit as the
  74.      sign bit. Use mouse or S key to select.
  75.  
  76. Clr: Clear gadget. If selected MeMon will auto-clear number fields upon entry.
  77.      Use mouse or C key to select.
  78.  
  79. L:   Long word gadget. This radiobutton selects long word mode.
  80.      Every operation will affect 32 bits and addresses will be word aligned.
  81.      Use mouse or L key to select.
  82.  
  83. W:   Word gadget. This radiobutton selects word mode. Every operation
  84.      will affect 16 bits and addresses will be word aligned.
  85.      Use mouse or W key to select.
  86.  
  87. B:   Byte gadget. This radiobutton selects byte mode. Every operation
  88.      will affect 8 bits.
  89.      Use mouse or B key to select.
  90.  
  91. The number gadgets:
  92.  
  93. a:   The a (ASCII) number field will display the data as ASCII characters.
  94.      It will stop displaying if It reaches a NULL byte.
  95.  
  96. $:   The $ (Hex) number field will display the data as hexadecimal characters.
  97.  
  98.  :   The  (decimal) number field will display the data as decimal characters.
  99.      This is the default field if you press the TAB key.
  100.  
  101. %:   The binary number field. This field has some extra graphics to help you
  102.      count the ones and zeroes. Hope you'll like It.
  103.  
  104.  
  105.  
  106. Finally we have the two ghosted number fields which are used to enter
  107. addresses when in memory mode. One is for hexadecimal and one for decimal
  108. addresses. If an odd address is entered when in word or long word mode,
  109. this address will be word aligned. If byte mode is selected MeMon will recall
  110. the original address.
  111.  
  112. You can use the TAB key to move between number fields and also to enter
  113. the last-selected number field.
  114.  
  115. Click outside a number field to cancel that entry.
  116.  
  117. All number fields work so that they will allow entry of up to 32 bit long
  118. data, but only display as much as selected. If illegal data is entered,
  119. MeMon will accept all data upto the illegal data. E.g. if you enter 124G5 in a
  120. hex number field this will translate to 124.
  121.  
  122. The HELP key button will display a short help requester.
  123.  
  124.  
  125. -----------------------------------------------------------------------------
  126. To set up:
  127. -----------------------------------------------------------------------------
  128.  
  129. MeMon may be configured to your preference. This can be done either via
  130. the ToolTypes field if started from Workbench or from CLI with the same
  131. parameters as in the ToolType field.
  132.  
  133. This is a list of what can be configured:
  134.  
  135. MEMORY=YES | NO
  136.  
  137. MONITOR=YES | NO
  138.  
  139. SIGN=YES | NO
  140.  
  141. CLEAR=YES | NO
  142.  
  143. LENGTH=LONG | WORD | BYTE
  144.  
  145. ADDRESS=<address in hex>
  146.  
  147.  
  148.  
  149. -----------------------------------------------------------------------------
  150. *** HISTORY OF RELEASES ***
  151. -----------------------------------------------------------------------------
  152.  
  153. 93-11-09 Version 1.1
  154.  
  155.     * Added ToolType parameter parsing.
  156.     * Added version information (wow!).
  157.     * Now opens on the default public screen, not always the WB screen.
  158.     * Fixed bug eating 240 bytes every time MeMon was run.
  159.     * No longer pops up a requester when RMB is pressed. Use HELP key.
  160.     * Will quit when ESC is pressed, NOT when ESC is released, could cause
  161.       funny effects when used with other programs using the ESC key to quit.
  162.     * Added a + sign for decimal values when in Sign mode. Also moved
  163.       the sign character next to the value, making the value easier to edit.
  164.  
  165.  
  166. 92-09-18 First release
  167.          Version 1.0 No bugs found (yet).
  168.