home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / l / lzwbackup / !!ReadMe
Text File  |  1994-11-20  |  4KB  |  119 lines
  1. !LZWbackup v1.0 and !LZWrestore v1.0 
  2. by Ian Prideaux Nov 1994
  3.  
  4. Design Philosophy (aka Why Bother)
  5. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.  
  7. I wanted a routine to backup my hard disc onto 
  8. floppies. I already had a copy of !Backup3 by
  9. Jonathan Marten. This pair of programs work in 
  10. a similar way. !Backup3 simply copies files and 
  11. directory structures onto the floppies. My program 
  12. creates one file on each floppy, and stores 
  13. compressed versions of the files to be backed up. 
  14. This should take fewer floppies to back up a given 
  15. number of files because:
  16. a) most files get 30% ish knocked off them by the
  17.    compression.
  18. b) compressed files are concatenated into one file,
  19.    hence there are no cluster losses i.e. a 700 byte
  20.    file takes up a whole 1Kb sector, hence wasting
  21.    the other 300 bytes.
  22. c) directories (if stored at all) are stored by name
  23.    only, hence do not take up a sector to
  24.    themselves.
  25. !Backup3 is rather cleverer, in that it is able to 
  26. remember how much free space is on each floppy it 
  27. has seen, and to ask for one back if it has a file 
  28. which will fit one of those spaces.
  29.  
  30. The compression routine is implemented by 
  31. John Kortink's LZW module, both versions and the 
  32. documentation are included. I got these from a
  33. version of !Gzip. I don't think that they are the 
  34. latest versions, but they work well. If someone has 
  35. copies of or knows where to get hold of later 
  36. versions, please email me (address at the end). If 
  37. someone can supply me with the details of the 
  38. Squash module in RiscOs 3.1, I'll try that and 
  39. possibly include the choise in the next release.
  40.  
  41. Basic Operation
  42. ~~~~~~~~~~~~~~~
  43. !LZWbackup is given a list of files to backup (the 
  44. Include list) and a list of files which must not be 
  45. backed up (the Exclude list). When the GO button is 
  46. clicked, a series of floppies will be generated with
  47. the specified files on them. Each floppy is a 
  48. complete entity in itself and does not have to have 
  49. any of the others in the series to restore from.
  50.  
  51. !LZWrestor will list the contents of a floppy and 
  52. restore the entire contents of the floppy to their 
  53. original place in the directory structure. It is 
  54. incapable of selecting files from the floppy or of 
  55. specifying where they go (This is a couple of things
  56. I may change in a later version).
  57.  
  58. For more details, see the individual !Help files.
  59.  
  60. There are a couple of bugs, so I have included the 
  61. source code so you can see what I have done and how 
  62. I have done it (more bug details in the !Help 
  63. files). To try to put your mind at rest, I havn't 
  64. found any bugs which corrupt the stored data, so 
  65. please try it out, but as with all programs of this 
  66. type, do not trust data to it without first testing 
  67. it and making sure that it works on YOUR system. If 
  68. you have any comments or suggestions or any "You 
  69. don't want to do it like that, you want to do it 
  70. like this"'s, please email me (address at the end).
  71.  
  72. Disclaimer
  73. ~~~~~~~~~~
  74. This program is supplied 'as is' with no guarantee 
  75. of its suitability for any purpose. I will not be 
  76. held responsible for any loss of data occuring 
  77. through the use or misuse of this program.
  78.  
  79. Public Domain Notice
  80. ~~~~~~~~~~~~~~~~~~~~
  81. !LZWbackup & !LZWrestore may be freely copied and 
  82. used, as long as the following conditions are met:
  83.  
  84. a) That this notice is distributed unchanged with 
  85.    every copy.
  86. b) That the applications are supplied with unchanged
  87.    versions of all the files that I have supplied.
  88.    (If you do make modifications to any part of 
  89.    these applications, please do not distribute 
  90.    them without contacting me first, at the address 
  91.    below.)
  92. c) No charge is made for the distribution. Public 
  93.    domain libraries may make a small charge to cover
  94.    distribution costs.
  95.  
  96. All copyright is reserved. You may not use any part 
  97. of this application in any project which is to be 
  98. sold for profit without my express permission in 
  99. writing.
  100.  
  101. If you wish to use pieces of my code in your own pd 
  102. programs then please feel free to do so, provided 
  103. these programs are not intented for sale.
  104.  
  105. If you do use my code, a credit (blame!) would be 
  106. nice.
  107.  
  108. Ian Prideaux,
  109. 66, Rectory Road,
  110. Frampton Cotterell,
  111. BS17 2BP.
  112.  
  113. email 
  114.   ian prideaux at Arcade or The World of Cryton
  115. or
  116.   i-pridea@csd.uwe.ac.uk
  117. or
  118.   i-pridea@ada.uwe.ac.uk
  119.