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