home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / MERGER.SFX / doc.readme next >
Encoding:
Text File  |  1993-07-05  |  2.9 KB  |  93 lines
  1. ╨┴
  2.  
  3.  
  4.  
  5.  
  6.  
  7.    ┴BOUT ═ERGER:
  8.  
  9.     ═ERGER USES AN OLD DYNAMIC KEYBOARD TRICK TO 'MERGE' A  TEXT  FILE  INTO
  10.    YOUR PROGRAM. ═ERGER OPENS THE TEXT FILE, READS IN A LINE OF ┬┴╙╔├  CODE,
  11.    PRINTS THE LINE OF CODE TO THE SCREEN, POSITIONS THE CURSOR ON THAT LINE,
  12.    AND THEN EXECUTES A CARRIAGE RETURN TO ENTER THE LINE OF  CODE  INTO  THE
  13.    PROGRAM.
  14.  
  15.  
  16.    ╚OW TO USE ═ERGER:
  17.  
  18.     ╔N USE, ═ERGER WILL BE THE FIRST FEW LINES OF YOUR PROGRAM. ┘OUR  'REAL'
  19.    PROGRAM WILL START AT LINE 240.
  20.  
  21.     ┴SSUME THAT YOU WANT TO MERGE A PREVIOUSLY WRITTEN SUBROUTINE INTO  YOUR
  22.    PROGRAM. ╘HE SUBROUTINE CAN NOT CONTAIN ANY  LINE  NUMBERS  THAT  ALREADY
  23.    EXIST IN YOUR PROGRAM. ╥ENUMBER IT IF NECESSARY.
  24.  
  25.     ╬OW YOU NEED A TEXT FILE OF YOUR SUBROUTINE. ╘YPE IN THE FOLLOWING:
  26.  
  27.             OPEN8,8,8,"TEXT,S,W":CMD8:LIST:CLOSE8   <╥┼╘╒╥╬>
  28.  
  29.    ┘OU WILL NOW HAVE A TEXT COPY OF YOUR SUBROUTINE IN THE FILE 'TEXT'.
  30.  
  31.     ╫HEN YOU ARE TESTING YOUR PROGRAM YOU WILL TYPE:
  32.  
  33.             RUN  <╥┼╘╒╥╬>
  34.  
  35.     ╘O USE ═ERGER TYPE:
  36.  
  37.             RUN20  <╥┼╘╒╥╬>
  38.  
  39.    ═ERGER WILL THEN PROMPT YOU FOR THE FILE NAME  (IF  YOU  USED  THE  ABOVE
  40.    EXAMPLE YOU WOULD ANSWER: TEXT  <╥┼╘╒╥╬>).
  41.  
  42.     ╫HILE ═ERGER WORKS YOU WILL SEE  THE  MERGING  LINES  DISPLAYED  ON  THE
  43.    SCREEN. ╫HEN THE MERGING IS FINISHED YOU WILL SEE THE READY PROMPT AND  A
  44.    FLASHING CURSOR.
  45.  
  46.     ╔ HAVE INCLUDED IN ═ERGER A BACK-UP ROUTINE ╔ USE TO KEEP AN OLD COPY OF
  47.    THE PROGRAM ╔ AM WORKING ON. ╘HIS ROUTINE WILL FIRST SCRATCH  THE  OLDEST
  48.    COPY, THEN RENAME THE NEWEST COPY TO .BKUP, VALIDATE THE DISK,  AND  THEN
  49.    SAVE THE PROGRAM IN MEMORY TO DISK.
  50.  
  51.     ╘O USE THIS FEATURE TYPE:
  52.  
  53.             RUN200 <╥┼╘╒╥╬>
  54.  
  55.    ┘OU WILL THEN BE PROMPTED FOR THE NAME OF YOUR PROGRAM.
  56.  
  57.  
  58.    ╬OTES:
  59.  
  60.     ═AKE SURE THAT WHAT YOU ARE MERGING HAS UNIQUE LINE  NUMBERS.  ┴NY  LINE
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    NUMBERS IN THE TEXT FILE THAT MATCH LINE NUMBERS  IN  YOUR  PROGRAM  WILL
  71.    OVER WRITE THOSE LINES IN YOUR PROGRAM. ┘OU AS THE  PROGRAMMER  ARE  ALSO
  72.    RESPONSIBLE FOR TAKING CARE OF CONFLICTING VARIABLE NAMES, LOOPS, ECT.
  73.  
  74.     ╘HE ADVANTAGE OF  ═ERGER  IS  BEING  WRITTEN  IN  ┬┴╙╔├  IT  SHOULD  NOT
  75.    INTERFERE WITH ANY ML THAT YOU MAY BE USING IN YOUR PROGRAM.  ╘HIS  MEANS
  76.    IT IS COMPATIBLE WITH ┬┴╙╔├ EXTENSIONS (╔ HAVE USED IT WITH STANDARD  7.0
  77.    ┬┴╙╔├ AND ┬┴╙╔├ 8).
  78.  
  79.     ╘HE DISADVANTAGE OF ═ERGER IS, IF YOU ARE MERGING A LARGE PIECE OF CODE,
  80.    THAT  IT  MAY  TAKE  SOME  TIME  FOR   ═ERGER   TO   MERGE   YOUR   CODE.
  81.  
  82.     ╔ AM NOT THE ORIGINATOR OF THESE ROUTINES, THEY WERE  USED  ON  THE  C64
  83.    (AND BEFORE THAT ╔ THINK THEY WERE USED ON THE ├┬═ MACHINES). ╔  MODIFIED
  84.    THEM FOR USE ON THE C128 AND AM JUST PASSING THEM ALONG TO THOSE WHO  MAY
  85.    NOT HAVE SEEN THEM BEFORE.
  86.  
  87.     ╔ WILL UPLOAD THE C64 VERSIONS IF ╔ CAN FIND THEM, BUT IT  SHOULDN'T  BE
  88.    TOO HARD TO CHANGE THE C128 ONES BACK TO USE ON THE C64.
  89.  
  90.  
  91.                                           ─AN
  92.                                           ╟┼NIE: ─╚ARKER1
  93.