home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / UN-LISTER-V2.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  5.5 KB  |  151 lines
  1.                                   ╒N-LISTER V2.0
  2.                                  ╩UST WHAT IS IT?
  3.  
  4.    ╒N-LISTER IS A MACHINE LANGUAGE PROGRAM THAT WILL TAKE YOUR ┬┴╙╔├ PROGRAMS
  5. AND MAKE THEM UNABLE TO BE LISTED. ╔F, FOR EXAMPLE, YOU HAVE A PROGRAM SUCH AS,
  6.  
  7.  
  8. 10 ╥┼┴─ ╪:╔╞ ╪=999 ╘╚┼╬ ┼╬─
  9. 20 ╨╥╔╬╘ ├╚╥$(╪);:╟╧╘╧10
  10. 30 ─┴╘┴ 71,69,78,69,32,76,79,86,69,83,
  11. 32,66,82,69,78,68,65,13,999
  12.  
  13.  
  14.    AND WERE TO RUN IT THROUGH ╒N-LISTER, THEN TRY TO LIST IT, YOU WOULD SEE:
  15.  
  16.  
  17. 10
  18. 20
  19. 30
  20.  
  21.  
  22.    ┘ET IT WOULD STILL RUN PERFECTLY. ┴ND NOW USING VERSION 2'S ─┴╘┴ ONLY OPTION
  23. THE SAME PROGRAM WOULD APPEAR AS:
  24.  
  25.  
  26. 10 ╥┼┴─ ╪:╔╞ ╪=999 ╘╚┼╬ ┼╬─
  27. 20 ╨╥╔╬╘ ├╚╥$(╪);:╟╧╘╧10
  28. 30
  29.  
  30.  
  31.                                 ╚OW DO ╔ USE IT?
  32.  
  33.    ╞IRST ╠╧┴─ THE PROGRAM: ╠╧┴─ "╒╬-╠╔╙╘┼╥",8. ╬OW ╥╒╬ IT. ╘HE MACHINE LANGUAGE
  34. WILL BE MOVED UP TO THE MEMORY ABOVE ┬┴╙╔├, AND THE REST OF THE PROGRAM WILL
  35. ERASE ITSELF. ┴FTER THE PROGRAM IS WHERE IT BELONGS TYPING ╙┘╙ 49152 WILL GIVE
  36. YOU THE ╒N-LISTER MENU. ╘HE FIRST THREE OPTIONS ARE WHAT YOU WILL SELECT WHEN
  37. YOU DO THE ACTUAL UN-LISTING. ┬UT BEFORE YOU CAN USE THESE SOME THINGS HAVE TO
  38. BE SET UP.
  39.  
  40.    ╙╧╒╥├┼ ─╥╔╓┼ ╬╒═┬┼╥:
  41.  
  42.    ╘HE SOURCE DRIVE IS THE ONE THAT YOUR ┬┴╙╔├ PROGRAM WILL COME FROM. ╔T IS
  43. USED ONLY WITH ─ISK TO ─ISK AND ─ISK TO ═EMORY UN-LISTING, SINCE THE SOURCE OF
  44. YOUR PROGRAM IN ═EMORY TO ─ISK IS, OF COURSE, THE COMPUTER'S ACTUAL MEMORY. ╘HE
  45. NUMBER CAN BE SET ANYWHERE FROM 8 TO 11. ╟OING PAST 11 WILL CAUSE THE NUMBER TO
  46. LOOP BACK AROUND TO 8.
  47.  
  48.    ─┼╙╘╔╬┴╘╔╧╬ ─╥╔╓┼ ╬╒═┬┼╥:
  49.  
  50.    ╘HE DESTINATION DRIVE IS WHERE THE UN-LISTED PROGRAM WILL END UP. ╔T DOESN'T
  51. MATTER WHAT IT IS SET FOR WHEN USING ─ISK TO ═EMORY BECAUSE THE UN-LISTED
  52. PROGRAM WILL END UP IN MEMORY. ╧NCE AGAIN THE NUMBER CAN BE SET FROM 8 TO 11.
  53.  
  54.    ╙╒╨┼╥ ╙┼├╒╥╔╘┘:
  55.  
  56.    ╧N THE SURFACE ╙UPER ╙ECURITY DOES NOT APPEAR TO DO ANYTHING. ╘HAT IS
  57. BECAUSE IT IS ONLY ADDED TO UN-LISTED LINES. ╫HAT IT DOES DO, THOUGH, IS ADD A
  58. ╥┼═ ╙╚╔╞╘-╠ TO THE END OF UN-LISTED LINES. ╘HIS MIGHT LOOK TO BE UNNECESSARY,
  59. BUT IT CAN BE HELPFUL WHEN DESPERATE PEOPLE BEGIN TO STRIP AWAY THE ╒N-LISTER
  60. SECURITY SCHEME. "╫HAT DOES ╥┼═ ╙╚╔╞╘-╠ DO," YOU ASK. ╘AKE THE FOLLOWING LINES:
  61.  
  62.  
  63. 10 ╨╥╔╬╘ "╔'═ ┴╘ ╠╔╬┼ 10!!"
  64. 20 ╨╥╔╬╘ "╔'═ ┴╘ ╠╔╬┼ 20!!"
  65.  
  66.  
  67.    ╬OW ADD THE ╥┼═ TO LINE 10 AND ╠╔╙╘ THE PROGRAM. ┘OU WILL SEE:
  68.               
  69.  
  70. 10 ╨╥╔╬╘ "╔'═ ┴╘ ╠╔╬┼ 10!!":╥┼═
  71.  
  72. ?╙┘╬╘┴╪ ┼╥╥╧╥
  73.  
  74.    ╬OW SUPPOSE YOU HAD THAT ╥┼═ ON EVERY UN-LISTED LINE. ╧R, PERHAPS, EVERY
  75. OTHER UN-LISTED LINE. ╔F A PERSON WERE TO BREAK THROUGH THE UN-LISTING, HOW
  76. WILLING WOULD THEY BE TO GO OVER ALL THOSE LINES, TO TAKE OUT ALL THOSE ╥┼═S?
  77.  
  78.    ╔F YOU WANT TO ADD ╙UPER ╙ECURITY PRESSING 6 WILL ALTERNATE BETWEEN ╧╞╞, 1
  79. ╧╬, AND 2 ╧╬. ╧╞╞ TURNS OFF ╙UPER ╙ECURITY, NOT ADDING IT ANYWHERE. 1 ╧╬ WILL
  80. PUT THE ╙UPER ╙ECURITY ON EVERY UN-LISTED LINE. 2 ╧╬ WILL PUT IT ON EVERY OTHER
  81. UN-LISTED LINE.
  82.  
  83.    ─┴╘┴ ╧╬╠┘:
  84.  
  85.    ╔F YOUR PROGRAM USES A LOT OF ─┴╘┴ STATEMENTS THAT YOU DON'T WANT PEOPLE TO
  86. SEE, THE VOCABULARY OF AN ADVENTURE GAME FOR INSTANCE, THEN SELECTING THIS
  87. OPTION WILL UN-LIST ONLY THE LINES CONTAINING ─┴╘┴. ╘HERE IS ONLY ONE
  88. PREREQUISITE FOR THIS; THE ─┴╘┴ STATEMENT MUST BE THE FIRST THING ON THE LINE.
  89.  
  90.  
  91.    ╞OR EXAMPLE:
  92.  
  93. 10 ─┴╘┴ ├┴╘, ─╧╟, ┴╬╔═┴╠╙
  94.  
  95.    ╫OULD UN-LIST, BUT,
  96.  
  97. 20 ╥┼┴─ ┴$:╨╥╔╬╘ ┴$:─┴╘┴ ├┴╘, ─╧╟, ┴╬╔═┴╠╙
  98.  
  99.    WOULD NOT.
  100.  
  101.  
  102.    ╨RESSING 7 WILL ALTERNATE BETWEEN ─ATA ╧NLY ╧╬ AND ╧╞╞. ╔T IS FULLY
  103. COMPATIBLE WITH ╙UPER ╙ECURITY SO USE THEM IN ANY COMBINATION YOU LIKE.
  104.  
  105.                               ╘HE ACTUAL UN-LISTING
  106.  
  107.    ╧NCE YOU HAVE EVERYTHING SET UP YOU ARE READY FOR THE ACTUAL UN-LISTING. ┘OU
  108. HAVE THREE OPTIONS WITH WHICH TO DO THIS.
  109.  
  110.    ╒╬-╠╔╙╘ ╞╥╧═ ─╔╙╦ ╘╧ ─╔╙╦:
  111.  
  112.    ╘HIS IS THE SLOWEST OPTION OF THE THREE. ╔F YOU SELECT THIS OPTION YOU WILL
  113. BE PROMPTED FOR '╔NITIAL ╞ILENAME 0:'. ╘HIS IS WHERE YOU WOULD TYPE IN THE FILE
  114. NAME OF YOUR ┬┴╙╔├ PROGRAM. ╬EXT YOU WOULD BE PROMPTED FOR '╬EW ╞ILENAME 0:'
  115. THIS IS THE FILE YOUR UN-LISTED ┬┴╙╔├ PROGRAM WILL BE WRITTEN TO. ╔F YOU DECIDE
  116. NOT TO USE THIS OPTION PRESSING ╥┼╘╒╥╬ WITHOUT TYPING ANYTHING OR PRESSING THE
  117. ╙╘╧╨ KEY WILL RETURN YOU TO THE MENU.
  118.  
  119.    ╔F THERE ARE NO ERRORS YOU WILL SOON SEE THE SCREEN FILLING UP WITH PLUSES
  120. (+++). ┼ACH PLUS REPRESENTS A ┬┴╙╔├ PROGRAM LINE. ╙O, IF YOUR PROGRAM HAS A
  121. HUNDRED LINES YOU WILL SEE A HUNDRED PLUSES. ╫HEN THE PROGRAM IS COMPLETELY
  122. UN-LISTED THE MESSAGE 'DONE' WILL APPEAR AND A BELL WILL RING. ┘OU WILL THEN BE
  123. RETURNED TO THE MENU.
  124.  
  125.    ╒╬-╠╔╙╘ ╞╥╧═ ═┼═╧╥┘ ╘╧ ─╔╙╦:
  126.  
  127.    ╘HIS OPTION ALLOWES YOU TO UN-LIST A PROGRAM IN MEMORY TO THE DISK DRIVE.
  128.  ┘OU WILL BE PROMPTED FOR A FILE NAME. ╘HIS WILL BE WHAT YOUR UN-LISTED PROGRAM
  129. WILL BE CALLED ON THE DISK. ┴S WITH ─ISK TO ─ISK UN-LISTING YOU CAN EXIT THE
  130. OPTION BY TYPING A ╥┼╘╒╥╬ WITHOUT ANYTHING ELSE OR BY PRESSING THE ╙╘╧╨ KEY.
  131.  
  132.    ╧NCE AGAIN, IF NOTHING GOES WRONG THE SCREEN WILL FILL WITH PLUSES AND THE
  133. PROGRAM WILL TELL YOU WHEN IT HAS FINISHED.
  134.  
  135.    ╒╬-╠╔╙╘ ╞╥╧═ ─╔╙╦ ╘╧ ═┼═╧╥┘:
  136.  
  137.    ╘HIS IS THE SAME AS THE ═EMORY TO ─ISK OPTION EXCEPT THAT IT TAKES A PROGRAM
  138. FROM DISK AND LEAVES THE UN-LISTED VERSION IN MEMORY. ┼NTER THE DISK PROGRAM
  139. NAME AT THE '╞ILENAME 0:' PROMPT.
  140.  
  141.                                   ╔N SUMMARY...
  142.  
  143.    ┬OTH ═EMORY TO ─ISK AND ─ISK TO ═EMORY ARE THE SAME SPEED, WHICH IS
  144. SIGNIFICANTLY FASTER THEN THE ─ISK TO ─ISK OPTION. ┘OUR UN-LISTED PROGRAMS WILL
  145. BE SLIGHTLY LARGER THEN THE ORIGINAL ┬┴╙╔├ VERSION. ╘HIS IS DUE TO THE
  146. PROTECTION SCHEME. ╙O COME ON, TAKE OUT YOUR FAVORITE PROGRAM THAT YOU HAVE
  147. BEEN THINKING ABOUT PUTTING IN THE PUBLIC DOMAIN BUT JUST DIDN'T WANT ANYONE TO
  148. SEE YOU PROGRAMING STYLE, AND UN-LIST IT!
  149.  
  150.                       ╨ROGRAM AND DOCUMENTATION BY ╟ENE ╬ASH
  151.