home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / s / super25n.zip / START.DOC < prev    next >
Text File  |  1993-01-05  |  4KB  |  122 lines
  1.  
  2.                     ┌───────────────────────────────┐
  3.                     │         SuperLib 2.50         │
  4.                     │    For Clipper S87 and 5.01   │
  5.                     │    -------------------------  │
  6.                     │       copyright 1990          │
  7.                     │      Garry A Prefontaine      │
  8.                     └───────────────────────────────┘
  9.  
  10.                             Getting started
  11.                             ---------------
  12.  
  13.  SuperLib comes with two library files:
  14.  
  15.     SUPER.LIB  is for use with Summer 87 Clipper
  16.     SUPER5.LIB is for use with Clipper 5.01
  17.  
  18.  The simplest approach is to think of SUPER.LIB (or SUPER5.LIB) in the same
  19.  way you think of CLIPPER.LIB and EXTEND.LIB. SUPER.LIB contains functions
  20.  which may be called by your programs. Think of these functions just
  21.  as you would the functions in the Clipper manual. The LINKER needs to know
  22.  where to find these functions, thus you need to tell it to look in SUPER.LIB
  23.  (or SUPER5.LIB).
  24.  
  25.  There really is not much more to it than that. The Clipper Source code and
  26.  C source code are provided in the registered version - but are not needed
  27.  unless you intend to MODIFY or recompile something.
  28.  
  29.  All you really need to get going is either SUPER.LIB or SUPER5.LIB.
  30.  
  31.  
  32.  
  33.                              Initialization
  34.                              --------------
  35.  
  36.  SuperLib 2.5NW uses a few global (public) variables, for colors, system
  37.  file names and paths, etc.
  38.  You should call INITSUP() at your top level program, to get the global
  39.  variables declared and available. INIT.DOC goes into more detail regarding
  40.  initialization, but all you really need to know to get started is to call
  41.  INITSUP() at program start.
  42.  
  43.  
  44.                                  Colors
  45.                                  ------
  46.  
  47.  Be sure to read COLORS.DOC to get a grasp on how SuperLib colors
  48.  are implemented, if you wish to change the default color setups.
  49.  
  50.  
  51.                'Unresolved External' message from linker
  52.                -----------------------------------------
  53.  
  54.  If you get 'Unresolved External' messages from your linker, be sure you
  55.  are either: a) referencing SUPER.LIB before EXTEND.LIB  or b) using
  56.  SEARCH instead of LIB with your linker.
  57.  
  58.  
  59.                               Clipper 5.01
  60.                               ------------
  61.  
  62.  If using Clipper 5.01, be sure you are linking SUPER5.LIB and not SUPER.LIB,
  63.  or you'll get lots of errors!
  64.  
  65.                               SuperLib 3.0
  66.                               ------------
  67.  
  68.  SuperLib 3.0 is available for thos who want Clipper 5.01 optimization.
  69.  SuperLib 3.0 also comes with close to 200 additional functions. See
  70.  SUPER30.DOC for details.
  71.  
  72.                          Linking with Super.Lib
  73.                          ----------------------
  74.  
  75.  Where <program> refers to your OBJ file(s) ,<other libs>
  76.  refers to other Libraries you may wish to use. SUPER.LIB is
  77.  the S87 version, SUPER5.LIB is the Clipper 5.0 version.
  78.     Note: not all linkers are covered here. My preference
  79.     is BLINKER or RTLINK
  80.  
  81.  
  82.   1. BLINKER
  83.  
  84.     Command line:
  85.     BLINKER FI <program> LIB super
  86.     Link File:
  87.     Here is the link file I use with Blinker, calling like so:
  88.     BLINKER FILE <file> @BLINK.LNK
  89.      where BLINK.LNK contains:
  90.      BLINKER EXECUTABLE CLIPPER V10;R24;E0;F21
  91.      BLINKER MEMORY PACK 15
  92.      # put other .objs for the root here
  93.      BEGINAREA
  94.             ALLOCATE SUPER
  95.             ALLOCATE EXTEND
  96.      ENDAREA
  97.      LIBRARY CLIPPER
  98.  
  99.     I have seen some odd problems caused by using the
  100.     CL???MIN.LNK, CL???MID.LNK,CL???MAX.LNK
  101.     supplied with Blinker 1.5. If you are using one of these
  102.     and having problems, try just a regular link,
  103.     ALLOCating EXTEND.LIB.
  104.  
  105.   2. RTLINK (Clipper 5.01)
  106.  
  107.     RTLINK FILE <program> LIB <other libs>,super5
  108.  
  109.   *past a certain point (size), the linkers below will not work
  110.    with SuperLib.
  111.  
  112.   3. Turbo Link (Tlink)
  113.     TLINK <program>,,,clipper+extend+<otherlibs>+super
  114.  
  115.   4. Microsoft Link
  116.     LINK <program>,,,clipper,extend,<other libs>,super /NOE /SE:512
  117.  
  118.   5. Plink86
  119.     PLINK86 FILE <program> SEARCH clipper, <other libs>,super,extend
  120.  
  121.  
  122.