home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Assembler / DVP30_1.DMS / in.adf / ReadMe < prev    next >
Encoding:
Text File  |  1993-02-09  |  9.0 KB  |  254 lines
  1.  
  2.     HiSoft Devpac Amiga 3.04
  3.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  4.     9th February 1993
  5.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  6.  
  7. Welcome to Devpac 3!  This file is intended to supplement
  8. the manual, giving you the latest information on your
  9. version of Devpac.  A summary of the major changes can be
  10. found at the end of this file.
  11.  
  12. A complete set of include files for programming Release 3
  13. of the operating system is now supplied in place of the
  14. Workbench 2 includes.  These also cover Release 2.0 and
  15. 2.1.  See the Contents file for details.
  16.  
  17.  
  18.     Installation Notes
  19.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  20. If backing up your Devpac disks with Workbench, rename each
  21. one afterwards to remove the words 'copy of '.  Please note
  22. that Program Disk 2.0 is a FastFileSystem disk and is
  23. unreadable from Workbench 1.3.
  24.  
  25. When installing on a hard disk, first copy the Devpac
  26. drawer by dragging its icon, then drag the appropriate
  27. Include drawer inside the new Devpac drawer.
  28.  
  29. You may wish to update the Include setting on the Assembly
  30. Control requester and the Default Tools of icons in
  31. Env-Archive (using Info from Workbench) to include the
  32. correct volume names for your system.
  33.  
  34.  
  35.     Environment Support
  36.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  37. Devpac's environment support follows Workbench 2
  38. conventions which 1.3 users may wish to use on their own
  39. disks.
  40.  
  41. Each time you reboot, the Startup-sequence initialises ENV:
  42. on the Ram Disk with the contents of Env-Archive from the
  43. Prefs drawer, known as ENVARC:.  If you wish an ENV: file
  44. to survive rebooting, you must also save a copy in ENVARC:.
  45.  
  46. Devpac looks in ENV:Devpac for settings files, assembly
  47. options and default icons, which may also appear in
  48. ENV:Sys. To create icons for assembled files other than
  49. executables you must provide a suitably named default icon.
  50. The 1.3 editor will not save any icons at all if defaults
  51. cannot be found.
  52.  
  53.  
  54.     Editing
  55.     ¯¯¯¯¯¯¯
  56. The Devpac editor has been enhanced to take advantage of
  57. Workbench 3 features, if available, including new look
  58. menus and scroll bars, plus the new palette and busy
  59. pointer preferences.
  60.  
  61. When starting Devpac from a CLI, an empty window is now
  62. created for any named file which is not found.  The
  63. Workbench 2 version also recognises AmigaDOS patterns such
  64. as "#?.i" which would open all the files ending in ".i".
  65.  
  66. There is now a new command on the Project menu.  'Load'
  67. (Amiga-L) is useful when you wish to open a file without
  68. having it create an extra window like Open does.  Instead,
  69. Load replaces the current project with the selected file,
  70. prompting first if the project has been modified (like the
  71. Devpac 2 'Load' command).
  72.  
  73. The 'Close' command (Amiga-K) has moved to the Window menu
  74. and now only closes the current window.  'Delete' is now
  75. only provided in the 1.3 version (see below).  Some other
  76. Window menu commands now have shortened names.
  77.  
  78.  
  79. A number of new settings have been added.  A flashing
  80. cursor is optional and the Shift-Backspace command (delete
  81. to start of line) may be disabled.
  82.  
  83. 'Save Before Run' will automatically save any modified
  84. projects when you select Run or Debug.  This safeguards you
  85. in case your program crashes and ensures that the correct
  86. source files are used for debugging.  Selecting 'Ask'
  87. produces a requester before saving whilst 'Yes' saves all
  88. changes without prompting.
  89.  
  90. 'Program Window' lets you choose if a window is produced
  91. when you Run or Debug and whether it waits for a keypress
  92. before closing.  With Workbench 2 the window only appears
  93. if used and is closed by Ctrl-\.  Under 1.3, the message
  94. '<Program> failed returncode <n>' may appear.  This is
  95. simply what was returned in register D0, it does not
  96. indicate there was any problem running your program.
  97.  
  98. Two settings are only accessible by manually editing
  99. settings files: the clipboard unit number (CLIP=<n>) and
  100. the program window size (OUTPUTWIN=<x>,<y>,<w>,<h>).
  101.  
  102.  
  103. In the first printing of the manual, page 33 shows the
  104. split and join line keyboard shortcuts the wrong way round
  105. (Ctrl-= should be first).  The end of the 3rd paragraph on
  106. page 41 should say the LEFT Amiga key and the Find Error
  107. keyboard shortcut on page 60 should be Ctrl-F.  Additional
  108. shortcuts are:
  109.  
  110.     Right Amiga-I    Paste File
  111.     Right Amiga-K    Close Window
  112.     Ctrl-Shift-A    Arguments
  113.     Ctrl-Shift-D    Debug other program (see below)
  114.     Ctrl-O        Output Symbols (was Ctrl-S)
  115.     Ctrl-S        Set Settings
  116.     Ctrl-K        Delete to End of Line
  117.     Shift-F3        Cut (was Erase)
  118.     Shift-Alt-cursors    Scroll window
  119.  
  120. Use Esc to close the Find requester if you wish to retain
  121. its contents.  To enter Find text without an automatic Find
  122. Next, hold down Ctrl, Shift or Alt when pressing Return
  123. (this also works with other editor text gadgets).
  124.  
  125. The Shift-keypad shortcuts are now optional and bookmarks
  126. may be set using the numeric keypad for the benefit of
  127. French users.
  128.  
  129. Note that the current line and column numbers appear in the
  130. About requester (accessed via the Help key).
  131.  
  132.  
  133.     File Requesters
  134.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  135. Although the ARP file requester used by the 1.3 editor has
  136. an internal limit of 32 characters for directory names, it
  137. is possible to overcome this with Devpac.  To specify a
  138. long pathname such as "HardDisk:Devpac/programs/graphics/
  139. drawing.s" for example, you can select "HardDisk:Devpac/
  140. programs" as the Drawer and then type "graphics/drawing.s"
  141. into the File gadget.
  142.  
  143. The Workbench 2 editor uses the Commodore ASL file
  144. requester and Devpac is now supplied with version 2.1 of
  145. the asl.library.  2.0 users may wish to copy this file onto
  146. their Workbench disks.  Note that you can delete files
  147. directly from the new file requester with the 'Delete' menu
  148. option.
  149.  
  150. Some users may wish to use a program which replaces
  151. standard requesters with its own, such as the public domain
  152. ReqTools library.
  153.  
  154.  
  155.     Assembly
  156.     ¯¯¯¯¯¯¯¯
  157. Load and Save assembly options on the Assembly Settings
  158. menu now have the word Opts added.  To save the options use
  159. Save Opts, Save Opts As or the Save button on the Assembly
  160. Control requester.  Save Settings is for editor settings
  161. only; it does not save assembly options.
  162.  
  163. GenAm recognises the following additional command line
  164. options:
  165.  
  166.     INCDIR    Same as -I
  167.     HEADER    Same as -H
  168.     LIST    Same as LIST in the source
  169.     NOLIST    Same as NOLIST in the source
  170.     NOCODES    Suppress highlighting of error position
  171.     QUIET    Only give error and warning messages
  172.     ?        Show the command template (GENAM ?)
  173.  
  174. The assembler now warns you about out of range bit numbers
  175. as in BTST #9,(a0).  Three new OPT directives, CHKBIT,
  176. WARNBIT and NOCHKBIT give you control over whether this is
  177. an error (the default), a warning or disabled.
  178.  
  179. Directories without explicit file names are now supported
  180. for output paths if you include a trailing '/' or ':'
  181. symbol.
  182.  
  183. Note that symbol files are case sensitive according to how
  184. they are assembled.  The supplied system.gs file is not
  185. intended for use with Case Insensitive assembly.
  186.  
  187.  
  188.     Debugging
  189.     ¯¯¯¯¯¯¯¯¯
  190. Shift-Debug will enter MonAm without the current program.
  191. This may be used to debug a different program or examine
  192. system structures and is similar to the 'MonAm' option in
  193. the Devpac 2 editor.
  194.  
  195. When a program is started from MonAm, all of the registers
  196. except D0, A0 and A7 are now set to non-zero values to help
  197. you track down bugs in your programs since AmigaDOS does
  198. NOT guarantee that registers will initially be zero.
  199.  
  200. For Workbench 2 and above, MonAm's screen uses the same
  201. monitor and screen mode as Workbench by default and there
  202. are now three interlace preference options as follows (note
  203. that all of these use the 'text' size set from the Overscan
  204. preferences editor):
  205.  
  206.     Y    Default monitor (PAL/NTSC), interlaced
  207.     N    Default monitor (PAL/NTSC), non-interlaced
  208.     D    Same monitor and screen mode as Workbench
  209.  
  210. To activate a MonAm window, press Right Amiga and the
  211. window number.  This will adjust the display to reveal the
  212. window, if it is currently hidden, and then activate it.
  213. You can also use the Tab key to cycle through the windows.
  214.  
  215. Note that MonAm is not 'pure' for use with the AmigaDOS
  216. RESIDENT command.
  217.  
  218.  
  219.     Summary of Changes
  220.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  221.  *  Release 3.0 (V39) includes, libraries and FD files
  222.  *  New look menus, windows and busy pointer under Workbench 3
  223.  *  2.1 asl.library supplied
  224.  *  Uses the ASL font requester under Workbench 2 and above
  225.  *  Pattern gadget in ASL file requesters
  226.  *  Flashing cursor option in editor
  227.  *  Control over the Run and Debug window
  228.  *  Automatic saving option for Run and Debug
  229.  *  Load file into current editor window
  230.  *  New files and AmigaDOS patterns (2.0) allowed on CLI
  231.  *  More keyboard shortcuts (see above)
  232.  *  Assemble to disk whilst running from memory
  233.  *  New assembler options (see above)
  234.  *  Line 1 of a source file may contain instructions, it is
  235.     no longer restricted to options only
  236.  *  Shift-Debug calls up MonAm without any program
  237.  *  Debugger uses Workbench screen mode
  238.  *  Neater disassembly in MonAm with lower case and tabs
  239.  *  Fully A4000 and 68040 compatible debugger
  240.  
  241.  
  242. If you have any comments, suggestions or problems with this
  243. or any HiSoft product, please contact us at:
  244.  
  245.     HiSoft
  246.     The Old School
  247.     Greenfield
  248.     Bedford
  249.     MK45 5DE
  250.     U.K.
  251.  
  252.   Tel: +44 (0)525 718181
  253.   Fax: +44 (0)525 713716
  254.