home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / cs-dos.arc / CSARC.TXT < prev    next >
Encoding:
Text File  |  1990-03-24  |  5.1 KB  |  2 lines
  1. ---------------------------------------------------------------------
  2. COMMAND: ├╙┴╥├
  3.  
  4. SYNTAX:  ├╙┴╥├[/N] [D:]ARCHIVE[.ARC] PATTERN1 [PATTERN2 [PATTERN3 ...]]
  5.  
  6. PURPOSE: ├REATES ARCHIVES USING THE STANDARD ═╙-─╧╙ FORMAT AS USED ON
  7.          ╔┬═ ╨├/╪╘/┴╘ AND COMPATIBLES AS WELL AS ON THE ATARI ST AND ┴MIGA.
  8.  
  9. COMMENT: ╘HE /N SWITCH IS THERE TO SUPPRESS COMPRESSION. WHEN PRESENT ALL
  10.          FILES WILL BE "STORED" AND NO CRUNCHING WILL TAKE PLACE.
  11.  
  12.          ╔N ITS PRESENT FORM, ├╙┴╥├ WILL EITHER CRUNCH OR STORE ALL FILES
  13.          IN THE ARCHIVE. SQUEEZING AND PACKING ARE NOT IMPLEMENTED.
  14.          ╨KARC'S SQUASHING,ALTHOUGH ACTUALLY A BIT EASIER TO ACCOMPLISH THAN
  15.          CRUNCHING WILL NOT BE IMPLEMENTED DUE TO MEMORY LIMITATIONS.
  16.  
  17.          ├╙┴╥├ PLACES ONLY ONE RESTRICTION ON FILENAMES. THEY MUST BE LESS
  18.          THAN 12 CHARACTERS IN LENGTH. IT DOES CONVERT THE FILENAME TO
  19.          STANDARD ASCII BEFORE ARC'ING, BUT DOES NOT N]ECK TO SEE IF IT IS
  20.          INDEED A LEGAL ═╙-─╧╙ FILENAME. THAT IS YOUR RESPONSIBILITY.
  21.          ╞OR THOSE OF YOU NOT FAMILIAR WITH ═╙-─╧╙, FILENAMES MUST BE OF
  22.          THE FORM...
  23.    
  24.                       NAME.EXT
  25.  
  26.          WHERE "NAME" IS AT MOST 8 CHARACTERS, "EXT" IS AT MOST 3
  27.          CHARACTERS, AND NONE OF THE FOLLOWING CHARACTERS CAN APPEAR IN
  28.          EITHER "NAME" OR "EXT"...
  29.           
  30.              [ ] ; : < > ? * , . / + " BACK-SLASH OR SPACE
  31.  
  32.          TO PLAY IT SAFE, STICK WITH A-Z, 0-9, AND - ' $ # ( ) OR &
  33.  
  34.          ALSO, AVOID ANY ├┬═ GRAPHICS CHARACTERS AND WIERD THINGS LIKE
  35.          'HOME' OR 'CURSOR RIGHT' AND SO ON.
  36.  
  37.          ├╙┴╥├ USES ONLY STANDARD I/O (OPEN/CHRIN/CHROUT) AND SHOULD WORK
  38.          WITH ANY ├┬═ DRIVE.
  39.  
  40. ---------------------------------------------------------------------
  41. COMMAND: ├╙┴╥├1750
  42.  
  43. COMMENT: ├╙┴╥├1750 IS IDENTICAL IN SYNTAX AND PURPOSE TO ├╙┴╥├, BUT HAS
  44.          SOME ADVANTAGES. ╞IRST OF ALL, THERE IS AN ADDITIONAL SWITCH
  45.          /P WHICH TELLS ├╙┴╥├ TO PAUSE AFTER THE ARCHIVE HAS BEEN CREATED
  46.          TO ALLOW SINGLE DRIVE USERS TO SWITCH DISKS.
  47.  
  48.          ╙ECONDLY, ├╙┴╥├1750 USES BURST LOAD ROUTINES WHEN READING THE
  49.          FILES BEING ARCHIVED. ╘HIS ISN'T POSSIBLE WITH ├╙┴╥├ SINCE YOU
  50.          CANNOT HAVE A FILE OPEN FOR WRITE (THE ARCHIVE) AND USE BURST
  51.          LOAD AT THE SAME TIME.
  52.  
  53.          ╘HE ARCHIVE IS 'BUILT' INSIDE THE 1750 IN WHAT WOULD BE YOUR
  54.          CAPTURE BUFFER FOR TERM, SO MAKE SURE YOU FLUSH ANYTHING YOU
  55.          WANT TO SAVE BEFORE USING ├╙┴╥├1750. ┴LSO, MAKE SURE YOUR
  56.          CAPTURE BUFFER IS LARGE ENOUGH TO HOLD THE ARCHIVE, BECAUSE
  57.          YOU WON'T GET AN ERROR MESSAGE UNTIL THE CAPTURE BUFFER
  58.          OVERFLOWS AND YOU'LL HAVE TO START ALL OVER AGAIN.
  59.  
  60.          ╙INCE THE FILE IS ACTUALLY CRUNCHED DURING THE ANALYZE PHASE,
  61.          CRUNCHING IS IN EFFECT, DONE IN ONLY ONE PASS SO ├╙┴╥├1750 WILL
  62.          BE SIGNIFICANTLY FASTER THAN ├╙┴╥├.
  63.  
  64. ------------------------------------------------------------------------
  65. COMMAND: ├╙╪┴╥├
  66.  
  67. ╒SAGE:   CSXARC[/P] FILENAME
  68.  
  69. ╨URPOSE: ├╙╪┴╥├ DISSOLVES ═╙-─╧╙ FORMAT ARCHIVES. ╘HE ENTIRE ARCHIVE IS
  70.          ALWAYS DISSOLVED. ┼XTRACTED FILES ARE WRITTEN TO THE DEFAULT DRIVE.
  71.          ╘HE /P OPTION IS USED TO TYPE FILES TO THE SCREEN WITH ┴╙├╔╔ TO
  72.          ╨┼╘╙├╔╔ CONVERSION INSTEAD OF EXTRACTING THEM.
  73.  
  74. ------------------------------------------------------------------------
  75.  
  76. ADDITIONAL NOTES:
  77.  
  78.          ╒NFORTUNATELY, ═╙-─╧╙ ARCHIVES STORE AN END OF FILE MARKER AT
  79.          THE END OF THE ARCHIVE. IN ORDER TO APPEND TO AN ARCHIVE, IT
  80.          WOULD BE NESSESSARY TO TRUNCATE THE ARCHIVE BY TWO BYTES, WHICH
  81.          IS A RATHER AWKWARD THING TO DO UNDER ├┬═'S DOS. ├ONSEQUENTLY,
  82.          IT IS NOT POSSIBLE TO APPEND TO EXISTING ARCHIVES USING ├╙┴╥├.
  83.          ╘HE END OF FILE MARKER WOULD STILL BE THERE, AND ALTHOUGH
  84.          EVERYTHING APPEARS TO GO WELL, THE APPENDED FILES WOULD NOT BE
  85.          EXTRACTED BY WHATEVER PROGRAM DISSOLVES THE ARCHIVE.
  86.  
  87.          C128 MEMORY MAP FOR ├╙┴╥├:
  88.  
  89.          BANK 0    -  $1C01 - $2FFF      ├╙┴╥├/├╙┴╥├1750 PROGRAM AREA
  90.                       $7000 - $F000      CRUNCH STRING TABLES
  91.  
  92.          BANK 1    - (STREND) - (FRETOP) INPUT BUFFER
  93.  
  94.          THIS MEANS, IN OTHER WORDS, THAT ANYTHING YOU HAVE IN BANK 1
  95.          WILL BE SAFE, BUT ANYTHING IN BANK 0 ABOVE $1C00 WILL BE WIPED
  96.          OUT BY RUNNING ├╙┴╥├.
  97.  
  98.          1750 USAGE BY ├╙┴╥├1750:
  99.  
  100.          IF YOU LOOK AT THE AUTOEXEC FILE YOU'LL SEE A LINE LIKE...
  101.  
  102.                  POKE DEC("1BD0"),3*16+8
  103.  
  104.          ╘HIS TELLS ├╙┴╥├ THAT THE 1750 BANKS 3 THROUGH 7 ARE FREE TO
  105.          BE USED AS INPUT/OUTPUT BUFFER SPACE. BE SURE TO UPDATE THIS
  106.          LINE IF YOUR RAMDISK GROWS BEYOND THE DEFAULT 128K IN BANKS
  107.          0 AND 1 OTHERWISE ├╙┴╥├ MAY CLOBBER YOUR RAMDISK.
  108.  
  109.          ├╙┴╥├ WAS TESTED OUT AGAINST ╨╦┴╥├ VERSION 3.6 WHICH ╔ BELIEVE
  110.          IS COMPATIBLE WITH ╙┼┴'S ┴╥├ VERSION 5.10 ╔ HAVN'T BEEN KEEPING
  111.          TRACK OF WHAT ╙┼┴ HAS DONE WITH ┴╥├ AFTER THE ARCWARS COMMOTION,
  112.          BUT IF ┴╥├ HAS CHANGED, THIS PROGRAM IS BEHIND THE TIMES. ╔ HAVE
  113.          NO PLANS TO UPGRADE THIS PROGRAM TO THE CURRENT STATE OF AFFAIRS
  114.          AS IT APPEARS THAT ┴╥├ IS SLOWLY FADING AWAY IN THE SHADOWS OF
  115.          ╨╦┌╔╨ AND/OR ╠╚┴╥├.
  116.  
  117.  
  118.  
  119.