home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / nstartup.lha / Startup_Asm.readme < prev    next >
Encoding:
Text File  |  1995-09-05  |  3.6 KB  |  103 lines
  1. Short    : Very powerful startup code for assembler. 
  2. Author   : Kenneth C. Nilsen / Digital Surface (soon: djdoom@digsur.wws.no)
  3. Uploader : Kenneth C. Nilsen / Digital Surface (soon: djdoom@digsur.wws.no)
  4. Type     : dev/asm
  5.  
  6.  
  7. Requires kickstart 1.2+, any chip and configuration.
  8.  
  9.  
  10. Startup.asm
  11. ===========
  12.  
  13. $VER: Startup_asm 3.4 (5.9.95)
  14.  
  15. Copyright © 1995, by Kenneth C. Nilsen.
  16. All rights reserved.
  17.  
  18. The best startup code you find for assemblers.
  19. This source is free.
  20.  
  21. Any kickstart (1.2+), any chip and configuration will do.
  22.  
  23.  
  24.  
  25. WHY USE THIS CODE?
  26. ==================
  27.  
  28.      1) It makes your programs safe from crashing on system that has lower
  29.     processor configuration than you require. An error message is given
  30.     and the program will exit without executing any of your code.
  31.      2) It prevents your program to crash if you start from Workbench/icon.
  32.      3) Expands your assembler with 10 more commands!
  33.      4) Very easy to open libraries. One line opens a library. Even error
  34.     messages are given if any of the libraries can't be opened.
  35.      5) It enables easy argument parsing where one argument is given to you
  36.     one by one.
  37.      6) Very easy to implement in your sources, just one include (itself).
  38.      7) Supports the 68060 processor (tested).
  39.      8) Source is completly safe. Contributed to the public domain by 12 years
  40.     experience with programming.
  41.      9) You don't need any external includes to make this startup code work.
  42.     10) Learn how to deal with these situation by study the source.
  43.     11) Experiment with the source and make a startup code for your needs.
  44.     12) By using the internal NextArg macro you can have more UNIX like
  45.     option command lines for your programs. The ReadArgs() function is
  46.     limited in that manner.
  47.     13) Helps you setting the right return code at exit.
  48.     14) A demo program and source are following this archive.
  49.  
  50.  
  51.  
  52. NEW FEATURES
  53. ============
  54.  
  55. 3.4:
  56.     - Added <Return> macro. Use it like "Return 0" and it puts the return
  57.       code in D0 and makes a RTS automatically. Added info to doc and 
  58.       startup example. Optimized some code.
  59.  
  60.       Added comments in the Startup.asm source! :)
  61.  
  62.       Added *n (newline) feature in argument parsing. Use this like:
  63.       > Test "This is a test*nto see newline in *"qvotes*".". This will be:
  64.           > This is a test
  65.           > to see newline in "qvotes".
  66.  
  67.       Included a sample header source.
  68.  
  69. 3.3beta:
  70.     - Is now bug free! :) Only thing to change now is to read icon args/
  71.       tooltypes from Workbench due to a main release :)
  72.  
  73. 3.2beta:
  74.     - Added 68040 FPU options. Use:
  75.       MathProc = 68881/68882 or 68040 to set FPU. 0=no FPU.
  76.  
  77.  
  78.  
  79. BUG FIXES
  80. =========
  81.  
  82. 3.3beta:
  83.     - an enforcer hit fixed (BYTE READ FROM 0). Occured when starting from
  84.       icon with no argument. Never was dangerous, but still nice to have
  85.       it all clean :)
  86.  
  87. 3.2beta:
  88.     - there was a bug testing for 68060. If you had a 040 with 040FPU this
  89.       allowed you to run programs assembled for 060.
  90.     - a bug where reported about the Version and TaskName macros. These
  91.       work fine with AsmOne, but both DevPac and Barfly can not handle
  92.       spaces between words even if they are in qvotes. Sorry, can not do
  93.       something about this (I think) so write version strings manually and
  94.       use TaskName with underscores instead of spaces...
  95.     - an enforcer hit (BYTE READ FROM 0) where reported when started from
  96.       workbench. Working on the problem, but no danger... :)
  97.  
  98. 3.1beta:
  99.     - Implemented an unfinished Startup.asm file in the 3.0 archive.
  100.     - Expanded the NextArg macro to solve *" situations in arguments.
  101.     - Added buffercount for output strings. This caused misunderstandings
  102.       and people reported bugs. Not a bug, but not a good presentation :)
  103.