home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / compress / cpmunarj.ark / CPMUNARJ.DOC < prev    next >
Text File  |  1993-01-11  |  4KB  |  109 lines
  1.  
  2. CPMUNARJ v 1.0  An .ARJ file extractor for CP/M.
  3.  
  4. P.R. Hunt. November 1st, 1992
  5.  
  6. Acknowledgement.  Ideas for this program were gleaned  from  UNARJ.C  2.10
  7. by Robert K. Jung (C) 1991.
  8.  
  9. Conditions of use:    The  programs  and documentation in this package must 
  10. not be altered in any way.    In particular, the name  Robert  Jung, and my
  11. name must stay in tact in the programs  and  documentation.   I  accept  no   
  12. liability for any problems or claims arising from the use of this program.
  13.  
  14. This package must be distributed in its entirity.   Otherwise,  use  freely
  15. and distribute liberally!
  16.  
  17.  
  18. INTRODUCTION:
  19.  
  20. This program gives CP/M users access to the contents of  archives  produced
  21. by the ARJ archiver, by R.K. Jung.  The companion program, DARJ.COM,  gives
  22. a complete directory of the files stored in an .ARJ archive.
  23.  
  24. You need to be running a Z80 CP/M and have lots of TPA (about 53K or more).
  25. The decompression algorithms are quite memory hungry, in CP/M terms anyway,
  26. alone needing more than 39K.  For this reason, the program offers no  fancy
  27. displays or  other "bells and whistles".   If you have insufficient memory,
  28. the  program  will safely abort with a message.  This program  was compiled
  29. under CP/M Plus, but should run under CP/M 2.2.
  30.  
  31. As a first step, rename the program to something  workable,  for  your  own
  32. convenience.   (But please DON'T change any file names in  the distribution
  33. package.)
  34.  
  35.  
  36. COMMAND SUMMARY:
  37.  
  38. CPMUNARJ can be used in three ways:
  39.  
  40.     CPMUNARJ
  41.     CPMUNARJ <archive>
  42.     CPMUNARJ E <archive>
  43.  
  44. Entering just CPMUNARJ from the command line will result in a simple  usage
  45. message being displayed.  
  46.  
  47. The second command form just provides the names of files  in  the  archive.
  48. (DARJ, the ARJ Directory program, provides a  more  detailed listing of the
  49. archive contents.  See DARJ.COM and DARJ.DOC in the distribution library).
  50.  
  51. <archive> is the .ARJ archive file, which is of the form:
  52.  
  53.     [du:]filename[.arj]
  54.  
  55. Drive/user number designators may be optionally specified.  If a file  name
  56. extension is not given, the extension .ARJ will be assumed.  If the archive
  57. file actually has no file name extension, terminate the file  name  with  a
  58. full stop.  (Although, virtually all archive files have a .ARJ  extension.)
  59. The following are examples of valid archive file names:
  60.  
  61.     MYARJ.ARJ
  62.  
  63.     C1:MYARJ
  64.  
  65. The third command form extracts the contents of  the  ARJ  archive  to  the
  66. current drive and user by default.  You may optionally specify a  different
  67. drive/user to receive extracted files by  placing  a  drive/user  specifier
  68. directly after the E  option  (NO  INTERVENING  SPACES).    The  drive/user
  69. specifier MUST have a TERMINAL COLON (:).  For example,
  70.  
  71.     CPMUNARJ EC3: MYARJ
  72.  
  73. extracts files from MYARJ.ARJ to drive C: user 3.
  74.  
  75. Files extracted from the archive will overwrite existing files of the  same
  76. name on the destination drive/user.  All  files  in  the  archive  will  be
  77. extracted  i.e  you  cannot  specify the extraction of just certain  files.
  78. (See Development Notes below.)
  79.  
  80.  
  81. DEVELOPMENT NOTES:
  82.  
  83. I used HI-TECH C v3.09 for Z80 CP/M to compile this program, on my  Amstrad
  84. PCW running CP/M Plus.  I have modified parts of the HI-TECH object library
  85. package to allow conventional  du:file.ext  specifications,  and  therefore
  86. have not released the source code.
  87.  
  88. The ability to provide selective extraction may be added later.  Contact me
  89. if this really interests you, because I don't plan to make this program  as
  90. an ongoing project.  (Remember, memory is also tight).  I  do  not  foresee
  91. ARJ becoming a supported CP/M archiving method, and I  would  probably  not
  92. recommend any such attempts.  I think  that  its  memory requirements would 
  93. preclude its use on many CP/M platforms, and would make the development  of
  94. a full featured archiving system most difficult.   My  only  rationale  for
  95. producing CPMUNARJ in the first place was to access  files from a  Bulletin
  96. board which supported CP/M but stored nearly all its files  in .ARJ format.
  97.   
  98. I welcome  your feedback  about  CPMUNARJ.   Comments  about  its   spartan
  99. appearance will be politely ignored!  Contact me:-
  100.  
  101. Paul Hunt
  102. c/-
  103. ZNODE 62 BBS
  104. Perth, Western Australia.
  105. 09-450-0200
  106. (International +619-4500200)
  107.  
  108. or via the CP/M Technical Echo.
  109.