home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / drwimp / DrWimp / Utils / !Linker / !Help next >
Text File  |  1997-06-02  |  3KB  |  93 lines
  1.  
  2.                    ------------------------------------
  3.                                   LINKER
  4.  
  5.                          version 2.01 (02-Jun-97)
  6.  
  7.                            © Andrew Ayre 1996-97
  8.                    ------------------------------------
  9.  
  10. INTRODUCTION...
  11.  
  12.   Linker takes a BASIC RunImage file (or similar) and a BASIC library file
  13. which it calls and creates a new RunImage file which is the old RunImage
  14. file plus  just the bits of the library file that are required.
  15.  
  16.   This can be very useful if the library is large, and a fair proportion of
  17. it is not used.
  18.  
  19.   LINKER WILL NOT WORK IN A READ-ONLY FILING SYSTEM
  20.  
  21.  
  22. USING...
  23.  
  24.   Load in the usual way by double-clicking on the icon. Linker supports
  25. interactive help applications such as Acorn's !Help.
  26.  
  27.   Click on the icon to open the main window, which consists of two large
  28. “drop boxes”. One is for the RunImage to be dropped on and the other is for
  29. the library.
  30.  
  31.   Alternatively you can type the full pathnames into the writeable icons
  32. below.
  33.  
  34.   If you have just added the bits of the library that are needed, any
  35. LIBRARY commands are now redundant, and will have to be removed.
  36.   The “Strip LIBRARY” option will make Linker strip LIBRARY commands out of
  37. the final RunImage. The option is on by default, and clicking on the radio
  38. icon allows you to toggle it on and off.
  39.  
  40.   Clicking on “Cancel” will ignore any changes you have made and close the
  41. window. Clicking on “Link” will bring up a save box.
  42.  
  43.   Use the save box in the usual way to specify a place to save the new
  44. RunImage to. You are not allowed to overwrite the original RunImage or the
  45. library as these are needed! and because messing about with your original
  46. copies is a daft thing to do anyway.
  47.  
  48.   If everything you have specified so far is valid then the linking will
  49. begin and a status window will open telling you what is going on. A progress
  50. bar will show how much has been completed of each stage.
  51.  
  52.   The stages are (in order):
  53.  
  54.     Reading RunImage function calls and definitions.
  55.     Reading Library function calls and definitions.
  56.     Compling functions needed (will take several passes to complete).
  57.     Linking RunImage with Library.
  58.  
  59.   If you are using the exact same library (not neccessarily the same actual
  60. file, but a file with the exact same contents) as last time you used Linker,
  61. then it will be recognised and the second stage (listed above) will just
  62. take moment instead of a minute or so.
  63.  
  64.  
  65. NOTES...
  66.  
  67.   When I mention the RunImage file it doesn't mean that the the BASIC file
  68. has to be called “!RunImage” or “RunImage”, but is just a name for the main
  69. program that calls the functions in a BASIC library.
  70.  
  71. All procedures and functions (except the last one) MUST end with a
  72.  
  73.   :
  74.  
  75. on a line by itself with no preceding spaces.
  76.  
  77.   BlibII tags eg:
  78.  
  79. *|start <name>
  80.  
  81. are allowed but they must be on a line by themselves with no preceding
  82. spaces.
  83.  
  84.  
  85. CONDITIONS OF DISTRIBUTION...
  86.  
  87.   Linker may be distributed freely as long as all of the files are
  88. included and unaltered and no profit is made.
  89.  
  90.   If you got your copy with the DrWimp programming system then it may be
  91. distributed seperately, but I remind you that the DrWimp system must not be
  92. distributed without Linker.
  93.