home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / programming / asm / !!ReadMe next >
Encoding:
Text File  |  1997-08-17  |  2.4 KB  |  81 lines
  1. ASM Version 3.1
  2.  
  3. To install ASM, copy the main ASM program (ASM) to your
  4. Library directory.
  5.  
  6. If you have Acorn's DDE toolset, copy !ASM to the Tools
  7. directory. Then edit !Make.choices.tools, and add the
  8. following lines at the end:
  9. -------------- Cut Here ----------------
  10. ASM
  11. A
  12.  
  13. ASM $(ASMFlags) -output $@ $<
  14. DDE:!ASM.desc
  15. DDE:!ASM.!setup 
  16. -------------- Cut Here ----------------
  17.  
  18.  
  19. The documentation (Impression or text) gives fairly extensive
  20. documentation of the features of ASM (including a section
  21. on features new to version 3.1), but does not attempt to
  22. act as an ARM assembly language tutor, or even describe
  23. ARM opcodes.
  24.  
  25.  
  26. Licensing
  27. ~~~~~~~~~
  28.  
  29. ASM is FREEWARE, not Public Domain. It should only be copied
  30. and/or distributed in its intirety (including this document),
  31. and copyright remains with me. If you use it to to write
  32. applications for distribution (commercial or otherwise), an
  33. acknowledgement would be nice.
  34.  
  35.  
  36. Disclaimer
  37. ~~~~~~~~~~
  38.  
  39. ASM is distributed as is, and the author will not accept any
  40. responsibility for any resultant damage, whatever its form.
  41.  
  42.  
  43. Bug Reports
  44. ~~~~~~~~~~~
  45.  
  46. Irrespective of the formal disclaimer above, I am perfectly
  47. happy to receive emails describing any bugs discovered, and I
  48. will do my best to fix them quickly. Bug reports should include
  49. a description of the problem, and a code fragment that exhibits
  50. the aberrant behaviour.
  51.  
  52. NB There seems to be a bug in the Debugger_Disassemble SWI,
  53. that will show up if the -validate option is used on code that
  54. contains the ARM3 SWP instruction (Debugger_Disassemble returns
  55. them as "Undefined Instruction"). All my tests of the generated
  56. code against Acorn documentation indicates that ASM is producing
  57. the correct opcodes, and that it is the SWI that is at fault. If
  58. you have any info on this (ie whether the SWI or documentation
  59. is at fault) please email me.
  60.  
  61.  
  62. History
  63. ~~~~~~~
  64.  
  65.   3.00ß  Initial beta-test distribution version
  66.   3.01   Bug with MSR/MRS encoding fixed
  67.   3.02   Change to the !ASM FrontEnd tool only.
  68.   3.10   Numbers of Bugs fixed, including:
  69.          a) MSR/MRS PSR register names fixed.
  70.          b) Handling of unary + & - in some situations
  71.          c) Bitwise & operator didn't always work.
  72.  
  73.          Plus a number of enhancements, including:
  74.          a) HS/LO condition codes.
  75.          b) Optional field on ALIGN, to specify alignment size.
  76.          c) IMPORT/EXPORT now allow lists of identifiers
  77.          d) Halfword and signed byte variants of LDR/STR.
  78.  
  79. Nick Roberts
  80. tigger@argonet.co.uk
  81.