home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d183 / fixfd / readme < prev    next >
Text File  |  1989-02-25  |  3KB  |  61 lines
  1.  
  2.  To : Aspiring M68000 Programmers
  3.  
  4. From: Peter Wyspianski
  5.  
  6. Date: 01 Jan 89
  7.  
  8.  
  9. As I was getting ready to archive my 'FixFD' utility, it occured to me that
  10. some aspects of programming the Amiga would have been a LOT easier to learn 
  11. if I just had a few examples to look over.
  12.  
  13. I came to the Amiga programming enviroment from the MacIntosh.  So I was no
  14. stranger to the M68000 or the sort of things you have to do with it in such a
  15. complex enviroment.  Still, it has been a struggle.  While writing this 
  16. utility I had to learn how to detect the user hitting 'ctrl-c' to abort the
  17. program.  No big deal, but I wasted a couple hours looking in the wrong
  18. places for the information (the AmigaDOS manual and some magazines). 
  19. Turns out it is not really documented anywhere, at least not specifically.
  20.  
  21. But I wonder where I would be now if I was a complete novice M68000 
  22. programmer?  It's not like the 6502 days when you could just drop into a
  23. machine language monitor and hand-code some instructions to see what they
  24. do (that is how I first learned ML).
  25.  
  26. I have decided to include the source code for the main program.  You may
  27. study it, and even use the routines if you like.  I just hope you learn 
  28. something.
  29.  
  30. I have NOT included my 'Std_Macs68k' file.  This file just contains a bunch 
  31. of macros that match my programming style.  For example, if I am testing a
  32. register for zero, I like to be able to code 'bz.s xxx' rather then the more
  33. ambiguous 'beq.s xxx'.  So in my macro file I have a macro called 'bz'.
  34.  
  35. I have also not included the 'dos_lib.i' file.  This file can be created by
  36. using FixFD like so:
  37.  
  38. >FixFD dos_lib.fd dos_lib.i
  39.  
  40. in my case, I then edited the dos_lib.i file to add a 'PREASM' option and 
  41. ran it through the assembler (CAPE68k from Inovatronics).  This feature of
  42. CAPE lets it inhale the 'INCLUDE' file without pausing to assemble it. 
  43. A real timesaver in larger projects.  This step is entirely optional.
  44.  
  45. Finally, the code must be linked with Std_Startup.obj.  This file is my
  46. customized version of AStartup.obj.  I have included 'Std_Startup.obj' but 
  47. not the source code for it.  If you want to play around with FixFD, you 
  48. could link with AStartup.obj instead.  Here is how you get the link to work:
  49.  
  50. >BLink with FixFD.link
  51.  
  52. if you don't happen to have the freely-redistributable 'BLink' then 
  53. substitute the name of your linker (probably 'ALink').  The file 'FixFD.link'
  54. is also included.  Take a look at it, because it expects to find everything
  55. in 'RAM:'.
  56.  
  57. Good luck!  Remember to read the docs.  And if you have any questions or
  58. comments then please send me a postcard (my address is in the docs).
  59.  
  60. -Peter W.
  61.