home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / tempest.lha / drlib17.lha / ReadMe < prev    next >
Text File  |  1993-05-12  |  5KB  |  116 lines
  1.                                Welcome!
  2.  
  3.                                DOOR.LIB
  4.  
  5.                   By The Technician, aka Rick Rumer
  6.  
  7. NOTE: New to Version 1.7 - 
  8.  
  9.              for SMALLCODE,SMALLDATA models, use DOOR.LIB
  10.         for LARGECODE,LARGEDATA (-b0) models, use DOORBIG.LIB
  11.  
  12.  
  13.    Before  you  read  any  further:  This .LIB file is ONLY useful for
  14. programmers  creating DOOR or CLI programs for Tempest BBS!  It is NOT
  15. compatible, nor will it be, with ANY other BBS system!
  16.  
  17.                    That said, let's get on with it!
  18.  
  19. Q.   What's the difference? Why should I use this instead of the
  20.       L_DOOR.o code? Who cares? 
  21. A.   When you link with L_DOOR.o code, ALL of the modules are added to
  22.       your door code, EVEN if they are NOT used! This makes for large
  23.       door programs, and wastes space. When you link with DOOR.LIB,
  24.       ONLY the modules you've used in your program are added. This is
  25.       done by the compiler, NOT something you must do manually!
  26.  
  27. Q.   What other advantages are there?
  28. A.   With L_DOOR.o, you MUST be using the Lattice/SASC compiler, and
  29.       not only that, but you must be using the same VERSION! (5.1b)
  30.       This .LIB file should be portable to ANY other compiler,
  31.       including DICE, GNU, and of course MANX. (I haven't tested this,
  32.       but it says you can....)
  33.      This library contains a version number, which can be read with
  34.       the VERSION command in AmigaDOS. Simply type :
  35.       1> VERSION DOOR.LIB
  36.       and it will report:
  37.       DOORLIB 1.0
  38.       I had to take the period out of it for the BumpRev program to
  39.       work, so that I could update it as neccessary. ;-)
  40.       This enables you to tell easily which version you're using, in
  41.       the likely event of updates.
  42.  
  43. Q.   OK, that's neat. But it still only has the same stuff in it, right?
  44. A.   NO. I've added some personal favorites, PLUS revamped some of the
  45.       old routines to make them better! See the file "Routine.DESC"
  46.       for descritions and Usage of the new/changed routines. PLEASE
  47.       NOTE:    NO ROUTINES HAVE BEEN REMOVED!!! ANY door you've
  48.       written will still be compatible! (As of V1.4v4 of Tempest)
  49.  
  50. Q.   OK, now I'm convinced! But, how do I use it? What might my
  51.       makefile and/or link file look like?
  52. A.   It couldn't be easier. We'll use my door program called new user
  53.       application for an example.
  54.  
  55.       Example:
  56.  
  57. OLD APP.LNK:
  58.                FROM LIB:c.o+"APP.o"
  59.                TO "APP2"
  60. --->           LIB "LIB:L_DOOR.o" LIB:lc.lib LIB:amiga.lib
  61.                SMALLCODE
  62.                SMALLDATA
  63.                VERBOSE
  64.  
  65. NEW APP.LNK:
  66.                FROM LIB:c.o+"APP2.o"
  67.                TO "APP2"
  68. --->           LIB LIB:DOOR.LIB LIB:lc.lib LIB:amiga.lib
  69.                SMALLCODE
  70.                SMALLDATA
  71.                VERBOSE
  72.  
  73.       This same method would also apply to those using MakeFile
  74.       (LmkFILE) formats. I have tested this thouroughly, as has The
  75.       Skeleton, and no bugs or problems have been found. Door code is
  76.       typically 400 bytes smaller MINIMUM, and in my case, it shaved off
  77.       4,000 bytes!!!! (4K) of the Application program!
  78.  
  79. Q.   If it's this easy to use, why didn't somone do it before?
  80. A.   I didn't know how.... ;-)  Now I do, so you can reap the
  81.       benefits!
  82.  
  83. NOTE TO OTHER PROGRAMMERS :
  84.  
  85.    If  you  have  some really neat code you would like included in the
  86. library,  send  it  to me as a P-FILE on NiteFall II.  I'm looking for
  87. swift  routines that perform cumbersome duties, in an effort to assist
  88. persons  new to programming for Tempest.  With the design of this .LIB
  89. file,  the  routines that can be added are almost limitless, and since
  90. ONLY  routines  that  are  used  are added to your final output, there
  91. isn't any overhead of unneeded routines!
  92.  
  93.  
  94.    if  you  have  ANY Questions not answered here, or if you just need
  95. some  clarification,  I  can always be reached on my BBS, which you'll
  96. see my little blurb right below this line....
  97.  
  98.             ___________| __       This file happily presented to you
  99.            <___________|<  >=     from those of us on NiteFall II BBS!
  100.                        | \ \  
  101.                     /X\   > >  Featuring the BEST of the Public Domain!
  102.                  __/   \_/ /        (Amiga, MACintosh, IBM/Clones)
  103.                 / / ` ,') /   
  104.                /    \__/ /     300 - 19.200 Baud     USR DUAL-STD MODEM!
  105.               / /\      )           (300-1200 Message Bases Only)
  106.       _______< <__)    /          (515) 277-1320   (Des Moines, IA)
  107.      /        \ \     (       
  108.     /    \    <__>     \           SUPPORTING THE NEW MNP-5 MODEMS!
  109.    //\/  /--\____   __ |      
  110.   // /  /  /     \ |  ||           654 Megs!  24 hrs, 7 days a week
  111.   \| \ |\ |       ||  ||      
  112.       || ||       ||  ||          Tempest BBS software support site!
  113.       || ||       ||  ||      
  114.       |_\|_\      |_\ |_\          CALL NOW!!!! Access first call!
  115.  
  116.