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