home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / aaa / README < prev    next >
Encoding:
Text File  |  1986-11-30  |  2.4 KB  |  45 lines
  1. "aaa" (the Amazing Awk Assembler) is a primitive assembler written entirely
  2. in awk and sed.  It was done for fun, to establish whether it was possible.
  3. It is; it works.  It's quite slow, the input syntax is eccentric and rather
  4. restricted, and error-checking is virtually nonexistent, but it does work.
  5. Furthermore it's very easy to adapt to a new machine, provided the machine
  6. falls into the generic "8-bit-micro" category.  It is supplied "as is",
  7. with no guarantees of any kind.  I can't be bothered to do any more work on
  8. it right now, but even in its imperfect state it may be useful to someone.
  9.  
  10. aaa is the mainline shell file.
  11.  
  12. aux is a subdirectory with machine-independent stuff.  Anon, 6801, and
  13. 6809 are subdirectories with machine-dependent stuff, choice specified
  14. by a -m option (default is "anon").  Actually, even the stuff that is
  15. supposedly machine-independent does have some machine-dependent
  16. assumptions; notably, it knows that bytes are 8 bits (not serious) and
  17. that the byte is the basic unit of instructions (more serious).  These
  18. would have to change for the 68000 (going to 16-bit "bytes" might be
  19. sufficient) and maybe for the 32016 (harder).
  20.  
  21. aaa thinks that the machine subdirectories and the aux subdirectory are
  22. in the current directory, which is almost certainly wrong.
  23.  
  24. abst is an abstract for a paper.  "card", in each machine directory,
  25. is a summary card for the slightly-eccentric input language.  There is no
  26. real manual at present; sorry.
  27.  
  28. try.s is a sample piece of 6809 input; it is semantic trash, purely for
  29. test purposes.  The assembler produces try.a, try.defs, and try.x as
  30. outputs from "aaa try.s".  try.a is an internal file that looks
  31. somewhat like an assembly listing.  try.defs is another internal file
  32. that looks somewhat like a symbol table.  These files are preserved
  33. because of possible usefulness; tmp[123] are non-preserved temporaries.
  34. try.x is the Intel-hex output.  try.x.good is identical to try.x and is a
  35. saved copy for regression testing of new work.
  36.  
  37. 01pgm.s is a self-programming program for a 68701, based on the one
  38. in the Motorola ap note.  01pgm.x.good is another regression-test file.
  39.  
  40. If your C library (used by awk) has broken "%02x" so it no longer means
  41. "two digits of hex, *zero-filled*" (as some SysV libraries have), you
  42. will have to fall back from aux/hex to aux/hex.argh, which does it the
  43. hard way.  Oh yes, you'll note that aaa feeds settings into awk on the
  44. command line; don't assume your awk won't do this until you try it.
  45.