home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128Toolkit / MSD-DU07.ARC / DISALL.2.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  6.3 KB  |  96 lines

  1. Ç*NB"DISALL.2.DOC"
  2. Ç*LM5:RM75:VP2:SP0
  3. Ç*HD2:╥.╤UIRING,12/21/85,─╔╙┴╠╠.2 ─╧├╒═┼╬╘┴╘╔╧╬
  4. Ç*FT2:DISALL.2.DOC,-Ç#-,
  5. ─╔╙┴╠╠ IS WRITTEN IN ┬ASIC: IT IS SLOW!  ╠OAD AND RUN IS NORMAL.  ┼XIT IS WITH "╤" OR THE "STOP" KEY.  "╤" FOR QUIT IS RECOMMENDED TO STRIP OUT THE 256 BYTE SECTOR BUFFER AT ╓┴╥╘┴┬, IF YOU WANT TO SAVE THE PROGRAM AFTER RUNNING.  ╘O SAVE: ╠╔╙╘ LINE 1010 AND MOVE THE CURSOR UP AND WIPE OUT 1010 THEN ╥┼╘╒╥╬.
  6.  
  7. ╘HE ╔╬╔╘╔┴╠╔╙┼ TIME IS SPENT ╥┼┴─ING IN THE OPCODE VARS FROM DATA STATEMENTS.
  8.  
  9. ╘HE MENU SHOWS THE FUNCTIONS AVAILABLE WITH DEFAULT VALUES.  ╘YPE "═" TO GET THE STATE OF THE FUNCTIONS.
  10.  
  11. ╘YPE "╥┼╘╒╥╬" WITHOUT AN ENTRY TO START THE "╧╒╘╨╒╘" OF THE "╘┘╨┼" OF OPERATION. ╘HE FIRST BYTE WILL BE TAKEN FROM THE "╙╧╒╥├┼" AT THE "┬┼╟╔╬" ADDRESS.  ╧PERATION WILL TERMINATE AT THE "┼╬─" ADDRESS.  ╔F THE ADDRESS HAS BEEN "╬╧╥═┴╠╔┌┼─" THE OUTPUT WILL APPEAR TO BE FROM THE NORMALIZED ADDRESS.
  12.  
  13. ╘HE FUNCTIONS ARE CHANGED BY TYPING THE FIRST CHAR OF THE MAIN FUNCTION.  ╘HE COMPUTER FILLS OUT THE REMAINDER OF THE WORD.  ╘HEN TYPE THE FIRST CHAR OF THE SUB-FUNCTION DESIRED.  ╘HIS ACTION CHANGES THE STATE OF THE PROGRAM AND USUALLY DOES NOT RETURN YOU TO THE MENU.
  14.  
  15.  
  16. ╙OURCE: ╞ILE:
  17.  
  18. ╘HE SOURCE IS FROM THE TRACK AND SECTORS ASSIGNED TO THE FILENAME SELECTED.  ╘HE "┬┼╟╔╬" AND "┼╬─" ADDRESSES ARE INITIALIZED TO THE VALUES SAVED WITH THE FILE.  ┘OU MAY SELECT ANY ADDRESS WITHIN THIS RANGE.  ╘HE ADDRESS IS CONVERTED TO A TRACK AND SECTOR IN ORDER TO READ THE BLOCK FROM THE ─╧╙.  ╘HIS CONVERSION IS TRANSPARENT TO THE USER: CODE APPEARS TO COME FROM THE ADDRESS.  (╬O ERROR TRAPPING IS DONE ON VALUES OUTSIDE THIS RANGE AND RESULTS ARE UNKOWN.) ╘HE ADDRESS MAY BE "NORMALIZED" SO THAT DISASSEMBLY MAY APPEAR AS IF FROM A DIFFERENT ADDRESS.  SKIP AROUND ALL YOU WANT BUT BE PREPARED TO WAIT WHILE THE ─╧╙ HUNTS FOR THE PROPER TRACK & SECTOR.
  19.  
  20. ┘OU WILL GET A DIRECTORY OF THE FILES ON THE DISC WITH OTHER INFO NEEDED BY THE PROGRAM.  (─EATHLY SLOW)  ╘HE PROGRAM ─╔═ENSIONS VARIABLES TO HOLD THE NUMBER OF FILES FOUND IN THE DIRECTORY AND THE NUMBER OF SECTORS FOUND IN THE FILE.  ═OVE THE CURSOR UP AND PRESS "RETURN" TO SELECT THE FILE WANTED.  ┼SCAPE TO THE MENU WITH "╤" FOR FILE NAME.  ╨RESS "╥┼╘╒╥╬" WITH FILE "╬" TO CONTINUE THE DIRECTORY SEARCH.  ╧R, ENTER A FILENAME AND THE CORRECT TRK, SEC, AND BLK NUMBERS IF YOU KNOW THEM.  ╘HE FILENAME WILL APPEAR ON ALL OUTPUT FOR DOCUMENTATION.
  21.  
  22. ╔F A FILE HAS ALLREADY BEEN SELECTED PRIOR TO ENTRY AND THE NEW FILE HAS MORE SECTORS THAN THE PREVIOUS FILE THEN THE PROGRAM WILL REQUEST THAT YOU SELECT THE NEW FILE AGAIN AND THEN PROCEED TO CLEAR ALL VARS AND "╔╬╔╘╔┴╠╔┌┼".  ╘HIS IS DONE IN ORDER TO RE-─╔═ENSION THE SECTOR VARS.
  23.  
  24. ┴ TRACK AND SECTOR READ FUNCTION HAS BEEN TACKED ONTO THE FILE FUNCTION WHICH RESULTS IN SOME CONFUSION.  ┴NY SINGLE TRACK AND SECTOR MAY BE SELECTED WITHOUT ANY REFERENCE TO A FILE NAME.  ╙OME LOOSE ENDS NEED TYING UP.
  25.  
  26.  
  27. ╙OURCE: ├64:
  28.  
  29. ╘HE SOURCE IS FROM THE ├64 MEMORY.  ┴NY ADDRESS WITHIN THE 64╦ ADDRESS SPACE.
  30.  
  31.  
  32. ╙OURCE: 1541:
  33.  
  34. ╘HE SOURCE IS FROM THE ─╧╙ MEMORY WITHIN THE 1541.  ┴NY ADDRESS WITHIN THE 64╦ ADDRESS SPACE IS ALLOWED, BUT THERE IS MEMORY ONLY FROM 0000-07FF AND C000-FFFF.  ╘HE DISK CONTROL PORT IS AT 1C00-1C0F.  ╘HE SERIAL PORT IS AT 1800-180F.  ┴LL OTHER MEMORY IS A GHOST OF REAL MEMORY.
  35.  
  36.  
  37. ╧UTPUT: ╓IDEO:
  38.  
  39. ╠INES ARE LISTED TO THE SCREEN UNTIL THE SCREEN IS FULL.  ╠ISTING MAY BE HALTED AT ANY TIME BY PRESSING ANY KEY.
  40.  
  41.  
  42. ╧UTPUT:  ╨RINTER:
  43.  
  44. ╠INES ARE LISTED TO THE PRINTER UNTIL THE "┼╬─" ADDRESS IS FOUND.  ╘HE OUTPUT IS FORMATED INTO PAGES OF 66 LINES WITH A HEADER ON EACH PAGE.  ╠ISTING MAY BE HALTED AT ANY TIME WITH ANY KEY.  ╘HE LINE COUNTER IS NOT CHANGED BY THE HALT OR ANY FUNCTION EXCEPT "╘┘╨┼".
  45.  
  46.  
  47. ╧UTPUT:  ╞ILE:
  48.  
  49. ╠INES WILL BE WRITTEN TO A FILE ON THE 1541.  ╘HIS WORKS EVEN IF THE SOURCE IS A FILE OR THE 1541.  ╘HE FILENAME WILL BE MADE UP FROM A SOURCE CODE ("C" FOR ├64, "D" FOR 1541, "F" FOR FILE); THE TYPE OF OPERATION ("H" FOR HEX DUMP, "D" FOR DISASSEMBLY); THE BEGIN ADDRESS ($XXXX); AND THE END ADDRESS ($YYYY).  ╘HIS USUALLY CREATES A UNIQUE FILE.  ╔F NOT YOU WILL GET A DISK ERROR.  (┬UG - RED LIGHT FLASHES BUT PROGRAM IGNORES IT.)
  50.  
  51. ╘HE SCREEN IS FILLED WITH "╤" (╟RPHIC SYMBOL: SOLID CIRCLE) FOR EVERY LINE SENT.  ╘HE LISTING CAN BE HALTED AT ANY TIME WITH ANY KEY.  ╘HE FILE IS CLOSED WHEN THE OPERATION TERMINATES OR IS HALTED WITH ANY KEY.  ┴ NEW FILE WILL BE OPENED IF OPERATION IS RESUMED.
  52.  
  53.  
  54. ╘YPE:  ╚EX DUMP:
  55.  
  56. ╧UTPUT IS IN LINES OF EIGHT HEX BYTES FOLLOWED BY THE DISPLAYABLE CHAR FOR EACH BYTE.  ╨RINTER OUTPUT IS IN LINES OF 16 HEX BYTES.  ┴N ATTEMPT TO CONVERT NON PRINTABLE CODES TO CATCH POSSIBLE SCREEN CODES IS MADE.  ╘HIS MIGHT BE IMPROVED UPON.  "╘YPE" ALSO RESETS THE LINE COUNTER FOR PRINTER OUTPUT.
  57.  
  58. ╘YPE:  ─ISASSEMBLY:
  59.  
  60. ╧UTPUT IS IN LINES OF DISASSEMBLED CODE.
  61.     ╘HE FORMAT IS (ALL NUMBERS IN HEX):
  62.     ┴ FOUR BYTE ADDRESS
  63.     ╘HE OPCODE AT THE ADDRESS
  64.     ┴ ONE OR TWO BYTE OPERAND
  65.     ┴ SPACE FOR THE LABEL
  66.       (LABELS AND EQUATES ARE NOT IMPLEMENTED YET)
  67.     ╘HE MNEMONIC FOR THE OPCODE
  68.     ╘HE ADDRESS MODE
  69.  
  70. ┴NY KEY WILL HALT OUTPUT.  "┼╬╘┼╥" WILL RESUME OUTPUT.  "╘┘╨┼" IS THE ONLY FUNCTION THAT RESETS THE LINE COUNT FOR PRINTER OUTPUT.
  71.  
  72.  
  73. ┴DDRESS:  ┬EGIN:
  74.  
  75. ╔NPUT A HEXADECIMAL NUMBER OR "RETURN" TO ESCAPE.  ┴FTER ENTERING THE NUMBER PRESS "RETURN" TO GET A NEW LINE OR "SPACE" AND "┼" OR "╬" TO OBTAIN THOSE FUNCTIONS.
  76.  
  77. ┴DDRESS:  ┼ND:
  78.  
  79. ╔NPUT A HEXADECIMAL NUMBER OR "RETURN" TO ESCAPE.  ┴FTER THE NUMBER TRY "RETURN" OR "SPACE" AND "┬" OR "╬".
  80.  
  81. ┴DDRESS: ╬ORMALIZE:
  82.  
  83. ╨RESS "RETURN" TO CANCEL ANY PREVIOUS NORMALIZED ADDRESS.  ┼NTER A HEXADECIMAL NUMBER WHERE YOU WANT OUTPUT TO BEGIN.  ╧NLY THE OUTPUT LISTING ADDRESSES ARE AFFECTED!  ╧PCODES ARE STILL TAKEN FROM THE ORIGINAL "┬┼╟╔╬" ADDRESS.  ┬E CAREFUL THAT THE "┬┼╟╔╬" ADDRESS IS CORRECT.  ├HECK THE MENU TO BE SURE.
  84.  
  85. ╦EYBOARD BUFFER:
  86.  
  87. ╘HE KEYBOARD INPUT BUFFER IS ACTIVE AT ALL TIMES.  ┬EWARE OF TOUCHING THE KEYBOARD ACCIDENTALLY.
  88.  
  89. ╘HE PROGRAM IS IN ┬ASIC AND IS DEATHLY SLOW.  ╔T'S ONLY VIRTUE IS THAT IT WORKS.(THE IMPORTANT PARTS!)  ╨ROGRAMS OF ANY SIZE ON DISK MAY BE DISASSEMBLED IN PART OR IN WHOLE.  ╘HE OUTPUT MAY BE TO A PRINTER OR TO A DISK FILE FOR FUTURE USE.  ╔ PLAN TO CONVERT TO MACHINE LANGUAGE, BUT WHO CAN TELL WHEN!  ┬UG ANNOUNCEMENTS ARE APPRECIATED.  ┼SPECIALLY IF YOU SHOW HOW TO CORRECT THE BUG!
  90.  
  91.      ╙END TO:
  92.      ╥AY ╤UIRING
  93.      ╨.╧. ┬OX 135
  94.      ╦ERBY, ╧╥ 97531
  95.      (503) 592 4594
  96.