home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / b047_1 / !ArcTools_ReadMe < prev   
Encoding:
Text File  |  1992-10-28  |  8.9 KB  |  223 lines
  1.  
  2.  
  3.                   ARCTOOLS version 0.72 (Public Domain)
  4.                   =====================================
  5.  
  6.                  Written by Mohsen Alshayef, 27 Oct 1992
  7.  
  8.                          © Mohsen Alshayef 1992
  9.  
  10.      ***************************************************************
  11.      *                                                             *
  12.      *            You need RISC-OS 3 to run ARCTOOLS               *
  13.      *                                                             *
  14.      ***************************************************************
  15.  
  16.  
  17.  
  18. The following files should be in the !ARCTOOLS application directory:
  19.  
  20. 1. ARCTOOLS     : ARCTOOLS module code.
  21. 2. Manual       : ARCTOOLS user manual. (Text file)
  22. 3. ReadMe       : ReadMe file (this one). (Text file)
  23. 4. Licence      : User licence
  24.  
  25. Quick familiarization:
  26. ======================
  27.  
  28. Double clicking on the !ARCTOOLS icon will load ARCTOOLS module into the
  29. RMA. ARCTOOLS is then active until killed.
  30.  
  31. For a quick summary of all commands provided, type:
  32.  
  33.  *Tools            for a list of all ARCTOOLS commands.
  34.  *Tools G          for a list of all ARCTOOLS general commands.
  35.  *Tools M          for a list of all ARCTOOLS memory commands.
  36.  *Tools D          for a list of all ARCTOOLS disc and files commands.
  37.  
  38. The memory and disc editors in ARCTOOLS outperform those in any utility
  39. ever written for the ACORN machines. You only have to use them for half
  40. an hour, and I guarantee you that you will throw your old memory and
  41. disc editor utilities away.
  42.  
  43. If you are familiar with memory or disc editors then press F12 and type
  44. *Medit. You will be surprised for what you get!!!! But you will only
  45. appreciate the power of ARCTOOLS once you have read the 'Manual' text
  46. file. There are so many facilities provided that it is best to print
  47. the file 'Manual' provided in the !ARCTOOLS directory for easier cross
  48. reference.
  49.  
  50. Read the file 'Manual' for a complete (I hope) coverage of all the commands
  51. and facilities.
  52.  
  53. I hope you find ARCTOOLS most useful for your needs. Please send me any
  54. comments or suggestions. Address is in the file 'Manual'.
  55.  
  56.  
  57. ARCTOOLS requires RISC OS 3 or higher to operate properly. This is due to
  58. the use of some of the new SWIs provided in RISC-OS 3.
  59.  
  60.  
  61.  
  62.                    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  63.                    !                               !
  64.                    !           H E L P             !
  65.                    !                               !
  66.                    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  67.  
  68.  
  69.  -  Although I have tried my best to make ARCTOOLS compatible with
  70.     RISC OS 3, I still havn't exploited the full features of RICS OS 3
  71.     due to the lack of the new Programmers Reference Manuals. Some of
  72.     the new RISC OS SWIs and their parameter passings were discovered
  73.     using ARCTOOLS itself.
  74.  
  75.  -  I have allowed the user of ARCTOOLS to get access to the I/O memory
  76.     space. This used to cause problems on my A310 with RISC OS 2. It
  77.     does not seem to do so on my A5000 RISC OS 3. I don't know if this
  78.     is due to the new Operating System, the ARM processor difference, or
  79.     the hardware difference.
  80.     I can not test this with different hardware. Please send me the result
  81.     of scanning that area on different machines, with say podules fitted.
  82.     If there are serious problems, I will have the access to that area of
  83.     memory made optional in next versions of ARCTOOLS.
  84.  
  85.  -  ARCTOOLS have not been tested on a machine with 8 Mbytes and higher
  86.     of ram. I would like to know, how it behaves. How many Mega bytes does
  87.     the *Mmap command report? How many pages are reported by the *Mpage
  88.     command? Do the memory editors work properly?
  89.  
  90.  -  ARCTOOLS has been tested on an A5000 machine with 4 Mbytes of ram,
  91.     one floppy drive, one 120 Mbytes IDE hard disc, and without any
  92.     extension modules attached. If you have a machine with different
  93.     specifications and you are experiencing difficulties, please contact
  94.     me so that I'll be able to update ARCTOOLS coding.
  95.  
  96.  -  I was hoping to include ARM 6xx assembly and dis-assembly in ARCTOOLS,
  97.     but because of the lack of information I am unable to do this at the
  98.     moment. If you can provide such information, you will have a copy
  99.     delivered to your door of every new ARCTOOLS version.
  100.  
  101.  
  102.  
  103. Current known Problems with ARCTOOLS (To be removed in next versions)
  104. =====================================
  105.  
  106.  
  107.  1. When using any output re-direction with ARCTOOLS commands, for example,
  108.     *mdump, *system, *event, *vector or *fdump, you will find that the
  109.     text output is oddly formatted. This also occurs if any of the above
  110.     ARCTOOLS commands is issued from within the desktop Task Window. The
  111.     reason for this is that these commands use the OS OS_Byte 134 to read the
  112.     current text cursor position. OS_Byte 134 returns a value of 0 for the
  113.     current X position of the text cursor if the output is re-directed. This
  114.     seems to be a bug of the Operating System, not ARCTOOLS.
  115.  
  116.  2. The current version of the disc editor can only remember one disc
  117.     drive. When switching between the memory and disc editors using the
  118.     CTRL+"E" key combination, the drive accessed is drive 0. This is because
  119.     ARCTOOLS remembers the last drive it used in the disc editors. Use
  120.     *Dedit 4, to access the hard disc, sbusequent editors switching will
  121.     automatically access drive 4.
  122.  
  123.  3. When in the disc editor, if the disc is changed, ARCTOOLS knows about
  124.     this whenever you use any of the disc operation. ARCTOOLS will give
  125.     the error message 'Disc changed' then it will read the new disc
  126.     sector data at the current address. A bug exists which causes subsequent
  127.     operation to give 'Disc changed' error message although the disc has
  128.     already been identified.
  129.     To prevent this, any time you change a disc while in the disc editors,
  130.     you should use CTRL-I to install the new disc so that ARCTOOLS forgets
  131.     about the previous disc.
  132.  
  133.  4. The CTRL-P key combination used to send the screen output to
  134.     printer does not check to see if the printer is on-line. This can
  135.     cause the machine to hang.
  136.  
  137.  5. The FPU CMN and CMNE instructions will not automatically do complement
  138.     translation. This is a very minor limitation which I will be looking
  139.     into in the next versions.
  140.  
  141.  6. The 'search Mnemonic' in the mnemonics editor (dis-assembler) can not
  142.     properly find any of the following instructions:
  143.      1. LDR|STR  Rx,<address>
  144.      2. LDM|STM  Rx,<address>
  145.      3. LDF|STF  Fx,<address>
  146.      4. LDC|STC  Cx,<address>
  147.      5. ADR      Rx,<address>
  148.      6. ADRL     Rx,<address>
  149.     This is due to the offset address calculation required. This requires
  150.     a different search routine. The routine is already included for the
  151.     search of  Branch instructions, future versions will extend this
  152.     routine to include all the above instructions.
  153.  
  154.  7. The search routine does not search physical RAM area if it was
  155.     started in a logical RAM area. To search in physical RAM you simply
  156.     start the search in the physical ram area. This is not really a bug,
  157.     it is just how I wanted it to be. If you started the search in logical
  158.     memory then there is no need to search in physical ram as they both
  159.     contain the same data. However some logical ram pages can be hidden
  160.     by other applications which you will not be able to access. Using
  161.     the search in physical ram will then allow you to find what you are
  162.     looking for.
  163.  
  164.  
  165.  
  166. Future features to be incorporated in ARCTOOLS:
  167. ===============================================
  168.  
  169.  1. Full support of all operating system disc and drive types in the
  170.     disc editors.
  171.  
  172.  2. The disc editors will support automatic switching between drives,
  173.     so that you can switch between drives with the press of a key.
  174.  
  175.  3. Full support of RISC OS 3 features.
  176.  
  177.  4. Automatic labeling of modules with suitable names and adding comments
  178.     to modules entry addresses.
  179.  
  180.  5. Adding a *History command, and an improved line editor. Part of the
  181.     line editor code is already used in ARCTOOLS.
  182.  
  183.  6. *Dlock command will have options to lock only specified drives.
  184.  
  185.  7. Many additional options will be added to the Commands Menu.
  186.  
  187.  8. Improved machine index computation to cover memory, processor and
  188.     drives tests.
  189.  
  190.  9. Neat ways of entering and exiting ARCTOOLS editors from desktop.
  191.  
  192. 10. Add a new *command to append labels files to existing labels in
  193.     memory.
  194.  
  195. 11. Add a printer on-line check.
  196.  
  197. 12. Add a facility to allow entering hex numbers in the WORD editors
  198.     using a normal input routine.
  199.  
  200. 13. Allow the size of ARCTOOLS buffers used for storing tables to be
  201.     specified by the user.
  202.  
  203. 14. Multiple wildcards will be allowed in the memory and disc string
  204.     search routines.
  205.  
  206. 15. The *System command will be extended to show other system related
  207.     parameters.
  208.  
  209. 16. Assembly and disassembly of ARM 6xx processors instructions.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  Good Luck and Happy Programming.
  216.  
  217.  
  218.  
  219.                   ARCTOOLS is  © Mohsen Alshayef 1992
  220.  
  221.                   This version, 0.72 is public-domain
  222.  
  223.