home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PILOT / PC / PILAASSM / README.TXT < prev    next >
Encoding:
Text File  |  1996-10-05  |  4.4 KB  |  95 lines
  1. Pila 1.0 Beta 2 ReadMe
  2. By Darrin Massena (darrin@massena.com)
  3. 5 Oct 96
  4.  
  5. Pila is a 68000 assembler that runs under Windows 95/NT and produces
  6. Pilot executables. Documentation for Pila is in the HTML file PilaUM.htm.
  7.  
  8. This version is of a BETA level of quality. That means it includes all
  9. the documented features and has undergone a fair amount of public testing
  10. to be sure they work. It also means that there are known bugs and anyone
  11. using unstressed areas of the program may discover more bugs. If you
  12. uncover any bugs or have suggestions on how to improve anything in the
  13. Pila package (the program, documentation, this readme, etc) please send me
  14. mail at darrin@massena.com. This is a part-time effort for me but I really
  15. value your feedback and will respond as soon as I can.
  16.  
  17. Consult http://www.massena.com/darrin/pilot/pila.htm for an up-to-date
  18. list of known bugs and other Pila status.
  19.  
  20. KNOWN BUGS
  21.  
  22. - Certain invalid syntaxes will cause the assembler to crash.
  23.   For example defining an address operand like (a6,6) instead of 6(a6)
  24.   will crash. (reported by Greg Hewgill)
  25.  
  26. - Pila reports the compressed size of an application's data section as
  27.   being larger than the uncompressed size! This is actually not a bug
  28.   but a fact because Pila does not implement complete data section
  29.   compression yet. The 'compressed' size is larger (only 16 byte or so)
  30.   because of overhead the PalmOS' compression format introduces.
  31.   Presumably, when complete compression is implemented the savings will
  32.   more than offset the overhead
  33.  
  34. REVISION HISTORY
  35.  
  36. ALPHA 1 (7 Aug 96)
  37. - First release!
  38.  
  39. BETA 1 (10 Sep 96)
  40. - added Wes Cherry's PilRC (0.71), a tool for creating Pilot resources,
  41.   to the Pila package
  42. - added Bill Hunt's PilDis (Alpha 1), a tool for disassembling Pilot
  43.   code resources
  44. - added Sample.rcp file to demonstrate resource creation. Sample.rcp
  45.   replaces mbar1.bin and tfrm1.bin which are removed
  46. - added Sample.bat file to build Sample.prc
  47. - added special equates to Pilot.inc for the serial library APIs
  48. - implemented source file name printing in error messages
  49. - implemented a statistics dump after successful assembly. Displays
  50.   sizes for code, data, resource, and the entire PRC. Keep those PRCs
  51.   small!
  52. - implemented a very minor Startup.inc optimization
  53. - fixed bug that was causing line numbers to be offset by one inside
  54.   include files and off by another one in the 'including' file
  55. - fixed a HUGE bug that caused the data section and A5 register to be
  56.   improperly initialized
  57. - updated Sample.asm to demonstrate data section access (amongst other
  58.   things)
  59. - updated PilaUM.htm to incorporate various suggestions I received
  60.   from Alpha testers, including a new section on the PalmOS API
  61.   calling convention and a pointer to an online version of the
  62.   Motorola 680x0 Programmer's Reference Manual -- get it!
  63.  
  64. Beta 2 (2 Oct 96)
  65. - added 'align' directive for aligning code/data on user-defined boundaries
  66. - added 'list' directive for enabling/disabling listing output
  67. - added include path support via PILAINC environment variable
  68. - added Copilot-compatible code symbol generation. Specify "-s" and your
  69.   app's code symbols will be available while debugging under Copilot
  70. - updated Startup.inc to use Wes' new directives (see below)
  71. - updated documentation
  72. - changed all errors to be output to stdout, rather than a mix of stdout/
  73.   stderr
  74. - added Wes Cherry's PilRCUI, a tool for previewing Pilot form resources,
  75.   to the Pila package
  76. - updated to Wes Cherry's PilRC version .8
  77.  
  78. Wes Cherry has been extending Pila and has added many new features to make
  79. assembly language programming easier and less bug-prone. His new directives
  80. and syntax support procedure parameter definition, procedure calling, trap
  81. calling, local and global variable definition, and structure definition and
  82. usage. Wow!
  83.  
  84. - the new directives are: call, systrap, syslibtrap, local, global, proc,
  85.   beginproc, endproc, struct, endstruct, and sizeof
  86. - added documentation for new directives to PilaUM.htm! Updated examples,
  87.   etc to show new syntax
  88. - Pila names (e.g., labels, equates) are now case sensitive. Instructions
  89.   and directives remain case insensitive
  90. - updated Pilot.inc to use the new structure syntax. Several incorrect
  91.   structure member offsets were fixed in the process
  92. - updated Sample.asm to use the new directives
  93. - fixed the 'end' directive to work as it should and be optional
  94.  
  95.