home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / targz12d.zip / TarGzipPm / ReadMe.epm < prev    next >
Text File  |  1998-10-02  |  6KB  |  165 lines
  1. TarGz-Pm V1.2D. Updated 3 September 98
  2.  
  3.  
  4.  
  5. Welcome to the Seventh release of TarGzPm.  I hope you find this 'email ware' 
  6. useful.  If you wander where the numbers go between releases
  7. 1.02f  to this one, its because I give each update a new number and not all of 
  8. these are released until they are stable?
  9.  
  10. This version has lots of new features.... invcluding
  11.  
  12. A) The ability to handle different tar formats, now including
  13. Tar.gz
  14. Tgz
  15. *.Z
  16. *.Tar
  17.  
  18. B) Cdrom should no longs cause targzip to hang, as the attributes are changed 
  19. when the file is copied to your local drive
  20.  
  21. C) TarGzipPm now lists the files of newly created Archives
  22.  
  23. d) Aut delete of temp dir works now, in most cases... still working on
  24. this
  25.  
  26. See history.epm for more info...
  27.  
  28. You must be warned that this is a very early beta version.  Since tar and gzip actually 
  29. changes the file being unarchived, this program only works on copies of the file made, so 
  30. your original *.tar.gz stay intact . which it then cleans up on completion....So the 
  31. temporary files are deleted.  
  32.  
  33. While this program is 'email ware' it code remains the proerty
  34. of Virtual Publication 1998..... Virtual publications take no responcibility for any
  35. adverse effect, caused by this program....      
  36.  
  37.  
  38. What it Does 
  39.  
  40.  
  41. Creates Archives with Tar.gz extension
  42. Unarchives *.tar.gz, *.tgz, *.tar, *.Z Files
  43. Can Create new directories to unarchive into
  44. Lists the contents of tar.gz files, which can be viewed via an editor or through 
  45. Association
  46.  
  47. System Requirements        
  48.  
  49. OS/2 version 2 +
  50. Rexx installed with OS/2 Object or classic
  51. Tar.exe and Gzip.exe must be on your path to use this program, or you
  52. will get a warning Dialog which closes the prog
  53.  
  54. Optional 
  55.  
  56. If you have a Lynux partition you can also get a driver so OS/2 can view
  57. and write to it... 
  58.  
  59. Installing it?  
  60.  
  61. I haven't done an install prog yet, it will come. 
  62. After you have unziped the file simply  Drag a program object
  63. onto you're desktop and fill in the fields as follows, lets say you
  64. have unziped TarGzPm to your H directory
  65.  
  66. Path and file name: I:\TARGZPM\TarGzipPm.EXE
  67. Parameter:   %*  (This allows for drag and drop, point and click etc)
  68. Working Dir:  I:\TARGZPM
  69.  
  70. Then go the the Association tab and Add *.tar.gz, *.tar, *.Z, and *.tgz
  71.  
  72. That's it you can now run TarGzPm from both your desktop icon or *.tar.gz,*Z,*.tgz etc
  73. data files....
  74. (see Coming Attractions )
  75.  
  76.  
  77.  
  78. Warning\ Know Problems   
  79.  
  80.  
  81. When creating new directories you should only make one at a time, no slashes should be 
  82. included, or accept button will become disables.  To make
  83. recursive  new directories, simply make one at a time and then press the accept dir, then
  84. press the NewDir button again ... (it will make more sense when you see it going)
  85. Now if you include a \ you will hear a beep and the accept button becomes disabled
  86.  
  87.  I have added support to view files of any sort as long as it has an associated
  88. program.  Note to have TarGzipPm delete temp files on exit,
  89. you must close it using the exit button
  90.  
  91. Tar.exe does not seem to handle Extended Attributes very well, if you 
  92. open test.tar.gz which contains this file, you will notice that
  93. in epm the markings have gone... if enough people say they want EA support
  94. I will try add it....... in the next release!
  95.  
  96.  
  97. Why I Made This Prog 
  98.  
  99. Having come to terms with zip files and purchasing RPF's Great PM zip/unzip prog,
  100. I found my self with a *.tar.gz file (though these files some times have the 
  101. Suffix *.Z-see limitations) . After some searching I found that there was
  102. GNU programs available to unarchive this type of file... However, unlike a normal zip file
  103. *.tar.gz work in two stages.
  104.  
  105. The Tar program basically collects files and joins them into one file..
  106. gzip is a method of compressing, though you only compress one file, hence the need for tar 
  107. as well?
  108.  
  109. One of the reasons why I decided to make a front end to to these archives, was due to the 
  110. nature of the syntax..... (it not like unzip.exe where you can simply go unzip File.zip) 
  111. you have to specify a number of  parameters eg +File MyFile.Tar, for example, or it 
  112. will complain thus:
  113.  
  114. "tar: can't open tape.out: No such file or directory"
  115.  
  116. need I say more!  I started out by producing a simple  command Rexx file which got the 
  117. file to unarchive and the directory and passed it to tar and gzip.  I then thought it might
  118. be a good idea to give it a PM interface. Since I am new to programming I have found this
  119. a useful "learning exercise.....")  One of the problems I have found is that unlike zip
  120. you not only have a two stage procedure to go though, but also file names that change
  121. during the process.  When Taring a directory its not that hard.. it is simply a matter of
  122. adding the extension to the variable being used, eg
  123. Tar +file Filename +Directory SourceSelected
  124.  
  125. TarGzfile =Filename||'.tar'.
  126.  
  127. and the same to add the gz extension.  So this is what this program does 
  128.  
  129. Tars and Gzips directories(sub-directories), you can specify the directory/sub dir to 
  130. tar, you can specify what dir to unarchive into.
  131.  
  132. Coming Attraction         
  133.  
  134. If enough people ask, I will add extended support for EA's.....Also at present the 
  135. different file types work via their extension eg a *.Z file is deemed to be a Tar 
  136. compressed file... and a tar.gz file a tar file compresed with gzip.... I will in the 
  137. distent future try to get this inofrmation via the filling system...... but there seems 
  138. to be a bug in Rexx and it does not always work
  139. one person asked if it would be possible to inlcude a timer mechanism to back up 
  140. files....here again we have the EA problem, though again if enough people ask, I will
  141. work on it?  Though this program was not really meant as a back up took, but rather a
  142. way for those OS/2 Users with Unix Partitions, to be able to examine unix files in tar.gz 
  143. format etc
  144.  
  145. Installation prog (PM Rexx using DrDialog or command line) still to come
  146.  
  147. Help is provided through messages in the main Window, which basically tells you what each 
  148. control does.  If you have any further suggestion please let me know, or if you encounter 
  149. any problems.......
  150.  
  151. Thanks and Acknowledgements to the following for their help and support, without which 
  152. this project would still be an ideas??
  153.  
  154. Kia Evers, Ian and V.Kazimirchik
  155.  
  156. Address:
  157.  
  158. http://users.powernet.vpub
  159.  
  160. Email Asuri@vpub.powernet.co.uk
  161.  
  162.  
  163.  
  164.  
  165.