home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / targ109b.zip / TarGzipPm / ReadMe.epm < prev    next >
Text File  |  1998-08-22  |  5KB  |  132 lines
  1. TarGz-Pm V1.09B.
  2.  
  3. Welcome to the Sixth release of TarGzPm.  I hope you find this 'email ware' 
  4. useful.  If you wander where the numbers go between releases
  5. 1.02f  to this one, its because I give each update a new number and not all of 
  6. these are released until they are stable?
  7.  
  8. You must be warned that this is a very early beta version.  Since tar and gzip actually 
  9. changes the file being unarchived, this program only works on copies of the file made, so 
  10. your original *.tar.gz stay intact . which it then cleans up on completion....So the 
  11. temporary files are deleted.  
  12.  
  13. While this program is 'email ware' it is copy writed, and is the proerty
  14. of Virtual Publication 1998..... Virtual publications take no responcibility for any
  15. adverse effect, caused by this program....      
  16.  
  17.  
  18. What it Does 
  19.  
  20.  
  21. Creates Archives with Tar.gz extension
  22. Unarchives *.tar.gz, *.tgz Files
  23. Can Create new directories to unarchive into
  24.  
  25.  
  26. System Requirements        
  27.  
  28. OS/2 version 2 +
  29. Rexx installed with OS/2 Object or classic
  30. Tar.exe and Gzip.exe must be on your path to use this program, or you
  31. will get a warning Dialog which closes the prog
  32.  
  33. Installing it?  
  34.  
  35. I haven't done an install prog yet, it will come. 
  36. After you have unziped the file simply  Drag a program object
  37. onto you're desktop and fill in the fields as follows, lets say you
  38. have unziped TarGzPm to your H directory
  39.  
  40. Path and file name: I:\TARGZPM\TARGZ-PM.EXE
  41. Parameter:   %*  (This allows for drag and drop, point and click etc)
  42. Working Dir:  I:\TARGZPM
  43.  
  44. Then go the the Association tab and Add *.tar.gz, and *.tgz
  45.  
  46. That's it you can now run TarGzPm from both your desktop icon or *.tar.gz
  47. data files.... Though, Do not attempt to run more than one copy at a time     
  48. (see Coming Attractions )
  49.  
  50.  
  51.  
  52. Warning   
  53.  
  54.  
  55. When creating new directories you should only make one at a time, no slashes should be 
  56. included, or it will result in errors. You will be warned if the directory you are 
  57. trying to Create exists, and the accept button will become disables.  To make recursive 
  58. new directories, simply make one at a time and then press the accept dir, then press the
  59. NewDir button again ... (it will make more sense when you see it going)
  60.  
  61. Why I Made This Prog 
  62.  
  63. Having come to terms with zip files and purchasing RPF's Great PM zip/unzip prog,
  64. I found my self with a *.tar.gz file (though these files some times have the 
  65. Suffix *.Z-see limitations) . After some searching I found that there was
  66. GNU programs available to unarchive this type of file... However, unlike a normal zip file
  67. *.tar.gz work in two stages.
  68.  
  69. The Tar program basically collects files and joins them into one file..
  70. gzip is a method of compressing, though you only compress one file, hence the need for tar 
  71. as well?
  72.  
  73. One of the reasons why I decided to make a front end to to these archives, was due to the 
  74. nature of the syntax..... (it not like unzip.exe where you can simply go unzip File.zip) 
  75. you have to specify a number of  parameters eg +File MyFile.Tar, for example, or it 
  76. will complain thus:
  77.  
  78. "tar: can't open tape.out: No such file or directory"
  79.  
  80. need I say more!  I started out by producing a simple  command Rexx file which got the 
  81. file to unarchive and the directory and passed it to tar and gzip.  I then thought it might
  82. be a good idea to give it a PM interface. Since I am new to programming I have found this
  83. a useful "learning exercise.....")  One of the problems I have found is that unlike zip
  84. you not only have a two stage procedure to go though, but also file names that change
  85. during the process.  When Taring a directory its not that hard.. it is simply a matter of
  86. adding the extension to the variable being used, eg
  87. Tar +file Filename +Directory SourceSelected
  88.  
  89. TarGzfile =Filename||'.tar'.
  90.  
  91. and the same to add the gz extension.  So this is what this program does 
  92.  
  93. Tars and Gzips directories(sub-directories), you can specify the directory/sub dir to 
  94. tar, you can specify what dir to unarchive into.
  95.  
  96. Coming Attraction         
  97.  
  98. List box,  using  the '+to-Stout' option to list the content of archive being 
  99. archived/un-archived.  This will need a Temp dir  (this it might take some time, sorry!)
  100. I am working on this next.. 
  101.  Though I am moving to RXQUEUE instead, if anone wants                
  102. to help with this, please let me know
  103.  
  104.  
  105. More error checking with the Create Dir Dialog to ensure no '/' are not included 
  106.  
  107. Moore Error checking particularly in terms of Bad Tar.gz files, at present, if you try to 
  108. unarchive a bad file, you will find the File still in *.tar.gz or  *.tar depending at
  109. which stage it goes wrong. (or an empty dir if my code works as it should)
  110. still needs implementing, but am working on it 
  111.  
  112. Installation prog (PM Rexx using DrDialog or command line)
  113.  
  114. Help is provided through messages in the main Window, which basically tells you what each 
  115. control does.  If you have any further suggestion please let me know, or if you encounter 
  116. any problems.......
  117.  
  118. Thanks and Acknowledgements to the following for their help and support, without which 
  119. this project would still be an ideas??
  120.  
  121. Kia Evers, Ian and V.Kazimirchik
  122.  
  123. Address:
  124.  
  125. http://users.powernet.vpub
  126.  
  127. Email Asuri@vpub.powernet.co.uk
  128.  
  129.  
  130.  
  131.  
  132.