home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / dev / asm / NewStartup35.readme < prev    next >
Text File  |  1996-01-05  |  5KB  |  131 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.  
  111.  
  112. ============================= Archive contents =============================
  113.  
  114. Original  Packed Ratio    Date     Time    Name
  115. -------- ------- ----- --------- --------  -------------
  116.     1188     545 54.1% 01-Sep-95 03:05:38 +Bin.info
  117.     1556    1037 33.3% 05-Sep-95 05:01:04 +Startup_example
  118.     1577     718 54.4% 09-Aug-95 02:42:30 +Startup_example.info
  119.     1188     540 54.5% 01-Sep-95 03:05:58 +Docs.info
  120.     1581     901 43.0% 01-Sep-95 03:05:38 +Startup.asm.info
  121.     1581     901 43.0% 01-Sep-95 03:29:30 +Startup_example.s.info
  122.     3836    1865 51.3% 08-Dec-95 01:22:58  NewStartup35.readme
  123.     1759     590 66.4% 09-Oct-95 17:56:30 +Digital.macs
  124.    16007    6628 58.5% 07-Dec-95 03:04:22 +Startup_asm.doc
  125.     1567     888 43.3% 01-Sep-95 03:05:58 +Startup_asm.doc.info
  126.     1023     437 57.2% 07-Dec-95 03:03:06 +Sample_header.s
  127.    12085    4165 65.5% 07-Dec-95 03:02:58 +Startup.asm
  128.     5779    2152 62.7% 07-Dec-95 03:02:42 +Startup_example.s
  129. -------- ------- ----- --------- --------
  130.    50727   21367 57.8% 10-Dec-95 22:41:16   13 files
  131.