home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / ace-r6.sfx / ace-r6.doc.seq next >
Encoding:
Text File  |  1993-03-26  |  9.8 KB  |  228 lines
  1. ┴├┼-128/64  ╥ELEASE 6  [═ARCH 24, 1993].
  2.  
  3. ╘HIS RELEASE CONTAINS A SHELL WILDCARD EXPANSION FEATURE OVER THE PREVIOUS
  4. RELEASE PLUS A NUMBER OF MINOR IMPROVEMENTS PLUS A WORD COUNTING UTILITIY.
  5. ------------------------------------------------------------------------------
  6. ┴├┼ IS A PROGRAM FOR THE ├OMMODORE 128 AND ├OMMODORE 64 THAT PROVIDES A
  7. COMMAND SHELL ENVIRONMENT THAT IS SIMILAR TO THE ╒NIX'S.  ╔T IS STILL IN THE
  8. DEVELOPMENT STAGE, BUT ╔ THOUGHT ╔ WOULD RELEASE WHAT ╔ HAVE BEEN WORKING
  9. ON TO GET SOME PUBLIC REACTION.
  10.  
  11. ╘HE DISTRIBUTION CONSISTS OF SIX PROGRAMS:
  12.  
  13. ACE128   - THE ┴├┼ "KERNEL" FOR THE ├-128
  14. ACE64    - THE ┴├┼ "KERNEL" FOR THE ├-64
  15. SH       - THE COMMAND SHELL ITSELF
  16. CP       - A FILE COPIER PROGRAM
  17. RM       - A FILE SCRATCHER PROGRAM
  18. UUENCODE - A UUENCODER PROGRAM
  19. UUDECODE - A UUDECODER PROGRAM
  20. CRC32    - A CRC32 GENERATOR PROGRAM
  21. WC       - A WORD COUNTER PROGRAM
  22.  
  23. ╘HIS FILE CONTAINS THESE BINARY PROGRAMS IN A UUENCODED ARCHIVE FORMAT.  ╘HE
  24. UUDECODE PROGRAM INCLUDED HERE WILL DECODE THIS FORMAT OF ARCHIVE, BUT THAT IS
  25. PROBABLY OF NO USE TO YOU UNLESS YOU ARE ABLE TO ├ATCH 22.  ┘OU WILL HAVE TO
  26. USE THE UUDECODER ON YOUR ╒NIX SYSTEM OR USE "UUXFER" FOR THE ├64.  ┘OU WILL
  27. PROBABLY HAVE TO SPLIT THE UUARCHIVE UP INTO SEPARATE FILES FOR UUDECODING.
  28.  
  29. ╬OTE THAT THE "ACE128" AND "ACE64" PROGRAMS ARE FUNCTIONALLY IDENTICAL, EXCEPT
  30. THAT ONE IS SET UP FOR THE 128 AND THE OTHER FOR THE 64.  ╘HUS, ALL OF THE
  31. APPICATION BINARY PROGRAMS WILL WORK WITH EITHER "ACE128" OR "ACE64".  ╠╧┴─
  32. AND ╥╒╬ THE APPROPRIATE KERNEL PROGRAM TO START THE SYSTEM.
  33.  
  34. ╘HE ┬UDDY ASSEMBLER SOURCE CODE FILES ARE NOT INCLUDED HERE, BUT ╔ WILL ┼MAIL
  35. THEM TO ANYONE WHO ASKS FOR THEM.
  36. ------------------------------------------------------------------------------
  37. ╬OW FOR THE DOCUMENTATION ITSELF, WHAT THERE IS OF IT:
  38.  
  39. ╫HEN ┴├┼ STARTS, IT LOADS AND EXECUTES THE COMMAND SHELL, GIVES YOU A PROMPT
  40. AND WAITS FOR YOU TO GIVE IT A COMMAND.  ┴ COMMAND HAS THE FOLLOWING FORMAT:
  41.  
  42. PROGRAMNAME ARG1 ARG2 ... ARG╬
  43.  
  44. ╘HE PROGRAMNAME CAN BE ANY OF THE FOLLOWING BUILT-IN COMMANDS:
  45.  
  46. ECHO       - PRINT THE GIVEN ARGUMENTS TO STDOUT
  47. CLEAR      - CLEAR THE SCREEN
  48. CLS        - SAME AS "CLEAR"
  49. DIRECTORY  - CLEAR THE SCREEN AND GIVE A LONG-FORM DIRECTORY LISTING
  50. DIR        - SAME AS "DIRECTORY"
  51. D          - GIVE A LONG-FORM DIRECTORY LISTING
  52. LS         - GIVE A MULTI-COLUMN SHORT-FORM DIRECTORY LISTING
  53. CLSL       - COMBINATION OF "CLS" AND "LS"
  54. CD         - CHANGE THE CURRENT DIRECTORY
  55. G          - SAME AS "CD"
  56. CAT        - DISPLAY THE NAMED FILES TO STDOUT
  57. TYPE       - SAME AS "CAT"
  58. T          - SAME AS "CAT"
  59. EXIT       - EXIT FROM THE COMMAND SHELL BACK TO ┬┴╙╔├
  60. X          - SAME AS "EXIT"
  61. DOS        - GIVE A ├OMMODORE DOS COMMAND TO THE CURRENT DEVICE (╧╨┼╬1,DV,15..)
  62. PATH       - SET THE PATH TO SEARCH FOR SEARCHING FOR EXTERNAL PROGRAMS
  63. SH         - INVOKE THE SHELL AGAIN AS A SUB-SHELL
  64.  
  65. OR PROGRAMNAME CAN BE FOR ANY OF THE EXTERNAL PROGRAMS PROVIDED WITH THIS
  66. DISTRIBUTION.
  67.  
  68. ╘HE EXTERNAL PROGRAM ARGUMENTS ARE AS FOLLOWS:
  69.  
  70. CP       SOURCEFILE DESTFILE
  71.          FILE1 FILE2 ... FILE╬ DIRECTORYNAME
  72. RM       FILE1 FILE2 ... FILE╬
  73. UUENCODE FILE1 FILE2 ... FILE╬
  74. UUDECODE FILE1 FILE2 ... FILE╬
  75. CRC32    FILE1 FILE2 ... FILE╬
  76. WC       FILE1 FILE2 ... FILE╬
  77.  
  78. ╘HE UUENCODE PROGRAM SENDS ITS OUTPUT TO STDOUT, SO YOU WILL USUALLY WANT TO
  79. REDIRECT STDOUT TO A DISK FILE.
  80.  
  81. ╘HE UUDECODE PROGRAM WILL ACCEPT EITHER ╨ETSCII OR ┴SCII FILES AND IS ABLE TO
  82. EXTRACT MULTIPLE FILES FROM ONE INPUT FILE.  ┼XTRACTED FILES ARE PUT INTO ╨╥╟
  83. FILES.
  84. ------------------------------------------------------------------------------
  85. ╘HE THREE ╒NIX STANDARD FILES ARE SUPPORTED:
  86.  
  87. STDIN    - WHERE THE DEFAULT INPUT COMES FROM (USUALLY THE KEYBOARD)
  88. STDOUT   - WHERE THE DEFAULT OUTPUT GOES TO (USUALLY THE SCREEN)
  89. STDERR   - WHERE ERROR MESSAGES ARE SENT TO (USUALLY THE SCREEN)
  90.  
  91. ╘O TEMPORARALLY REDIRECT THESE STANDARD FILE STREAMS FOR THE EXECUTION OF
  92. A COMMAND, YOU CAN USE THE FOLLOWING INCANTATIONS ON A COMMAND LINE:
  93.  
  94. <INFILE     - REDIRECT STDIN - INPUT TAKEN FROM "INFILE"
  95. >OUTFILE    - REDIRECT STDOUT - OUTPUT PUT INTO FILE "OUTFILE"
  96. >>OUTFILE   - REDIRECT STDOUT - SAME AS ">" BUT THE OUTPUT IS APPENDED TO FILE
  97. >&ERRFILE   - REDIRECT STDERR - ERROR OUTPUT IS PUT INTO "ERRFILE"
  98. >>&ERRFILE  - REDIRECT STDERR - ERROR OUTPUT IS APPENDED TO FILE "ERRFILE"
  99. ------------------------------------------------------------------------------
  100. ╫HENEVER YOU SPECIFY A FILE, YOU USE A "PATHNAME".  ╨ATHNAMES HAVE THE
  101. FOLLOWING OPTIONAL PARTS:
  102.  
  103. [DEVICE:][RAMLINK-DIRECTORY:][FILENAME]
  104.  
  105. ─EVICE NAMES ARE AS FOLLOWS:
  106.  
  107. "0:"  - ├OMMODORE DEVICE #0 - THE KEYBOARD - INPUT ONLY
  108. "1:"  - ├OMMODORE DEVICE #1 - THE CASSETTE DRIVE - NEVER TRIED IT MYSELF
  109. "2:"  - ├OMMODORE DEVICE #2 - THE MODEM - NEVER TRIED IT MYSELF
  110. "3:"  - ├OMMODORE DEVICE #3 - THE SCREEN - OUTPUT ONLY
  111. "4:"  - ├OMMODORE DEVICE #4 - THE PRINTER - OUTPUT ONLY
  112. "A:"  - ├OMMODORE DEVICE #8 - A DISK DRIVE - INPUT/OUTPUT
  113. "B:"  - ├OMMODORE DEVICE #9 - A DISK DRIVE - IF YOU HAVE >1 DRIVE
  114. ...
  115. "W:"  - ├OMMODORE DEVICE #30 - THE HIGHEST SERIAL DEVICE, ASSUMED TO BE DISK
  116. ".:"  - THE "CURRENT" DISK DEVICE
  117.  
  118. ├═─ ╥AM╠INK (OR ├═─ ╚ARD─RIVE) DIRECTORY NAMES HAVE THE FOLLOWING FORMATS:
  119.  
  120. "//DIR/:"                - A SUBDIRECTORY OF THE ROOT DIRECTORY
  121. "/DIR/:"                 - A SUBDIRECTORY OF THE CURRENT DIRECTORY
  122. "//DIR/DIR/ ... /DIR/:"  - A SUB-PATH OF THE ROOT DIRECTORY
  123. "/DIR/DIR/ ... /DIR/:"   - A SUB-PATH OF THE CURRENT DIRECTORY
  124.  
  125. ┴ND FILENAMES HAVE THE USUAL ├OMMODORE FORMAT OF 1 TO 16 CHARACTERS.
  126.  
  127. ╘HUS, THE FOLLOWING ARE VALID PATHNAMES FOR FILES:
  128.  
  129. 0:                    - THE KEYBOARD FOR INPUT
  130. 4:                    - THE PRINTER FOR OUTPUT
  131. B:FILE1               - "FILE1" ON DISK DEVICE #9
  132. .:FILE1               - "FILE1" ON THE CURRENT DISK DEVICE
  133. FILE1                 - "FILE1" ON THE CURRENT DISK DEVICE
  134. /DIR1/FILE1           - "FILE1" IN THE ╥AM╠INK SUBDIRECTORY "DIR1"
  135. A://DIR1/DIR2/:FILE1  - "FILE1" IN THE ╥AM╠INK SUBDIR "//DIR1/DIR2", DEVICE #8
  136.  
  137. ┴ND THE FOLLOWING ARE VALID PATHNAMES FOR DIRECTORIES:
  138.  
  139. A:               - DISK DEVICE #8 CURRENT DIRECTORY
  140. .:               - CURRENT DISK DEVICE'S CURRENT DIRECTORY      
  141. .://DIR1/:       - "DIR1" OFF THE ROOT DIRECTORY OF THE CURRENT ╥AM╠INK DEVICE
  142. /DIR1/DIR2/:     - SUBDIRECTORY "/DIR1/DIR2" OF THE CURRENT ╥AM╠INK DEVICE
  143.  
  144. ╬OTE THAT A DIRECTORY NAME ALWAYS ENDS WITH A ":".
  145.  
  146. ╘O GENERATE AN ┼╧╞ FOR KEYBOARD INPUT, ENTER A QUOTATION CHARACTER FOLLOWED BY
  147. A ├ONTROL-─ AND ╥┼╘╒╥╬ ON A BLANK LINE.
  148.  
  149. ┘OU MAY APPEND A ",P" OR ",S" OR ",U" TO A FILENAME TO SPECIFY WHETHER A ╨╥╟,
  150. ╙┼╤, OR ╒╙╥ FILE SHOULD BE ACCESSED/CREATED.  ┬Y DEFAULT, ┴├┼ WILL CREATE ╙┼╤
  151. FILES.
  152. ------------------------------------------------------------------------------
  153. ┴RGUMENTS THAT CONTAIN SPACES MUST BE PUT INTO QUOTES.  ═ULTIPLE QUOTED STRINGS
  154. CAN BE PLACED SIDE-BY-SIDE TO PRODUCE A LONGER STRING.  ╘HE FOLLOWING ARE
  155. EXAMPLES OF VALID COMMAND SHELL ARGUMENTS:
  156.  
  157. HELLO                                  -  HELLO
  158. 'HELLO'                                -  HELLO
  159. "HELLO THERE"                          -  HELLO THERE
  160. 'HELLO THERE'                          -  HELLO THERE
  161. 'SHE SAID, "HOW'"'S THAT"'"'' TO ME.'  -  SHE SAID, "HOW'S THAT" TO ME.
  162.  
  163. ├OMMAND SHELL ARGUMENTS ARE SEPARATED BY SPACES OR TAB CHARACTERS.
  164. ------------------------------------------------------------------------------
  165. ╘HE "PATH" COMMAND SETS OR DISPLAYS THE CURRENT SEARCH PATHNAMES FOR EXTERNAL
  166. PROGRAMS.  ┬Y DEFAULT THE PATHS TO SEARCH ARE "A:" AND ".:".  "PATH" ALONE ON
  167. A COMMAND LINE DISPLAYS THE CURRENT SEARCH PATH, AND "PATH" FOLLOWED BY
  168. ARGUMENTS WILL SET THE SEARCH PATH TO THE FOLLOWING ARGUMENTS.
  169. ------------------------------------------------------------------------------
  170. ╒NIX-STYLE WILDCARD EXPANSION IS SUPPORTED.
  171.  
  172. ╫HEN YOU ENTER AN ARGUMENT WITH AN ASTERISK IN THE FILENAME COMPONENT OF THE
  173. PATHNAME, THE COMMAND SHELL WILL AUTOMATICALLY EXPAND THAT NAME INTO AN
  174. ARGUMENT FOR EACH FILE IN THE SPECIFIED DIRECTORY THAT MATCHES THAT PATTERN.
  175. ╘HE EXPANDED ARGUMENTS ARE THEN PASSED ONTO THE COMMAND YOU ARE INVOKING AS
  176. IF YOU HAD TYPED THEM ALL IN YOURSELF.  ╞OR EXAMPLE:
  177.  
  178. ┴╥╟╒═┼╬╘            ┼╪╨┴╬╙╔╧╬
  179. --------            ---------
  180. *                   FILE1 PROG1,P PROG2,P
  181. CH*                 CHESS,P CHINESE_CHECKERS,P
  182. *.BIN               MAIN.BIN,P DATA.BIN ANAGRAM.BIN
  183. A*N                 ANAGRAM.BIN AN ANOTHER_PLAN
  184. B:A*.BIN            B:MAIN.BIN,P B:DATA.BIN B:ANAGRAM.BIN
  185. C://GAMES/:A*.BIN   C://GAMES/:ACROBAT.BIN,P C://GAMES/:ACRODATA.BIN
  186.  
  187. ┘OU'LL NOTE THAT PROGRAM FILES ARE EXPANDED TO INCLUDE A ",P".  ╔F A PATTERN
  188. DOES NOT EXPAND TO ANYTHING, AN ERROR MESSAGE IS DISPLAYED AND THE SHELL
  189. COMMAND IS NOT EXECUTED.  ┘OU'LL HAVE TO CURSOR-UP AND CHANGE THE COMMAND.
  190. ┘OUR FILENAME PATTERN CAN INCLUDE ONLY ONE ASTERISK (ANYWHERE IN THE NAME).
  191.  
  192. ╙OME EXAMPLE USES OF WILDCARD EXPANSION WITH THE PROVIDED UTILITIES FOLLOW:
  193.  
  194. CP B:* A:
  195. CP //GAMES/C64/:CHESS*.BIN SOMEFILE B://GAMES/:
  196. WC *.ASM *.C
  197. ------------------------------------------------------------------------------
  198. ╞UTURE ENHANCEMENTS:
  199.  
  200. - ═AKE A RAMDISK FOR USE WITH ┴├┼.  ╥┴═─╧╙ IS NOT COMPATIBLE WITH ┴├┼-128.
  201. - ═ORE UTILITY PROGRAMS.
  202. - ═AKE AN AUTOEXEC.SH TYPE OF MECHANISM.
  203. ------------------------------------------------------------------------------
  204. ╘HE ├╥├32 VALUES FOR THE PROGRAMS ARE AS FOLLOWS:
  205.  
  206. CRC32 =  260422187 FOR "ACE128"
  207. CRC32 = 2401739925 FOR "ACE64"
  208. CRC32 =  620754443 FOR "CP"
  209. CRC32 = 3002521285 FOR "CRC32"
  210. CRC32 = 3048994318 FOR "RM"
  211. CRC32 = 1017837309 FOR "SH"
  212. CRC32 = 2770224985 FOR "UUDECODE"
  213. CRC32 =  136402251 FOR "UUENCODE"
  214. CRC32 = 2834093340 FOR "WC"
  215.  
  216. ╘O CHECK YOUR OWN CRC32'S, ENTER THE FOLLOWING COMMAND INTO ┴├┼:
  217.  
  218. CRC32 ACE128 ACE64 CP CRC32 RM SH UUDECODE UUENCODE WC
  219. ------------------------------------------------------------------------------
  220. ╔F YOU HAVE QUESTIONS, COMMENTS, OR SUGGESTIONS YOU CAN CONTACT ME AT THE
  221. FOLLOWING ADDRESS:
  222.  
  223. -├RAIG ┬RUCE
  224. CSBRUCE@NEUMANN.UWATERLOO.CA
  225. "╘HERE AIN'T NO POWER AROUND
  226.  ├AN KEEP A GOOD MAN DOWN!" - ╓AN ╚ALEN
  227. ------------------------------------------------------------------------------
  228.