home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / ST_USER / 1993 / USERJN93.MSA / DEVPAC2_README.S < prev    next >
Text File  |  1993-04-20  |  14KB  |  381 lines
  1. This contains information to supplement that in the manual.
  2.  
  3. This is DevpacST Version 2.25
  4.  
  5. Version 1.9 of the HiSoft File Selector can be found in the FSEL folder.
  6. The .TXT file contains its documentation.
  7.  
  8. The HiSoft AES path patch program can be found in the AESPATH folder.
  9. The .TXT file contains its documentation.
  10.  
  11. GenST 2.25
  12. ==========
  13. The assembler now supports the operators >=,<=,!=,<> The latter two both
  14. mean 'not equals'.
  15. SECTION directives do not cause the local label to be reset, making it
  16. easier to use them in macros.
  17. \# is now a synonym for NARG in macros.
  18.  
  19. A mistake involving vq_extnd in GEMMACRO.S has been fixed.
  20.  
  21. MonST 2.13
  22. ==========
  23. This corrects a bug in disassembler of one sort of MOVEM instruction.
  24.  
  25. MonST 2.10
  26. ==========
  27. This corrects a problem introduced in DevpacST 2.22 to do with incorrect
  28. dissasembly of various opcodes.
  29.  
  30. Editor 1.05
  31. ===========
  32. Deleting a line containing the one of the block markers no longer causes
  33. the markers to 'walk' backwards up the text.
  34. Some minor changes were made to scrolling using the vertical scroll arrows.
  35. At the end of line, the delete key may now be used to close up the line if
  36. "wrap" is selected from preferences.
  37.  
  38. GenST 2.22
  39. ==========
  40. INCBIN is no longer padded with a null byte if the file is odd in
  41. length, the even directive should be used after the file if needed.
  42.  
  43. MonST 2.09
  44. ==========
  45. This includes support for disassembly of 68010 instructions and spots
  46. more illegal addressing modes.
  47.  
  48. Editor 1.04
  49. ===========
  50. Scrolling using the vertical scroll arrows works correctly.
  51. When deleting text, the block now 'stays in the same place'.
  52.  
  53. Editor 1.02
  54. ===========
  55. The Find box is wider in medium and high resolution
  56. The load MonST option in preferences now works correctly
  57. The keyboard shortcut for Run is shown correctly (again) on the menu.
  58. Please note that the last two bugs were only present in version 2.20
  59.  
  60. MonST 2.08
  61. ==========
  62. This now gives labels embedded in DATA areas.
  63.  
  64. Assembler 2.20
  65. ==============
  66. Nested macro calls are no longer shown with OPT M-
  67. Listing for DS and BSS now shows the correct address (not that for the
  68. next line)
  69. DC.B import no longer generates a spurious byte
  70. DCB negative number no longer fills up the output device
  71.  
  72. Optimisations 3 through 7 have been added:
  73.  
  74. 3    absolute addresses will be optimised to short-word addressing
  75.     if in the range $FFFF8000-$7FFF inclusive
  76. 4    instructions of the form MOVE.L #x,Dn will be optimised to
  77.     MOVEQ if x is in the range -128 to 127 inclusive
  78. 5    ADD #x and SUB #x instructions will be optimised to Quick forms
  79.     if x is in the range 1-8 inclusive
  80. 6    not strictly an optimisation; a warning will be issued for each
  81.     forward branch that could be made short; this must be used in
  82.     conjunction with option type 1
  83. 7    convert BRA.S to next instruction to NOP. Formerly this always
  84.     occurred even when optimisation was off. It is now an error by
  85.     default
  86.  
  87. The warning messages produced by each optimisation may be individually
  88. controlled, using OPT OWx+ / OPT OWx- where 'x' is the optimising
  89. number (shown above), e.g. OPT OW3+
  90.  
  91. When using Word- or Long-sized indirection, addresses are checked to be
  92. even, for example MOVE.L 5,A6 will give an error. This may be disabled
  93. if required using OPT E-
  94.  
  95. The register list syntax produced in earlier MOVEM lists from MonST is
  96. now accepted by GenST.
  97.  
  98. The | character is now accepted as a bitwise OR operator (for all you C
  99. programmers!)
  100.  
  101. Symbols set using REG may now be used in expressions, with a warning.
  102. Their value is the same as that used in the MOVEM op.
  103.  
  104. There is a new option which can be used to detect typing errors, OPT i.
  105. With this on, any indirect, absolute reference will give the error '#
  106. probably missing'. For example, the line
  107.  
  108.     and.b $df,d1
  109.  
  110. will give an error as and.b #$df,d1 is really intended. This can be
  111. overidden on a line-by-line basis  by specifying the expression within
  112. brackets and using .W or .L, for example move.l ($ff8000).L,d0
  113.  
  114. The '@' character is now allowed in symbols, except when followed by a
  115. digit from 0-7 when it is taken as the start of an octal number. This
  116. is for Lattice C 5 users.
  117.  
  118. When using the stand-alone version of the assembler it is possible to
  119. define labels on the command-line using the -e option, which should be
  120. followed by one or more assignments, separated by commas or spaces.
  121. Such definitions are parsed as if they were the second line in the
  122. source (i.e. after any options). For example,
  123.  
  124.     genst2 test -e TYPE=4,OUTPUT=1
  125.  
  126. COMMENT    HEAD=expression
  127.  
  128. This allows the longword in the file header to be set to any particular
  129. value; the default is zero. A value of 1 denotes a fast-loading program
  130. (supported by TOS 1.4 or later) whereby the whole TPA area past the end
  131. of the BSS is not zeroed. This results in decreased loading times on
  132. large memory machines, for those programs that are compatible with it.
  133. HEAD must be in upper-case. Please note that other values are reserved
  134. for future expansion by Atari.
  135.  
  136. The AESLIB and GEMMACRO files have had form_keybd and form_button added.
  137.  
  138. The editor no longer displays spurious zeroes in the status line.
  139. Shift-Alt-A assembles without the options dialogue.
  140.  
  141. Debugger 2.07
  142. =============
  143. Control-W is now Single-Step for the benefit of users with French
  144. keyboards.
  145.  
  146. The word, long and byte searches can now be made to only look for the
  147. pattern starting on word or long word boundaries. To only search on
  148. word boundaries finish the list of items to search for with ',W'. For
  149. longwords use ',L'. For example:
  150.  
  151.     G W
  152.     1234,W
  153.     
  154. will look for $1234 only on word boundaries.
  155.  
  156. The Textual and Instruction searches now ask further you wish the
  157. search to be case sensitive. If you press Y then Test will match TEST
  158. or TeSt.
  159.  
  160. More than 6 conditional breakpoints no longer crashes the help display.
  161.  
  162. Linker 3.00
  163. ===========
  164. LinkST is now the version supplied with Lattice C 5, although the C.LNK
  165. file is still that for version 3.04. Users of Lattice C 5 should use the
  166. C.LNK file supplied with that package.
  167.  
  168. Assembler 2.09
  169. ==============
  170. The AESLIB, VDILIB and GEMMACRO files have been updated for TOS 1.4.
  171.  
  172. Debugger 2.04
  173. =============
  174. This is now compatible with a wider range of Atari machines.
  175.  
  176. Linker 2.02
  177. ===========
  178. This has a new option, -u (or UPPER in a control file) that upper-cases
  179. all imported and exported symbols.
  180.  
  181. Assembler 2.08
  182. ==============
  183. The new directives TEXT, DATA and BSS are supported for increased
  184. compatibility. They are the same as specifying SECTION xxx.
  185.  
  186. IMPORTANT: The DCB directive (page 52) now works as described.
  187. Previously the order of the parameters were reversed, so existing code
  188. which relied on the bug will no longer work. Similarly the optimising
  189. numbers in the OPT O directive (page 48) are now implemented as
  190. described. Previously you had to use one less than the documented
  191. numbers.
  192.  
  193. The LIST + and - directives (page 53) now work exactly as described.
  194. Incorrect divide-by-zero errors on pass 1 no longer occur.
  195.  
  196. The destination of a MOVE is not allowed to be (PC) relative. Register
  197. equates are allowed in ADDX/SUBX/ABCD/SBCD.
  198.  
  199. It was possible to crash the editor if a block was deleted and the
  200. cursor was within the block.
  201.  
  202. The .TTP version now returns a GEMDOS return code to indicate the
  203. success or otherwise of the assembly. Values are:
  204.  
  205.     100    main file not found
  206.     20    fatal error
  207.     10    error(s)
  208.     5    warning(s)
  209.     0    OK
  210.  
  211. The AESLIB.S file has been updated.
  212.  
  213. Debugger 2.02
  214. =============
  215. The Follow Traps option works on Line A op-codes.
  216. Disassembling with Long-sized data areas works.
  217. The Effective Address display in the register window correctly shows
  218. memory around the stack when in supervisor mode.
  219.  
  220. Assembler 2.07
  221. ==============
  222. A problem with GST sections has been corrected. The editor Delete File
  223. function has been fixed (it was broken in 2.06 only).
  224.  
  225. Assembler 2.06
  226. ==============
  227. The following bugs have been fixed:
  228. type checks on PC-relative with index; FORMAT; IFND/IFD with SET labels.
  229.  
  230. In addition a new form of local label is supported, denoted with decimal
  231. digits ending with a $ sign, e.g. 1234$. This is to improve compatibility.
  232. The AESLIB.S file has been updated.
  233.  
  234. Assembler 2.04
  235. ==============
  236. The following bugs have been fixed:
  237. GEMDOS MALLOC problem; the optimiser being memory hungry; assembling DRI
  238. code to no-where; low-memory GST output; mixing macros and repeat loops;
  239. INCBIN and odd-length files; INCBIN and ORG together.
  240.  
  241. INCBIN is now forced to start on an even boundary and is padded with a null
  242. byte if the file is odd in length.
  243.  
  244. Editor 1.01
  245. ===========
  246. There is a new option under Preferences, called End of Line. When
  247. Wrap is selected the cursor behaves differently when you ⇦ or ⇨ past
  248. the ends of a line. Try it and see if you like it.
  249.  
  250. Assembler 2.02
  251. ==============
  252. There is a new option, OPT A+, which enables automatic-PC mode where
  253. possible. For example the line MOVE.L int_in,d0 would get assembled as
  254. MOVE.L int_in(pc),d0. Note that this does not guarantee position-
  255. independent code, but does reduce program size and execution times. It
  256. is used in the GEMTEST program to good effect. This may have to be
  257. overidden (when reading absolute memory for example) and this may be
  258. done by using the (expression).L form, similar to that detailed on page
  259. 43 for short word addressing.
  260.  
  261. There is a new option determining the speed of the assembler, available
  262. in the assembly options dialog box. Under normal circumstances leave the
  263. Fast button selected, but only if the assembler runs out of memory should
  264. you select Slow. This forces the assembler to use as little memory as
  265. possible which slows down disk accesses. It can slow down to a little
  266. faster than GenST Version 1 (which isn't actually that slow!). The .TTP
  267. version may be set to slow mode using the command line option -M.
  268.  
  269. The assembler can now generate code suitable for linking with OSS Personal
  270. Pascal (Pascal Plus in Germany). For further details please quote your
  271. DevpacST and, if a UK customer, your Pascal serial numbers.
  272.  
  273. Bugs fixed include the ORG, CNOP, ENDC and REPT directives.
  274.  
  275. Debugger 2.01
  276. =============
  277. The debugger can now save its Preferences in a MONST2.INF file.
  278.  
  279. There is a new command, Ctrl-S, that skips the current instruction.
  280. It is equivalent to setting the PC to be x words further on, ideal
  281. for not executing instructions you know are going to produce nasty
  282. results.
  283.  
  284. The machine may be reset by pressing the combination
  285. Ctrl-Alt-NumericDot when in the debugger. No warning is given.
  286.  
  287. Linker 2.01
  288. ===========
  289. A bug to do with large library files has been corrected.
  290.  
  291. Source Files 2.01
  292. ==================
  293. The GEMTEST, AESLIB, VDILIB and GEMMACRO files have been updated.
  294.  
  295. Editor 1.00
  296. ===========
  297. Not a new feature at all really, we've just never documented it before.
  298. To search and/or replace Tab characters press Ctrl-I in the dialog box
  299. They will be echoed as clock face characters. Ctrl-M must *not* be used
  300. as a substitute for CR. Strange characters, like ① ⇧ and  may be
  301. entered by typing a special character, say ?, then using 
  302. the Find dialog box to replace it with the required Ctrl- characters.
  303.  
  304. When using Run Other to run a program you may pass the name of the file
  305. you are currently editing by including a % in the command line, which
  306. will be expanded. A true % may be specified using %%
  307.  
  308. Assembler 2.00
  309. ==============
  310. The default for option M, macro expansions, is OPT M-.
  311.  
  312. The directive OPT U+ changes local labels start with underlines (_) instead
  313. of periods, to allow code to be generated for the Prospero range of
  314. languages.
  315.  
  316. In the .TTP version the tab size used when listing may be specified using
  317. the option -Txx, for example -T10.
  318.  
  319. Debugger 2.00
  320. =============
  321. The command Ctrl-E forces all exceptions to be re-installed. This can be
  322. useful when dealing with compiled programs whose run-times use the
  323. exceptions themselves.
  324.  
  325. If you enter AMONST2 during the boot sequence you may abort its
  326. installation by quitting with Ctrl-R instead of Ctrl-C.
  327.  
  328. Please note decimal numbers are now denoted with \, not # as in version 1.
  329.  
  330. Linker 2.00
  331. ===========
  332. An additional directive is allowed in control files:
  333. TRUNCATE
  334. This truncates all symbols to 8 characters, sometimes required to link
  335. assembly language with long labels to compiled code with short labels.
  336.  
  337. Lattice C 3.04 Users
  338. ====================
  339. Supplied is a replacement C.LNK file for use with Lattice C 3.04. Using
  340. it with LINKST will reduce your link times and also reduce your output
  341. file size by using a true BSS-type section. If you use the -n option of
  342. the compiler (page 132) you will be able to specify HiSoft Extended
  343. Debug when linking, allowing longer and more meaningful symbols when
  344. debugging with MonST2.
  345.  
  346. Manual Corrections
  347. ==================
  348. Page 65, the macro expansion at the bottom of the page should show the
  349. binary number as %0110.
  350. Page 156, addr_out consists of longwords, not words.
  351. Page 158, the parameter list to evnt_multi has two missing:
  352.  
  353.                              ⇩⇩⇩⇩⇩⇩
  354. evnt_multi flags,clicks,mask,bstate,m1flags,m1x,m1y,m1w,m1h,
  355.                              ⇧⇧⇧⇧⇧⇧
  356.                                 ⇩⇩⇩⇩⇩⇩⇩⇩⇩⇩⇩⇩
  357. &    m2flags,m2x,m2y,m2w,m2h,messagebuf.L,count.L
  358.                                 ⇧⇧⇧⇧⇧⇧⇧⇧⇧⇧⇧⇧
  359. Page 94, under Lock Window it should read 'disassembly and memory
  360. windows'
  361. Page 161, under fsel_input, should read 'If D0.W is *zero* on return
  362. then it means'
  363. Page 164, Clear Workstation is v_clrwk, not v_clrwrk
  364.  
  365. Developer Version
  366. =================
  367. Please note that the Developer version described on Page 180 is not
  368. yet available. If you are interested in it please write to us and your
  369. details will be put on file, you will be then contacted when it is
  370. available.
  371.  
  372. HiSoft, 4 February 1991
  373. The Old School
  374. Greenfield
  375. Bedford
  376. MK45 5DE
  377. ENGLAND.
  378.  
  379. Phone:    +44 525 718181
  380. Fax:    +44 525 713716
  381.