home *** CD-ROM | disk | FTP | other *** search
/ Dave Lowe: Devpac ST / Lowe_DevpacST.img / README.S < prev    next >
Encoding:
Text File  |  1988-10-03  |  7.5 KB  |  192 lines
  1. This contains information to supplement that in the manual.
  2.  
  3. This is DevpacST Version 2.08
  4.  
  5. The HiSoft File Selector can be found in the FSEL folder. The .TXT file
  6. contains its documentation.
  7.  
  8. Assembler 2.08
  9. ==============
  10. The new directives TEXT, DATA and BSS are supported for increased
  11. compatibility. They are the same as specifying SECTION xxx.
  12. IMPORTANT: The DCB directive (page 52) now works as described. Previously
  13. the order of the parameters were reversed, so existing code which relied
  14. on the bug will no longer work. Similarly the optimising numbers in the
  15. OPT O directive (page 48) are now implemented as described. Previously
  16. you had to use one less than the documented numbers.
  17. The LIST + and - directives (page 53) now work exactly as described.
  18. Incorrect divide-by-zero errors on pass 1 no longer occur.
  19. The destination of a MOVE is not allowed to be (PC) relative.
  20. Register equates are allowed in ADDX/SUBX/ABCD/SBCD.
  21. It was possible to crash the editor if a block was deleted and the
  22. cursor was within the block.
  23. The .TTP version now returns a GEMDOS return code to indicate the success
  24. or otherwise of the assembly. Values are:
  25.     100    main file not found
  26.     20    fatal error
  27.     10    error(s)
  28.     5    warning(s)
  29.     0    OK
  30. The AESLIB.S file has been updated.
  31.  
  32. Debugger 2.02
  33. =============
  34. The Follow Traps option works on Line A op-codes.
  35. Disassembling with Long-sized data areas works.
  36. The Effective Address display in the register window correctly shows memory
  37. around the stack when in supervisor mode.
  38.  
  39. Assembler 2.07
  40. ==============
  41. A problem with GST sections has been corrected. The editor Delete File
  42. function has been fixed (it was broken in 2.06 only).
  43.  
  44. Assembler 2.06
  45. ==============
  46. The following bugs have been fixed:
  47. type checks on PC-relative with index; FORMAT; IFND/IFD with SET labels.
  48.  
  49. In addition a new form of local label is supported, denoted with decimal
  50. digits ending with a $ sign, e.g. 1234$. This is to improve compatibility.
  51. The AESLIB.S file has been updated.
  52.  
  53. Assembler 2.04
  54. ==============
  55. The following bugs have been fixed:
  56. GEMDOS MALLOC problem; the optimiser being memory hungry; assembling DRI
  57. code to no-where; low-memory GST output; mixing macros and repeat loops;
  58. INCBIN and odd-length files; INCBIN and ORG together.
  59.  
  60. INCBIN is now forced to start on an even boundary and is padded with a null
  61. byte if the file is odd in length.
  62.  
  63. Editor 2.02
  64. ===========
  65. There is a new option under Preferences, called End of Line. When
  66. Wrap is selected the cursor behaves differently when you  or  past
  67. the ends of a line. Try it and see if you like it.
  68.  
  69. Assembler 2.02
  70. ==============
  71. There is a new option, OPT A+, which enables automatic-PC mode where
  72. possible. For example the line MOVE.L int_in,d0 would get assembled
  73. as MOVE.L int_in(pc),d0. Note that this does not guarantee position-
  74. independent code, but does reduce program size and execution times.
  75. It is used in the GEMTEST program to good effect. This may have to
  76. be overidden (when reading absolute memory for example) and this may be
  77. done by using the (expression).L form, similar to that detailed on page 
  78. 43 for short word addressing.
  79.  
  80. There is a new option determining the speed of the assembler, available
  81. in the assembly options dialog box. Under normal circumstances leave the
  82. Fast button selected, but only if the assembler runs out of memory should
  83. you select Slow. This forces the assembler to use as little memory as
  84. possible which slows down disk accesses. It can slow down to a little
  85. faster than GenST Version 1 (which isn't actually that slow!). The .TTP
  86. version may be set to slow mode using the command line option -M.
  87.  
  88. The assembler can now generate code suitable for linking with OSS Personal
  89. Pascal (Pascal Plus in Germany). For further details please quote your
  90. DevpacST and, if a UK customer, your Pascal serial numbers.
  91.  
  92. Bugs fixed include the ORG, CNOP, ENDC and REPT directives.
  93.  
  94. Debugger 2.01
  95. =============
  96. The debugger can now save its Preferences in a MONST2.INF file.
  97.  
  98. There is a new command, Ctrl-S, that skips the current instruction.
  99. It is equivalent to setting the PC to be x words further on, ideal
  100. for not executing instructions you know are going to produce nasty
  101. results.
  102.  
  103. The machine may be reset by pressing the combination
  104. Ctrl-Alt-NumericDot when in the debugger. No warning is given.
  105.  
  106. Linker 2.01
  107. ===========
  108. A bug to do with large library files has been corrected.
  109.  
  110. Source Files 2.01
  111. ==================
  112. The GEMTEST, AESLIB, VDILIB and GEMMACRO files have been updated.
  113.  
  114. Editor 2.00
  115. ===========
  116. Not a new feature at all really, we've just never documented it before.
  117. To search and/or replace Tab characters press Ctrl-I in the dialog box
  118. They will be echoed as clock face characters. Ctrl-M must *not* be used
  119. as a substitute for CR. Strange characters, like   and  may be
  120. entered by typing a special character, say ?, then using 
  121. the Find dialog box to replace it with the required Ctrl- characters.
  122.  
  123. When using Run Other to run a program you may pass the name of the file
  124. you are currently editing by including a % in the command line, which
  125. will be expanded. A true % may be specified using %%
  126.  
  127. Assembler 2.00
  128. ==============
  129. The default for option M, macro expansions, is OPT M-.
  130.  
  131. The directive OPT U+ changes local labels start with underlines (_) instead
  132. of periods, to allow code to be generated for the Prospero range of
  133. languages.
  134.  
  135. In the .TTP version the tab size used when listing may be specified using
  136. the option -Txx, for example -T10.
  137.  
  138. Debugger 2.00
  139. =============
  140. The command Ctrl-E forces all exceptions to be re-installed. This can be
  141. useful when dealing with compiled programs whose run-times use the
  142. exceptions themselves.
  143.  
  144. If you enter AMONST2 during the boot sequence you may abort its
  145. installation by quitting with Ctrl-R instead of Ctrl-C.
  146.  
  147. Please note decimal numbers are now denoted with \, not # as in version 1.
  148.  
  149. Linker 2.00
  150. ===========
  151. An additional directive is allowed in control files:
  152. TRUNCATE
  153. This truncates all symbols to 8 characters, sometimes required to link
  154. assembly language with long labels to compiled code with short labels.
  155.  
  156. Lattice C Users
  157. ===============
  158. Now supplied is a replacement C.LNK file for use with Lattice C 3.04.
  159. Using it with LINKST will reduce your link times and also reduce your
  160. output file size by using a true BSS-type section.
  161. If you use the -n option of the compiler (page 132) you will be able
  162. to specify HiSoft Extended Debug when linking, allowing longer and more
  163. meaningful symbols when debugging with MonST2.
  164.  
  165. Manual Corrections
  166. ==================
  167. Page 65, the macro expansion at the bottom of the page should show the
  168. binary number as %0110.
  169. Page 156, addr_out consists of longwords, not words.
  170. Page 158, the parameter list to evnt_multi has two missing:
  171.  
  172.                              
  173. evnt_multi flags,clicks,mask,bstate,m1flags,m1x,m1y,m1w,m1h,
  174.                              
  175.                                 
  176. &    m2flags,m2x,m2y,m2w,m2h,messagebuf.L,count.L
  177.                                 
  178. Page 94, under Lock Window it should read 'disassembly and memory
  179. windows'
  180. Page 161, under fsel_input, should read 'If D0.W is *zero* on return
  181. then it means'
  182. Page 164, Clear Workstation is v_clrwk, not v_clrwrk
  183.  
  184. Developer Version
  185. =================
  186. Please note that the Developer version described on Page 180 is not
  187. yet available. If you are interested in it please write to us and your
  188. details will be put on file, you will be then contacted when it is
  189. available.
  190.  
  191. Last changed: 2nd October 1988
  192.