home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / l / lzwbackup / !LZWbackup / !Help next >
Encoding:
Text File  |  1994-11-20  |  4.2 KB  |  134 lines
  1. !Help for !LZWbackup 1.0 Nov 1994 by Ian Prideaux.
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is the backup half of the backup restore pair.
  5.  
  6. When run, the program installs itself on the icon 
  7. bar (yeah I know, crappy icon, I'll change it if I 
  8. can think of anything better).
  9.  
  10. The operation of the program is defined by the 
  11. Include list and the Exclude list. A file gets 
  12. backed up only if it is in the Include list AND not 
  13. in the Exclude list. I've included an example of 
  14. each, but you'll have to create your own. The 
  15. actual filenames used are defined in the !Run file.
  16.  
  17. From the icon bar menu there are four options to
  18. display each list and to delete each list. The Show
  19. options simply create a task window and *type the 
  20. appropriate files (if anyone can tell me a better 
  21. way, please tell me, especially if it allows me to
  22. edit the files in a window). 
  23.  
  24. The Exclude list has to be created explicitly with 
  25. !Edit or similar, but has the advantage that the 
  26. last character can be a *, used as a wild card. The 
  27. first line in the example stops the contents of 
  28. $.!Scrap.ScrapDir being backed up.
  29.  
  30. The Include list can be created with !Edit, but is 
  31. more simply created by dragging a file or directory 
  32. or group of files/directories to the icon bar. Any 
  33. files dragged in this way are appended to the list, 
  34. so if you want to create a new list, be sure to 
  35. clear it first. All files must be explicitly defined 
  36. there can be no wildcarding.
  37.  
  38. The "Info" and "Quit" options are self explanitory.
  39.  
  40. The "Show Main Window" option has the same effect as
  41. clicking select on the icon i.e. it displays the 
  42. main window! There are three click buttons, 
  43. two option buttons and a writable icon.
  44.  
  45. GO, ABORT & CONTINUE are fairly obvious, when they
  46. are a viable option, they are unfaded and 
  47. available to be to be clicked.
  48.  
  49. The Floppy File Name icon is writable and contains
  50. the name of the file(s) created on the floppy(s).
  51. This name is truncated and an incremental count is 
  52. appended i.e. if the icon reads "My_Backup", the 
  53. file on the first floppy is called "My_Back_01".
  54.  
  55. When the "Include Disc Name" option is set, 
  56. filenames are stored as 
  57.  
  58.   idefs::HardDisc4.$.DirName1.DirName2.FileName
  59.  
  60. If the option is clear, filenames are stored as
  61.  
  62.   $.DirName1.DirName2.FileName
  63.  
  64. This is useful if you have multiple hard discs or
  65. partitions, or if your filing system likes its discs 
  66. to be refered to in full. Set it for a first try 
  67. out.
  68.  
  69. When the "Include Directories" option is set, the 
  70. directory names get stored as seperate entities i.e. 
  71. before 
  72.  
  73.   idefs::HardDisc4.$.DirName1.DirName2.FileName
  74.  
  75. gets stored, an entry for 
  76.  
  77.   idefs::HardDisc4.$.DirName1.DirName2
  78.  
  79. is created. Directory names are not really needed, 
  80. this was just a hang over from a previous version.
  81.  
  82.  
  83. I've included the source code, as there are still
  84. a couple of bugs, the main one being with the abort
  85. button. Any help will be much appreciated.
  86.  
  87. Disclaimer
  88. ~~~~~~~~~~
  89. This program is supplied 'as is' with no guarantee 
  90. of its suitability for any purpose. I will not be 
  91. held responsible for any loss of data occuring 
  92. through the use or misuse of this program.
  93.  
  94. Public Domain Notice
  95. ~~~~~~~~~~~~~~~~~~~~
  96. !LZWbackup & !LZWrestore may be freely copied and 
  97. used, as long as the following conditions are met:
  98.  
  99. a) That this notice is distributed unchanged with 
  100.    every copy.
  101. b) That the applications are supplied with unchanged
  102.    versions of all the files that I have supplied.
  103.    (If you do make modifications to any part of 
  104.    these applications, please do not distribute 
  105.    them without contacting me first, at the address 
  106.    below.)
  107. c) No charge is made for the distribution. Public 
  108.    domain libraries may make a small charge to cover
  109.    distribution costs.
  110.  
  111. All copyright is reserved. You may not use any part 
  112. of this application in any project which is to be 
  113. sold for profit without my express permission in 
  114. writing.
  115.  
  116. If you wish to use pieces of my code in your own pd 
  117. programs then please feel free to do so, provided 
  118. these programs are not intented for sale.
  119.  
  120. If you do use my code, a credit (blame!) would be 
  121. nice.
  122.  
  123. Ian Prideaux,
  124. 66, Rectory Road,
  125. Frampton Cotterell,
  126. BS17 2BP.
  127.  
  128. email 
  129.   ian prideaux at Arcade or The World of Cryton
  130. or
  131.   i-pridea@csd.uwe.ac.uk
  132. or
  133.   i-pridea@ada.uwe.ac.uk
  134.