home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / LINKER2.SFX / linker2.doc next >
Encoding:
Text File  |  1995-05-13  |  3.0 KB  |  93 lines
  1. ╞ILE ╠INKER2 V1.1A
  2. ═ULTI-LEVEL FILE LINKER
  3.  
  4. ╙UPER═ICRO-DOCUMENTATION
  5.  
  6. (├) 1995 ┼LECTRON ╙OFTWARE
  7. BY ┴LAN ╫. ╥ATELIFF, ╔╔
  8. AN ╔3N ╨RODUCTION
  9.  
  10.  
  11. ╔NTRO:
  12.  
  13. ╫HILE WRITING ├OMMODORE ╬ETWORK ┬┬╙ ╔ CAME ACROSS THE NEED FOR PROGRAM MODULES,
  14. AS THEY ARE EASIER TO MODIFY THAN AN ENTIRE PROGRAM.  ┬UT ├┬═ ┬┴╙╔├'S LACK
  15. OF AN ACCEPTABLE MERGE UTILITY BECAME AND OBSTACLE.  ╔ WAS UNABLE TO FIND
  16. ONE ╔ LIKED ON ╤-╠INK, ╟┼NIE, OR THE LOCAL BOARDS, SO ╔ WROTE MY OWN.
  17.  
  18. ╘HIS IS A TOOL FOR DEVELOPMENT THAT ╔ WROTE FOR MYSELF TO USE, BUT ╔ AM GOING TO
  19. RELEASE IT FOR GENERAL USE, AND AS SUCH IS NOT ENTIRELY SELF-MAINTAINING.  ┘OU
  20. MUST LOAD THE ═╠ AND ┬┴╙╔├ PORTIONS SEPARATELY.
  21.  
  22.  
  23. ╔NSTRUCTIONS:
  24.  
  25. ╠INKER2 WILL ASK FOR SOURCE AND OBJECT DEVICES.  ╨RESSING ╥┼╘╒╥╬ DEFAULTS TO
  26. DEVICE 8.  ┴LL OPERATIONS ARE DONE ON DRIVE 0:.  ╘HE DRIVE ╠INKER2 WAS LOADED
  27. FROM IS CHECKED FOR THE CONFIG FILE, AND IF IT DOES NOT EXIST, ╠INKER2
  28. PREPARES TO CREATE A NEW ONE.
  29.  
  30.  
  31. ╨╥╧╟╥┴═ SETUP:
  32.  
  33. ╞IRST THE LIST OF OBJECT PROGRAMS (UP TO EIGHT) ARE DISPLAYED, AND THE 
  34. COMPONENTS OF THE HIGHLIGHTED FILE ARE SHOWN, WITH STARTING LINE NUMBERS.  ╘HIS
  35. LINE IS THE ACTUAL LINE NUMBER IN THE COMPONENT FILE THAT ╠INKER2 WILL ADD TO
  36. THE SOURCE FILE, SO A LISTING LIKE THIS:
  37.  
  38.        ╧BJECT ╞ILE 1        ╨ROGRAM 1     0
  39.                             ╨ROGRAM 2     100
  40.                             ╨ROGRAM 3     450
  41.                             ╨ROGRAM 4     600
  42.                             ***
  43.  
  44. ╒SES ALL LINES IN ╨ROGRAM 1, LINES 100 AND UP FROM ╨ROGRAM 2, LINES 450 AND UP
  45. FROM ╨ROGRAM 3, AND LINES 600 AND UP FROM ╨ROGRAM 4.  ╘HE MULTI-LEVEL DESIGN OF
  46. ╠INKER2 ALLOWS PROGRAM MODULES TO OVERLAP.
  47.  
  48. ╞OR INSTANCE, IF ╨ROGRAM 3 CONTAINS LINES 450 THRU 900, AND ╨ROGRAM 4 HAS LINES
  49. 600 THRU 750, THEN THE FOLLOWING BIT OF OBJECT IS PRODUCED:
  50.  
  51.        ... (FIRST PROGRAMS)
  52.        450 - 599 (╨ROGRAM 3)
  53.        600 - 750 (╨ROGRAM 4)
  54.        751 - 900 (╨ROGRAM 3)
  55.  
  56. ╠INKER2 CHECK PREVIOUS FILES FOR COMPLETION BEFORE CONTINUING.  ╘HERE CAN BE UP
  57. TO EIGHT COMPONENTS FOR EACH OBJECT PROGRAM, AND THEY CAN OVERLAY IN ANY WAY.
  58.  
  59.  
  60. ╦EYS
  61. ╧BJECTS:
  62.  
  63. ╥┼╘╒╥╬ SELECTS THE OBJECT FILE TO CREATE.  ╔F IT EXISTS, ╠INKER2 WILL ABORT.
  64. ╙╨┴├┼ SELECTS AND OBJECT FILE TO EDIT.  ╙ELECTING "***" WILL ADD A NEW OBJECT.
  65. ├╥╙╥-╥╘ WILL SIMPLY ALLOW EDITING OF COMPONENTS.
  66.  
  67. ├OMPONENTS:
  68.  
  69. ╥┼╘╒╥╬ SELECTS EDIT
  70. ╙╨┴├┼ EXITS EDIT
  71.  
  72.  
  73. [╫┴╥╬╔╬╟╙]:  ╘HE ═╠ PART (WHICH DOES THE ACTUAL LINKING) DOES NOT MONITOR FOR
  74.              DISK ERRORS.
  75.              ╠INKER2 CAN NOT BE STOPPED BY ╥╒╬/╙╘╧╨.
  76.  
  77. ╘O ╠╧┴─: (╔ PUT THIS LAST ON PURPOSE)
  78.  
  79. LOAD "╠╔╬╦┼╥2.╧┬╩",8,1  (OR ╩IFFY─╧╙  %LINKER2.OBJ )
  80. LOAD "LINKER2",8 / ╥╒╬  (OR           ^LINKER2 )
  81.  
  82. ---------------------------------------*--------------------------------------
  83.  
  84. ╠IKE ╔ SAID, ╔ WROTE THIS PROGRAM FOR MYSELF.  ╔F YOU LIKE IT, LET ME KNOW
  85. AND ╔ MIGHT MAKE IT A LITTLE FRIENDLIER, AND SPRUCE UP TO DOCS A BIT :)
  86.  
  87. ╙END COMMENTS TO:
  88.  
  89. A.RATELIFF@GENIE.GEIS.COM
  90.  
  91. ┬┴╙╔├ AND ═╠ SOURCES AVAILABLE ON REQUEST.
  92. ==============================================================================
  93.