home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128Toolkit / PROTECTOR128.SDA / ÐROTECTOR128.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  10.4 KB  |  595 lines
  1.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                             ╠IST ╨ROTECTOR 128 V2.0
  14.                   ┴ ┬┴╙╔├ PROGRAM FILE LIST PROTECTION UTILITY
  15.                               ┬Y: ╠ONNIE ─E ├LOEDT
  16.                                ├OPYRIGHT (C) 1987
  17.                            ╘ & ╙ ╙OFTWARE ─EVELOPMENT
  18.  
  19.  
  20.  
  21.  
  22.          ╘HIS PROGRAM IS PLACED IN THE ╨UBLIC ─OMAIN  BY  THE  AUTHOR.
  23.          ╔T IS NOT ╞╥┼┼╫┴╥┼ OR ╙╚┴╥┼╫┴╥┼ (THAT  NEVER  WORKS  ANYWAY),
  24.          BUT IF YOU  FEEL  COMPELLED  TO  SEND  ME  A  COUPLE  HUNDRED
  25.          DOLLARS, ╔ WON'T STAND IN YOUR WAY.  ╔ WOULD ALSO  APPRECIATE
  26.          ANY AND ALL COMMENTS,  CRITICISMS,  COMPLAINTS,  SUGGESTIONS,
  27.          IDEAS, ETC. YOU MIGHT HAVE.   ═Y  ╟┼NIE  MAILBOX  ADDRESS  IS
  28.          ╞╔╬╬.  ╧R YOU COULD LEAVE A NOTE ON THE BOARD ╔  CO-RUN,  ╘HE
  29.          ╥IVERBOAT ┴DVENTURE - (818) 888-3221.  ╩UST LEAVE ╞EEDBACK TO
  30.          ╠ONNIE.  ╔F YOU'RE IN NO HURRY, AND WISH TO COMMENT  VIA  THE
  31.          ╨OST ╧FFICE, MY ADDRESS IS:
  32.  
  33.                                 ╠ONNIE ─E ├LOEDT
  34.                                 520 ┬ARD ╙TREET
  35.                               ═OORPARK, ├┴   93021
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 1
  66.  
  67.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  68.  
  69.          ╠IST ╨ROTECTOR WILL ALLOW YOU TO  RENDER  YOUR  ┬┴╙╔├  SOURCE
  70.          FILES UN-LISTABLE BY OTHERS.  ╘HIS CAN BE  HANDY  IN  KEEPING
  71.          PEOPLE FROM SEEING  YOUR  CODE,  ESPECIALLY  IF  IT  CONTAINS
  72.          PASSWORDS OR SOMETHING ELSE YOU DON'T WANT THE USER  TO  SEE.
  73.          ╔ WROTE MY ORIGINAL ╠IST ╨ROTECTOR FOR THE 64 ABOUT  3  YEARS
  74.          AGO.  ╘WO YEARS AGO, ╔ TRANSLATED IT  FOR  THE  128  IN  IT'S
  75.          NATIVE MODE.  ┘ESTERDAY, ╔ DECIDED TO BLOW THE DUST  OFF  THE
  76.          OL' DISK AND COMPLETELY REWRITE IT, THE RESULT OF THAT  BEING
  77.          ╠IST ╨ROTECTOR V2.0.  ╔F YOU HAVE USED EITHER OF MY  PREVIOUS
  78.          PROTECTORS, YOU WILL NOTICE  THE  VAST  DIFFERENCE.   ╧N  THE
  79.          OTHER HAND,  IF  YOU  HAVE  DOWNLOADED  ─IS╦AT,  THE  CATALOG
  80.          PROGRAM ╔ WROTE A COUPLE DAYS AGO, YOU WILL NOTICE AN UNCANNY
  81.          SIMILARITY BETWEEN THE TWO.
  82.  
  83.          ╘O  GET   THINGS   GOING,   AT   THE   SYSTEM   LEVEL,   TYPE
  84.          RUN"╨ROTECTOR128 2.0" AND HIT  ╥┼╘╒╥╬.   ╠IST  ╨ROTECTOR  128
  85.          V2.0 WORKS IN 80 COLUMN MODE ONLY, SO IF YOU BOOT IT UP IN 40
  86.          COLUMN MODE, YOU WILL BE INSTRUCTED TO SWITCH YOUR MONITOR TO
  87.          80 COLUMN MODE.  ┴FTER THE ═╠ FILES ARE LOADED, YOU WILL  SEE
  88.          THE TITLE SCREEN.  ╨RESS ╥┼╘╒╥╬  TO  CONTINUE  ON  FROM  THIS
  89.          POINT.
  90.  
  91.          ╘HE NEXT SCREEN YOU WILL SEE IS THE ═AIN ═ENU.   ╘HE  OPTIONS
  92.          AVAILABLE ARE:
  93.  
  94.                                ─EFINE ╔NPUT ╞ILE
  95.                                ─EFINE ╧UTPUT ╞ILE
  96.                                    ╨ROTECT ╔T
  97.                                ┼NTER ╠IST ═ESSAGE
  98.                                   ─╧╙ ├OMMANDS
  99.                                ┼XIT ╨ROTECTOR 128
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 2
  132.  
  133.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  134.  
  135.          ─EFINE ╔NPUT ╞ILE
  136.          -----------------
  137.  
  138.          ╘HIS IS THE ROUTINE YOU WILL USE TO LET  ╠IST  ╨ROTECTOR  128
  139.          KNOW WHICH FILE YOU WANT TO PROTECT.  ┴T  THE  FIRST  PROMPT,
  140.          ┼NTER ╔NPUT ╞ILENAME, HITTING ╥┼╘╒╥╬ ALONE WILL RETURN YOU TO
  141.          THE MAIN MENU.
  142.  
  143.          ┘OU CAN TYPE ANY LEGAL ├OMMODORE  FILENAME  HERE,  TO  ASSIGN
  144.          THAT AS THE INPUT FILENAME.
  145.  
  146.          ┴FTER ENTERING THE FILENAME, YOU WILL  BE  ASKED  WHICH  DISK
  147.          DRIVE HOLDS THAT FILE.  ┘OU CAN ENTER ANY DEVICE NUMBER  FROM
  148.          8 THROUGH 15.  ┴FTER SUPPLYING THE DEVICE NUMBER,  THE  INPUT
  149.          FILE AND DRIVE ARE STORED AND YOU ARE RETURNED  TO  THE  MAIN
  150.          MENU.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 3
  198.  
  199.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  200.  
  201.          ─EFINE ╧UTPUT ╞ILE
  202.          ------------------
  203.  
  204.          ╘HIS IS THE ROUTINE YOU WILL USE TO LET  ╠IST  ╨ROTECTOR  128
  205.          KNOW WHICH FILENAME YOU WANT TO WRITE THE  FINAL,  PROTECTED,
  206.          COPY TO.  ┴T THE FIRST PROMPT, ┼NTER ╧UTPUT ╞ILENAME, HITTING
  207.          ╥┼╘╒╥╬ ALONE WILL RETURN YOU TO THE MAIN MENU.
  208.  
  209.          ┘OU CAN TYPE ANY LEGAL ├OMMODORE  FILENAME  HERE,  TO  ASSIGN
  210.          THAT AS THE OUTPUT FILENAME.
  211.  
  212.          ┴FTER ENTERING THE FILENAME, YOU WILL BE ASKED FOR  THE  DISK
  213.          DEVICE YOU WISH TO PUT THAT  FILE  ON.   ┘OU  CAN  ENTER  ANY
  214.          DEVICE NUMBER FROM 8 THROUGH 15.  ┴FTER SUPPLYING THE  DEVICE
  215.          NUMBER, THE OUTPUT FILE AND DRIVE  ARE  STORED  AND  YOU  ARE
  216.          RETURNED TO THE MAIN MENU.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 4
  264.  
  265.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  266.  
  267.          ╨ROTECT ╔T
  268.          ----------
  269.  
  270.          ╘HIS IS THE WORKHORSE ROUTINE OF THE PROGRAM.   ╘HIS  IS  THE
  271.          ROUTINE THAT  ACTUALLY  DOES  THE  ╠IST  ╨ROTECTION  TO  YOUR
  272.          PROGRAM.
  273.  
  274.          ╞IRST, IT CHECKS TO MAKE SURE THAT  THE  DEVICE  NUMBERS  YOU
  275.          ENTERED ARE LEGITIMATE AND THAT THE DRIVES DO EXIST.  ╘HEN IT
  276.          CHECKS THE INPUT FILENAME, TO MAKE SURE  IT  EXISTS.   ╔F  IT
  277.          DOES, IT THEN CHECKS THE OUTPUT  FILENAME  TO  MAKE  SURE  IT
  278.          DOESN'T.  ╔F ALL GOES WELL, IT WILL  THEN  VERIFY  THAT  YOUR
  279.          INPUT FILE IS IN FACT A ┬┴╙╔├ SOURCE  FILE.   ╠IST  ╨ROTECTOR
  280.          128 V2.0 CAN DETERMINE WHETHER YOUR FILE WAS SAVED IN 64 MODE
  281.          OR 128 MODE, AND DISPLAYS ACCORDINGLY.
  282.  
  283.          ╔F ANY OF THE ABOVE CONDITIONS ARE  MET  WITH  UNSATISFACTORY
  284.          RESULTS, YOU WILL BE INFORMED OF THE PROBLEM AND RETURNED  TO
  285.          THE MAIN MENU.  ╧THERWISE, ╠IST ╨ROTECTOR WILL  GO  TO  WORK,
  286.          DISPLAYING THE LINE NUMBER IT IS CURRENTLY WORKING ON, AS  IT
  287.          GOES.  ╫HEN ALL IS  FINISHED,  THE  FILES  ARE  CLOSED,  ╠IST
  288.          ╨ROTECTOR TELLS YOU IT'S DONE, AND RETURNS TO THE MAIN MENU.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 5
  330.  
  331.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  332.  
  333.          ┼NTER ╠IST ═ESSAGE
  334.          ------------------
  335.  
  336.          ┘OU CAN USE THIS ROUTINE TO  ENTER  A  SHORT  MESSAGE  TO  BE
  337.          DISPLAYED WHENEVER  SOMEONE  TRIES  TO  LIST  YOUR  PROTECTED
  338.          PROGRAM FILE.  ╔T IS ACCOMPLISHED  BY  PUTTING  YOUR  MESSAGE
  339.          INTO A ╥┼═ STATEMENT AT THE BEGINNING OF THE PROGRAM WITH THE
  340.          LINE NUMBER 0.  ╔F YOU HAVE A  LINE  NUMBERED  ZERO  IN  YOUR
  341.          PROGRAM, DON'T WORRY.  ╘HIS IS ONLY A ╥┼═  STATEMENT,  SO  IT
  342.          WILL  HAVE  NO  EFFECT  ON  YOUR  PROGRAMS  EXECUTION.   ╠IST
  343.          ╨ROTECTOR 128 V2.0 DOES NOT REQUIRE YOU TO ADD A LIST MESSAGE
  344.          TO YOUR PROGRAM, BUT IT CAN BE HANDY.
  345.  
  346.          ┘OU ARE LIMITED TO 246 CHARACTERS IN YOUR MESSAGE DUE TO  THE
  347.          FACT THAT A ├OMMODORE ┬┴╙╔├ LINE IS LIMITED TO 256 BYTES, AND
  348.          THE OTHER 10 BYTES ARE TAKEN UP BY THE LINE NUMBER, NEXT-LINE
  349.          POINTER, ╥┼═ STATEMENT, ETC.
  350.  
  351.          ┘OU CAN BE CREATIVE WITH THE LINE MESSAGE  EDITOR,  INSERTING
  352.          COLOR CODES, CLEAR SCREEN CODES, CURSOR  CODES,  ETC.  TO  BE
  353.          PRINTED UPON LISTING.  ╫HILE IN THE EDITOR, WHEN YOU ENTER  A
  354.          SPECIAL CHARACTER, IT WILL NOT BE ECHOED TO THE  SCREEN  LIKE
  355.          IT NORMALLY WOULD, BUT YOU WILL  SEE  A  "DESCRIPTION".   ╞OR
  356.          INSTANCE, IF YOU PRESS THE ├╠╥/╚╧═┼ KEY, THE  MESSAGE  "[╚╧═┼
  357.          ]" WILL BE  DISPLAYED.   ╫HEN  YOU  ARE  FINISHED  WITH  YOUR
  358.          MESSAGE, PRESS THE ╞1 KEY.
  359.  
  360.          ┘OU WILL THEN BE SHOWN WHAT YOU HAVE ENTERED, EXACTLY  AS  IT
  361.          WILL APPEAR WHEN YOU LIST YOUR FINAL  FILE.   ├HECK  TO  MAKE
  362.          SURE IT IS CORRECT, AND WHEN YOU SEE  THE  PROMPT  "╫AS  THAT
  363.          CORRECT?", ENTER ┘ IF IT WAS OR ╬ IF IT WASN'T.
  364.  
  365.          ╔F YOU HIT ╬, YOU WILL HAVE THE CHOICE OF  RETURNING  TO  THE
  366.          LIST MESSAGE EDITOR, OR THE MAIN MENU.   ╚IT  ╥  TO  RE-ENTER
  367.          YOUR MESSAGE, OR ═ TO ABORT.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 6
  396.  
  397.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  398.  
  399.          ─╧╙ ├OMMANDS
  400.          ------------
  401.  
  402.          ╘HIS CAN  USE  THIS  ROUTINE  TO  VIEW  THE  DIRECTORY  OF  A
  403.          DISKETTE, SCRATCH FILES, RENAME FILES, FORMAT A DISK,  CHANGE
  404.          TO A DIFFERENT SUB-DIRECTORY ON A 1581, SET A 1571 TO  SINGLE
  405.          OR DOUBLE SIDED MODE, ETC.  ╔T IS EXACTLY THE SAME AS THE ─╧╙
  406.          ├OMMANDS ROUTINE IN ─IS╦AT V1.0.
  407.  
  408.          ┴ HELP SCREEN IS DISPLAYED, SHOWING YOU THE MORE COMMON  DISK
  409.          COMMANDS AND THEIR SYNTAX, PLUS A FEW COMMANDS ╔ CREATED  FOR
  410.          THIS ROUTINE.
  411.  
  412.          ╧NE  COMMAND  YOU  MIGHT  NEED  IS  THE  "@XX"  COMMAND.   ┬Y
  413.          REPLACING THE X'S WITH A VALID DISK DEVICE NUMBER (8-15), YOU
  414.          CAN ACTIVATE A DIFFERENT UNIT, AND ALL FURTHER COMMANDS  WILL
  415.          BE SENT TO THAT DEVICE, UNTIL YOU ISSUE THAT  COMMAND  AGAIN.
  416.          ╘HE CURRENT ACTIVE DEVICE NUMBER IS DISPLAYED AT THE  TOP  OF
  417.          THE SCREEN.
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 7
  462.  
  463.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  464.  
  465.          ┼XIT ╨ROTECTOR 128
  466.          ------------------
  467.  
  468.          ╘HIS ROUTINE WILL EXIT ╠IST ╨ROTECTOR 128  V2.0,  AND  RETURN
  469.          YOU TO THE COMPUTER'S SYSTEM LEVEL.
  470.  
  471.          ╘HE FIRST PROMPT YOU WILL SEE IS "┴RE  YOU  SURE?".   ╔F  YOU
  472.          CHOSE THIS OPTION ACCIDENTALLY, OR CHANGED  YOUR  MIND,  JUST
  473.          HIT ╬, AND YOU WILL BE RETURNED TO THE MAIN MENU.
  474.  
  475.          ╔F YOU HIT ┘, YOU WILL THEN BE ASKED IF YOU WISH TO  EXIT  TO
  476.          128 OR 64 MODE.  ╨RESS 6 FOR 64 MODE, OR 1 FOR 128 MODE,  AND
  477.          ╠IST ╨ROTECTOR 128 WILL DISSOLVE.
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 8
  528.  
  529.     ╠IST ╨ROTECTOR 128 V2.0     ╧CTOBER 8 1987             ╠ONNIE ─E ├LOEDT
  530.  
  531.          ╘HAT JUST ABOUT COVERS IT.  ╔ HOPE YOU LIKE THIS PROGRAM  AND
  532.          FIND IT USEFUL.  ╔'D APPRECIATE ANY COMMENTS YOU HAVE.
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.          ╘&╙ ╙OFTWARE ─EVELOPMENT                               ╨AGE 9
  594.  
  595.