home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / c128 / c148.d64 / arcdocs2.cbm < prev    next >
Text File  |  1995-08-09  |  13KB  |  333 lines
  1.  
  2.  ┴╥├ ─OCS
  3.  (╨ART 2/2)
  4.  
  5.  
  6.         ╞ILE ┴╥├HIVE ╒TILITY...........
  7.  
  8.  ┬Y ITSELF ┴╥├ JUST PRINTS A SUMMARY OF THE COMMAND SYNTAX FOR ┴╥├. 
  9.  
  10.  
  11.  
  12.  ├REATE NEW ┴RCHIVE............. 
  13.  
  14.    ARC/C      D:ARCFILE[.ARC] S:PATTERN S:PATTERN .....
  15.    ARC/C/S    D:ARCFILE[.ARC] S:PATTERN S:PATTERN .....
  16.    ARC/C/GZZZ D:ARCFILE[.ARC] S:PATTERN S:PATTERN .....
  17.  
  18.  ├REATES AN ARCHIVE ON DRIVE D: NAMED ARCFILE.ARC. ┴S MANY AS EIGHT PATTERNS
  19.  MAY BE GIVEN. /S AND /G ARE OPTIONAL. ╙OME EXAMPLES ARE:
  20.  
  21.  ARC/C A:SQ B:SQ.* B:USQ.* 
  22.  - CREATES AN ARCHIVE NAMED SQ.ARC ON DRIVE A WHICH INCLUDES ALL FILES FROM 
  23.    DRIVE B WHOSE NAMES BEGIN WITH SQ. OR USQ.
  24.  
  25.  ARC/C/S A:TEST.ARC F:*   
  26.  - ARCHIVE ALL FILES FROM DRIVE 10,1 TO TEST.ARC ON DRIVE 8,0 AND SUPPRESS 
  27.    COMPRESSION. (STORE ONLY)     
  28.  
  29.  ARC/C SEQ B:*=S
  30.  - ARCHIVES ALL SEQUENTIAL FILES ON DRIVE B TO SEQ.ARC ON THE DEFAULT DRIVE.
  31.  
  32.  ARC/C/GRALPH G:SECRET A:MSSG      
  33.  - ARCHIVES THE FILE MSSG ON DRIVE 8,0 TO AN ARCHIVE SECRET.ARC ON DRIVE 11,0.
  34.    THE FILE IS ENCRYPTED USING THE PASSWORD RALPH 
  35.  
  36.  
  37.  
  38.         ┴PPEND TO ┼XISTING ┴RCHIVE..... 
  39.  
  40.  ARC/A/S D:ARCHFILE[.ARC] S:PATTERN S:PATTERN ....
  41.  
  42.  ┼XACTLY THE SAME AS ARC/C ETC. EXCEPT THAT THE ARCHFILE IS APPENDED TO. ╔F THE
  43.  ARCFILE DOES NOT EXIST, A FILE NOT FOUND MESSAGE IS ISSUED AND THE PROGRAM
  44.  ABORTS. ╙OMETIMES THE NUMBER OF BLOCKS DISPLAYED ON A DIRECTORY LISTING DOES 
  45.  NOT AGREE WITH ┴╥├ AFTER AN APPEND. ╘HIS IS A BUG IN COMMODORE ─╧╙, AND SHOULD
  46.  BE HARMLESS.
  47.  
  48.  
  49.  
  50.         ┼XTRACT ╞ILES FROM AN ┴RCHIVE.. 
  51.  
  52.  ARC/X[/D]    <[D:]ARCHFILE[.ARC]> [PATTERN1] [PATTERN2] ...
  53.  ARC/X[/GZZZ] <[D:]ARCHFILE[.ARC]> [PATTERN1] [PATTERN2] ...
  54.  
  55.  ╘HIS COMMAND IS USED TO EXTRACT FILES FROM AN ARCHIVE. ╔F NO PATTERNS ARE 
  56.  SPECIFIED, THEN ┴╥├ WILL EXTRACT ALL FILES FROM THE ARCHIVE. ╙OME EXAMPLES:
  57.  
  58.  ARC/X A:SQ
  59.  - EXTRACTS ALL FILES FROM SQ.ARC ON DRIVE 8,0 AND PUTS THEM ON THE DEFAULT 
  60.    DIRECTORY.
  61.  
  62.  ARC/X A:SQ *
  63.  - SAME AS THE ABOVE
  64.  
  65.  ARC/X/F B:TEMP.ARC       
  66.  - EXTRACTS ALL FILES FROM TEMP.ARC ON DRIVE 8,1 AND PUTS THEM ON THE DISKETTE
  67.    IN DRIVE F: (10,1)
  68.  
  69.  ARC/X/GRALPH F:SECRET 
  70.  - EXTRACTS THE FILES IN AN ARCHIVE WHICH HAS BEEN ENCRYPTED WITH THE PASSWORD
  71.    RALPH, AND PLACES THEM ON THE DEFAULT DIRECTORY.
  72.  
  73.  ARC/E C:BOOK030386 CHAPTER1   
  74.  - EXTRACTS ONLY THE FILE 'CHAPTER1'  FROM THE ARCHIVE 'BOOK030386' ON  DRIVE 
  75.    C:
  76.  
  77.  ╬╧╘┼:  ARC/X AND ARC/E ARE SYNONYMS
  78.  
  79.  
  80.  
  81.         ─ISPLAY ┴RCHIVE ├ONTENTS....... 
  82.   
  83.  ARC/L <[D:]ARCHNAME[.ARC]>
  84.  
  85.  ╘HIS IS USED TO GET A LISTING OF THE FILES IN AN ARCHIVE. ╘HE LISTING WILL 
  86.  DISPLAY THE FILENAME, FILETYPE, UNSQUEEZED AND SQUEEZED LENGTHS (IN DISK 
  87.  BLOCKS), AND THE COMPRESSION METHOD USED. ╙OME EXAMPLE: 
  88.  
  89.  ARC/L B:SQ
  90.  - GIVES A LISTING OF THE FILES IN THE ARCHIVE SQ.ARC ON UNIT 8,1 
  91.  
  92.  
  93.  
  94.         ╘YPE ╞ILE IN AN ┴RCHIVE........
  95.  
  96.  ARC/P[/GZZZ] <[D:]ARCHNAME[.ARC]> [[PATTERN1] [PATTERN2]...]
  97.  
  98.  ╘HIS IS USED TO PRINT THE SPECIFIED FILES IN AN ARCHIVE TO THE SCREEN. ┘OU CAN
  99.  PAUSE THE PRINTING WITH THE ╙╚╔╞╘ KEY, AND ABORT WITH ╥╒╬/╙╘╧╨
  100.  
  101.  
  102.  
  103.         ╓ERIFY ┴RCHIVE.................
  104.  
  105.  ARC/V <[D:]ARCHNAME[.ARC]> [[PATTERN1] [PATTERN2]...]
  106.  
  107.  ╘HIS IS USED TO VERIFY THE CONTENTS OF AN ARCHIVE. ┴╥├ CALCULATES A TWO BYTE 
  108.  CHECKSUM FOR EACH FILE IN AN ARCHIVE. ╫HEN YOU VERIFY AN ARCHIVE, ┴╥├ 
  109.  CALCULATES A NEW CHECKSUM AND COMPARES IT WITH THE CHECKSUM STORED WHEN THE 
  110.  FILE WAS ARCHIVED. ╔F THEY DO NOT MATCH, AN ERROR MESSAGE IS DISPLAYED 
  111.  INDICATING THAT THE ARCHIVE MAY NOT UN-COMPRESS PROPERLY. ╬OTE: IF YOU HAVE 
  112.  USED A PASSWORD WHEN CREATING THE ARCHIVE YOU NEED NOT SPECIFY IT SINCE THE 
  113.  ENCRYPTED BYTES ARE USED IN CALCULATING THE CHECKSUM. ┼XAMPLE:
  114.  
  115.  ARC/V B:USQ.ARC               - VERIFIES USQ.ARC ON UNIT 8,1
  116.  ARC/V B:USQ USQ.LB            - VERIFIES ONLY THE FILE 'USQ.LB' IN THE ARCHIVE
  117.                                  'USQ.ARC', AND SKIPS OVER ANY OTHER FILES.
  118.  
  119.         
  120.  
  121.         ╙YSTEM ═EMORY ═AP..................
  122.  
  123.  
  124.  
  125.  $033C-$03FF        - CASSETTE BUFFER. USED BY ┴╥├
  126.  $0801-$4000        - NOT USED
  127.  $4000-$7FFF        - WORKSPACE FOR ┴╥├ AND ═╧╓┼ COMMANDS ONLY.
  128.                       ALL OTHER COMMANDS LEAVE THIS AREA ALONE.
  129.  $8000-$8FFF        - USED IN 80 COLUMN VERSION. (╥╧═)
  130.  $9000-$97FF        - NOT USED 
  131.  $9800-$9FFF        - 80 COLUMN SCREEN. NOT USED IN 40 COLUMN ┴╥├ 
  132.  $A000-$BFFF        - PROGRAM AREA 
  133.  $C000-$CFFF        - PROGRAM AREA. (SYS 12*4096 TO ENABLE ┴╥├
  134.                       AFTER A KILL)
  135.  $D000-$FFFF        - NOT PRESENTLY USED BY ┴╥├
  136.  
  137.  
  138.  
  139.         ┴ ┬╔╘ OF ╘HEORY....................
  140.  
  141.      ╥UN-╠ENGTH ┼NCODING............ ┴LL METHODS OF DATA COMPRESSION TAKE 
  142.  ADVANTAGE OF REDUNDANCY OF ONE FORM OR ANOTHER. ╥UN-LENGTH CODING IS ONE OF 
  143.  THE SIMPLEST, AND  OFTEN THE MOST EFFECTIVE TECHNIQUES.  ╟RAPHICS FILES MAY 
  144.  OFTEN CONTAIN LONG SEQUENCES OF THE SAME BYTE. ┌EROS FOR BLANK SPACE, OR 255'S
  145.  FOR FILLED IN SPACE. ╥UN-LENGTH CODING RECODES  THESE LONG  SEQUENCES AS 
  146.  SHORTER CONTROL SEQUENCES. ╞OR EXAMPLE, A GRAPHICAL IMAGE  STORED IN ╥┴═  MAY
  147.  LOOK SOMETHING LIKE THE FOLLOWING IF VIEWED WITH THE MACHINE LANGUAGE MONITOR:
  148.  
  149.  
  150.       .:2000 00 00 00 00 00 00 00 00
  151.       .:2008 00 00 FF FF FF FF FF 00
  152.       .:2010 00 00 00 00 00 00 00 00
  153.       .:2018 A0 0B FF FF FF FF FF FF
  154.  AND SO ON....
  155.  
  156.     ╘HIS COULD BE STORED ON DISK AS THE SEQUENCE:
  157.  
  158.    00 00 0A 00 FF 05 00 00 09 A0 0B 00 FF 06 
  159.  
  160.   ╘HE FIRST ZERO IS A CONTROL CHARACTER. ╫HEN THE UNSQUEEZE ROUTINE ENCOUNTERS
  161.  A ZERO IT GETS THE NEXT TWO CHARACTERS AND  INTERPRETS THEM AS A CHARACTER 
  162.  IDENTIFIER AND A COUNT. ╘HUS THE FIRST 3 BYTE SEQUENCE IS INTERPRETED AS 10 
  163.  ZEROS, THE NEXT 3 BYTE SEQUENCE  AS 5 FF'S AND SO ON.  ╫HEN A CHARACTER IS NOT
  164.  REPEATED, IT IS SIMPLY CODED DIRECTLY TO THE OUTPUT FILE. (THE $A0 AT $2018 
  165.  ABOVE) ┴ND SO THE ABOVE IS  SQUEEZED FROM  32 BYTES DOWN TO 14. 
  166.  
  167.   ╘HERE IS ONE SLIGHT PROBLEM WITH THIS METHOD. ╙UPPOSE YOU ARE USING  A ZERO-
  168.  BYTE AS THE CONTROL CHARACTER. ╔F A SEQUENCE OF ONLY ONE ZERO IS ENCOUNTERD, 
  169.  YOU CANNOT CODE IT TO THE OUTPUT FILE SINCE IT WILL BE INTERPRETED AS A 
  170.  CONTROL CHARACTER. ┘OU MUST SEND A THREE BYTE CONTROL SEQUENCE TO CODE THE 
  171.  SINGLE ZERO. ┴╥├ ATTEMPTS TO CIRCUMVENT THIS PROBLEM BY CHOOSING THE BYTE THAT
  172.  OCCURS LEAST OFTEN IN THE FILE AS THE CONTROL CHARACTER. ┴N EXAMPLE OF THIS 
  173.  WOULD BE AS FOLLOWS:
  174.  
  175.  
  176.       .:0801 06 08 01 00 8F 00 0C 08
  177.       .:0809 02 00 8F 00 12 08 03 00
  178.       .:0811 8F 00 00 00 00 00 00 00 
  179.   AND SO ON....
  180.  
  181.      ╘HIS WOULD BE STORED ON DISK AS THE SEQUENCE:
  182.  
  183.     06 08 01 00 00 01 8F 00 00 01 0C 08 02 00 00 01 
  184.     8F 00 00 01 12 08 03 00 00 01 8F 00 00 07 ..... 
  185.  
  186.    ╫E WENT FROM 24 BYTES TO 30! ╬OT MUCH OF A SAVINGS. 
  187.  
  188.  
  189.  
  190.         ╚UFFMAN ├ODING.................
  191.  
  192.  ╚UFFMAN CODING IS SOMEWHAT MORE COMPLEX. ╔T TAKES ADVANTAGE OF THE FACT THAT 
  193.  SOME CHARACTERS ARE USED MORE OFTEN THAN OTHERS IN  MOST FILES. ╘EXT FILES 
  194.  CONTAIN MANY SPACES, AND  VOWELS ARE  MUCH MORE ABUNDANT THAN  CONSONANTS. ╘HE
  195.  ╚UFFMAN ALGORITHM αCONVERTS FIXED LENGTH CODES (8 BIT CHARACTERS) INTO CODES 
  196.  WHOSE LENGTH IN BITS IS INVERSELY PROPORTIONAL TO THEIR PROBABILITY  OF 
  197.  OCCURANCE IN THE DATA FILE.   ╞OR EXAMPLE, SUPPOSE YOUR DATA FILE LOOKED 
  198.  SOMETHING  LIKE THIS:
  199.  
  200.    ABRACADABRA
  201.  
  202.  ╘HE CHARACTER FREQUENCY DISTRIBUTION IS AS FOLLOWS:
  203.                                         TOTAL BITS  TOTAL BITS
  204.       CHARACTER FREQUENCY  HUFFMAN CODE
  205.  UNSQUEEZED    SQUEEZED 
  206.       --------- ---------  ------------
  207.  ----------   ----------
  208.           A          5          0          8 * 5 = 40  1 * 5 = 5
  209.           B          2          10         8 * 2 = 16  2 * 2 = 4
  210.           R          2          111        8 * 2 = 16  3 * 2 = 6
  211.           C          1          1100       8 * 1 =  8  4 * 1 = 4
  212.           D          1          1101       8 * 1 =  8  4 * 1 = 4
  213.  ALL OTHERS          0
  214.  ----------   ----------                                            TOTALS:
  215.          88         23                                                           
  216.     ╫E COULD REPRESENT THIS INFORMATION AS A BINARY TREE: 
  217.  
  218.  
  219.                                        
  220.                               C        
  221.                             /          
  222.                  A    B   /---- D      
  223.                /    /   /