home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / canada-remote-systems / c128 / utils / sdir31.doc < prev    next >
Encoding:
Text File  |  2019-04-13  |  7.0 KB  |  166 lines
  1.                                  ╙─╔╥ 3.1
  2.  
  3.                    ┴N ┼NHANCED ╙CROLLING ─ISK ─IRECTORY
  4.  
  5.                                FOR THE ├-128
  6.  
  7.                       WITH A 1541, 1571 OR 1581 DRIVE
  8.  
  9.  
  10.                          <C> 1987   ═. ╟ARAMSZEGHY
  11.  
  12.                               67 ├ALLENDER ╙T
  13.                                ╘ORONTO, ╧NT
  14.                               ├ANADA  ═6╥ 2╚2
  15.  
  16.  
  17.                       <╟┼NIE ═AIL ┴DDRESS  ═╔╦╠╧╙.╟>
  18.  
  19.  
  20.  
  21. ╘HE ├-128'S ─╔╥┼├╘╧╥┘ OR ├┴╘┴╠╧╟ COMMAND IS A VAST IMPROVEMENT OVER THE 
  22. ├-64'S ╠╧┴─"$",8 TYPE OF DIRECTORY.  ╚OWEVER, IT STILL HAS SOME VERY 
  23. SERIOUS LIMITATIONS.  ╘HESE INCLUDE THE INABILITY TO OBTAIN A HARD COPY OF 
  24. THE DIRECTORY WITHOUT RESORTING TO THE ╠╧┴─"$",8 METHOD, THE INABILITY TO 
  25. SCROLL THE LIST, AND THE CUMBERSOME TECHNIQUES REQUIRED TO ╠╧┴─ A PROGRAM 
  26. DIRECTLY FROM THE DISPLAYED LIST.  ╔F YOU WOULD LIKE TO BE ABLE TO DO THESE 
  27. THINGS AND MORE, THEN THIS LITTLE UTILITY IS FOR YOU.  
  28.  
  29. ╙─╔╥ 3.1 IS A MEMORY RESIDENT EXTENDED DIRECTORY UTILITY FOR THE ├-128 (IN 
  30. 80 COLUMN MODE) WITH A 1541, 1571 OR 1581 DISK DRIVE.  ╔T PROVIDES FULL 
  31. FORWARD AND REVERSE SCROLLING CAPABILITIES FOR A DIRECTORY LISTING AS WELL 
  32. AS THE ABILITY TO PROVIDE A HARD COPY OF THE DIRECTORY VIA AN ┼PSON 
  33. COMPATIBLE PRINTER; SCRATCH FILES; LOAD A ╨╥╟ FILE;  DISPLAY OR MERGE A ╙┼╤ 
  34. FILE; AND CHANGE 1581 DIRECTORY PARTITIONS, ALL DIRECTLY FROM THE DISPLAYED 
  35. LIST.
  36.  
  37. ╘HE MACHINE LANGUAGE PORTION OF ╙─╔╥ OCCUPIES ┬┴╬╦ 0 ╥┴═ BEGINNING AT $1300 
  38. (DECIMAL 4864).  ┬┴╬╦ 0 ╥┴═ FROM $C000 UPWARDS IS USED AS THE DIRECTORY 
  39. BUFFER.  $0┬00 TO $0─╞╞ (CASSETTE AND ╥╙-232 BUFFERS) AND $╞┴ TO $╞╞ 
  40. (UNUSED ZERO PAGE SPACE) ARE ALSO USED AS TEMPORARY BUFFERS AND POINTERS 
  41. FOR VARIOUS ITEMS.  ╘HESE AREAS ARE ERASED AND SET UP EACH TIME ╙─╔╥ IS 
  42. ACTIVATED.  
  43.  
  44. ╘O PREVENT ┬┴╙╔├ TEXT CODE FROM OVER-WRITING THE MACHINE LANGUAGE PORTION, 
  45. THE START UP ROUTINE RESETS THE TOP OF ┬┴╙╔├ TEXT LIMIT POINTER TO $BF00.  
  46. ╘HIS GIVES OVER 40 ╦ BYTES OF MEMORY AVAILABLE TO ┬┴╙╔├ FOR STORING 
  47. PROGRAMS AND IS MORE THAN ADEQUATE FOR EVEN THE LONGEST OF PROGRAMS.  
  48. (╥EMEMBER THAT ON THE ├-128 VARIABLES ARE STORED IN ┬┴╬╦ 1, AND DO NOT TAKE 
  49. UP ROOM IN THE ┬┴╙╔├ WORK SPACE).  ╘HE START UP ROUTINE FOR ╙─╔╥ ALSO 
  50. REDEFINES THE <╞3> KEY TO POINT TO THE MAIN ╙─╔╥ ROUTINE RATHER THAN THE 
  51. NORMAL ─╔╥┼├╘╧╥┘ COMMAND.  
  52.  
  53.  
  54. ╘O START ╙─╔╥, THE FOLLOWING COMMAND IS USED:
  55.  
  56.  
  57.   ┬╧╧╘"╙─╔╥31" <RETURN>
  58.  
  59. ASSUMING THAT THE ┬╧╧╘ MODULE IS SAVED UNDER THE NAME OF "╙─╔╥31".  
  60. ┴LTERNATIVELY, ╙─╔╥ CAN BE ACTIVATED FROM THE 1541 WITH:
  61.  
  62.    ┬╠╧┴─ "╙─╔╥31":╙┘╙ 4864
  63.  
  64. ╧NCE IN MEMORY, THE MACHINE LANGUAGE PORTION OF ╙─╔╥ WILL REMAIN ACTIVE 
  65. UNTIL A HARD RESET IS PERFORMED ON THE COMPUTER.  ╔F IT BECOMES DEACTIVATED 
  66. AT ANY TIME BECAUSE THE FUNCTION KEYS GET REDEFINED, ╙─╔╥ CAN BE RESTARTED 
  67. WITH REBOOTING BY THE COMMAND:
  68.  
  69.   ╙┘╙ 4864
  70.  
  71. ╘O USE ╙─╔╥, PUT THE DISK INTO YOUR DRIVE AND PRESS THE <╞3> KEY.  (╘HE 
  72. <╞3> KEY WAS CHOSEN FOR THIS TASK BECAUSE ITS DEFAULT DEFINITION IN ┬┴╙╔├ 
  73. 7.0 IS ─╔╥┼├╘╧╥┘).  
  74.  
  75. ╘HE ├-128 WILL RESPOND WITH:
  76.  
  77.   ╙┘╙ 4867,8
  78.  
  79. ╘HE CURSOR WILL BE OVER THE 8.  ╘HIS IS THE DEFAULT DEVICE NUMBER.  ╔F YOUR 
  80. WISH TO VIEW THE DIRECTORY OF ANOTHER DEVICE, TYPE IN THE CORRECT DEVICE 
  81. NUMBER.
  82.  
  83. ╔F YOU WISH TO VIEW ALL OF THE FILES ON THE DISK, SIMPLY PRESS <RETURN> 
  84. NEXT.  ╔F YOU WANT TO VIEW A PATTERN MATCH DIRECTORY, YOU CAN TYPE IN A 
  85. COLON FOLLOWED BY THE PATTERN TO BE USED, IN QUOTES. ╞OR EXAMPLE:
  86.  
  87.   ╙┘╙ 4867,10:"─┴╘┴*=S"
  88.  
  89. WILL LIST ALL OF THE ╙┼╤UENTIAL FILES ON DEVICE 10 THAT BEGIN WITH THE FOUR 
  90. CHARACTER PATTERN "─┴╘┴".  ┴NY LEGAL ─╧╙ PATTERN CAN BE USED, INCLUDING THE 
  91. ADVANCED PATTERN MATCHING AVAILABLE ON THE 1581 (USING A 1581 OF COURSE).
  92.  
  93. ╙─╔╥ CAN ALSO BE ACCESSED DIRECTLY WITHOUT USING THE <╞3> KEY OR FROM 
  94. WITHIN YOUR OWN PROGRAMS WITH:
  95.  
  96.   ╙┘╙ 4867,<DEVICE#>:"<PATTERN>"
  97.  
  98. ┴FTER A FEW SECONDS, THE DISK DIRECTORY WILL BE PRINTED ON THE 80 COLUMN 
  99. SCREEN ALONG WITH A MENU.  ╘HE DIRECTORY TAKES THE FLLOWING FORMAT:
  100.  
  101.   FILENAME   TYPE  SIZE
  102.  
  103. ╘HE TYPE WILL BE ONE OF ╨╥╟, ╒╙╥, ╥┼╠, ╙┼╤ OR ├┬═ (1581 ONLY).   ╠OCKED "<" 
  104. AND SPLAT "*" STATUS ARE ALSO INDICATED.  ╘HE FILE SIZE IS GIVEN IN BLOCKS.  
  105. ╘HE DISK NAME, NUMBER OF BLOCKS FREE AND NUMBER OF FILES LISTED IS ALSO 
  106. DISPLAYED.  
  107.  
  108. ╘HE FOLLOWING OPTIONS ARE POSSIBLE FROM THE MENU:
  109.  
  110. - USE THE <CURSOR UP> AND <CURSOR DOWN> KEYS TO SCROLL THROUGH THE 
  111. DISPLAYED LIST.  ╘HE CURRENTLY SELECTED FILE WILL BE HIGHLIGHTED IN REVERSE 
  112. VIDEO.
  113.  
  114. - THE <HOME> KEY WILL TAKE YOU BACK TO THE TOP OF THE LIST.
  115.  
  116. - THE <ESC> KEY WILL CLEAR THE SCREEN AND GO BACK TO ┬┴╙╔├.
  117.  
  118. - THE ├= P  KEY COMBINATION (I.E. HOLD DOWN THE ├OMMODORE LOGO KEY AT THE 
  119. LOWER LEFT CORNER OF THE KEYBOARD AND THE "P" KEY SIMULTANEOUSLY) WILL GIVE 
  120. A HARD COPY OF THE ENTIRE DIRECTORY ON A PRINTER (┼PSON COMPATIBLE USING 
  121. ├╚╥$(15) FOR COMPRESSED PRINT AND ├╚╥$(18) TO CANCEL COMPRESSED PRINT, 
  122. DEVICE 4) AND RETURN TO THE ╙─╔╥ MENU. ╘HE DIRECTORY WILL BE PRINTED 3 
  123. COLUMNS WIDE.
  124.  
  125.  
  126. - THE <RETURN> KEY HAS THREE FUNCTIONS, DEPENDING ON THE FILE TYPE.  ╞OR 
  127. ╨╥╟ FILES, IT ACTS LIKE A ┬╠╧┴─ COMMAND AND WILL AUTOMATICALLY LOAD THE 
  128. HIGHLIGHTED FILE.  ╔T ACTS LIKE ┬╠╧┴─, SO WITH ┬┴╙╔├ PROGRAMS, MAKE SURE 
  129. THAT THE GRAPHICS SCREEN ALLOCATION STATE IS THE SAME AS WHEN THE PROGRAM 
  130. WAS SAVED.  (╔F YOU ┬╠╧┴─ A ┬┴╙╔├ PROGRAM THAT WAS SAVED WHEN THE GRAPHICS 
  131. SCREEN WAS ALLOCATED, IT COMES FROM A START OF ┬┴╙╔├ ADDRESS OF $4000, 
  132. RATHER THAN THE NORMAL START OF ┬┴╙╔├ ADDRESS OF $1├00).  ╞OR A 1581 ├┬═ 
  133. DIRECTORY PARTITION FILE, IT WILL SWITCH THE CURRENT PARTITION TO THE 
  134. SELECTED FILE.  ╞OR OTHER FILE TYPES, <RETURN> WILL DISPLAY THE CONTENTS OF 
  135. THE FILE ON THE SCREEN THEN RETURN TO THE ╙─╔╥ MENU.  ╘HIS WILL NOT AFFECT 
  136. ANY ┬┴╙╔├ PROGRAM THAT MAY BE IN MEMORY. ╨RESS THE <RUN/STOP> KEY TO ABORT 
  137. A FILE DISPLAY IF YOU DECIDE THAT YOU DO NOT WANT TO VIEW THE ENTIRE FILE.  
  138. ╘HE <NO SCROLL> KEY WILL PAUSE THE DISPLAY MOMENTARILY UNTIL ANOTHER KEY IS 
  139. PRESSES.
  140.  
  141. - THE KEY COMBINATION ├= M WILL CAUSE A ╙┼╤ PROGRAM FILE LISTING TO BE 
  142. ═┼╥╟┼D WITH ANY ┬┴╙╔├ PROGRAM CURRENTLY IN MEMORY. ┴ LISTING CAN BE CREATED 
  143. WITH THE SIMPLE COMMAND SEQUENCE:
  144.  
  145.    ╧╨┼╬ 8,8,8,"╨╥╧╟╥┴═.╠╔╙╘,╙,╫":├═─ 8:╠╔╙╘
  146.    ╨╥╔╬╘#8:├╠╧╙┼8
  147.  
  148. ┴ ╙┼╤ PROGRAM LISTING IS ALSO SOMETIMES USED FOR DOWNLOADING FILES FROM 
  149. BULLETIN BOARD SYSTEMS.  ╘HE ├= M COMMAND WILL AUTOMATICALLY RE-CRUNCH THE 
  150. FILE INTO ╨╥╟ FORMAT.  ┴FTER THE ═┼╥╟┼ HAS BEEN COMPLETED (USUALLY BY THE 
  151. PRINTING OF AN ╧╒╘ ╧╞ ─┴╘┴ ERROR ON THE SCREEN), YOU MUST TYPE IN ├╠╧╙┼#1 
  152. TO CLOSE THE DISK FILE.  (╘HE ╧╒╘ ╧╞ ─┴╘┴ ERROR IS CAUSED BY THE "╥┼┴─┘." 
  153. MESSAGE WHICH IS INCLUDED AT THE END OF EVERY ├OMMODORE ┬┴╙╔├ LISTING.  ╘HE 
  154. COMPUTER INTERPRETS THIS AS ╥┼┴─ ┘.  ╙INCE NO ─┴╘┴ STATEMENTS ARE INCLUDE, 
  155. YOU GET THE ╧╒╘ ╧╞ ─┴╘┴ MESSAGE).
  156.  
  157. - THE KEY COMBINATION ├= R WILL RETURN A 1581 TO ITS ROOT DIRECTORY 
  158. PARTITION AND INITIALIZE THE DRIVE.  ╞OR 1541 OR 1571 DRIVES, IT JUST 
  159. INITIALIZES THE DRIVE ("╔0").
  160.  
  161. - THE ├= S KEY COMBINATION WILL SCRATCH THE SELECTED FILE.  ┬E CAREFUL WHEN 
  162. YOU USE THIS, BECAUSE ┘╧╒ ┴╥┼ ╬╧╘ ╨╥╧═╨╘┼─ ╘╧ ├╧╬╞╔╥═ ┘╧╒╥ ╥┼╤╒┼╙╘ ╘╧ 
  163. ─┼╠┼╘┼ ╘╚┼ ╞╔╠┼!!!  ┴FTER DELETION, ╙─╔╥ WILL RE-READ THE DIRECTORY.
  164.  
  165.  
  166.