home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / disk / backman019b.lha / BackManMUI.Doc < prev    next >
Encoding:
Text File  |  1995-02-13  |  6.7 KB  |  156 lines
  1. IMPORTANT NOTES
  2. ~~~~~~~~~~~~~~~
  3. THIS DOCUMENT IS VERY PRELIMINARY, AND IS INTENDED ONLY TO GIVE SOME ROUGH
  4. INSTRUCTIONS TO BETA TESTERS. THE REAL DOCUMENTATION WILL COME WHEN THE
  5. PROGRAM WILL BE CLOSER TO COMPLETION.
  6.  
  7. As a consequence, usage of beta versions of this program is not recommended
  8. to unexperienced users: blowing up your hard disk by improper use of this
  9. program is your very own problem, so think twice before using this program
  10. without proper care and knowledge.
  11.  
  12. PLEASE DON'T MAKE IMPORTANT BACKUPS WITH THIS VERSION! DISK FORMAT IS SUBJECT
  13. TO CHANGE (AND WILL DO, BE SURE), SO LATER VERSIONS MAY NOT BE ABLE TO
  14. RESTORE OLD BACKUPS! Or at least keep this version somewhere, but don't say
  15. we didn't tell you if you lose your data.
  16.  
  17. This version of BackMan still includes some debugging code: please report any
  18. "strange" message you might see (mostly of the kind "Assertion is false!",
  19. followed by several lines of programmer's information), with the most
  20. complete description of the conditions in which it was displayed, and if
  21. possible send us a sample backup that shows the problem.
  22.  
  23. This document is updated only when time permits. Don't rely too much on the
  24. information contained herein; on the other side, please report any error, and
  25. feel free to contact the authors for any misunderstanding.
  26.  
  27. Please read the chapter entitled "NO WARRANTY" in the file "BackMan.Doc"
  28. before you even think about running this program.
  29.  
  30. Installation
  31. ~~~~~~~~~~~~
  32. To install BackMan, simply extract the archive where you prefer: you should
  33. use the 'x' command of LhA to extract full paths. Make sure the Images drawer
  34. is present in the same path of BackManMUI.
  35.  
  36. Requirements
  37. ~~~~~~~~~~~~
  38. BackMan requires Release 2.04 or later of the Amiga OS to run. If you didn't
  39. upgrade yet, then it's definitely time to do it: you are missing lots of new
  40. features and good software, and you're holding Amiga technology behind.
  41.  
  42. BackManMUI, as its name implies, uses and requires MagicUserInterface by
  43. Stefan Stuntz, version 2.2 or later (the appropriate copyright notice will be
  44. added in a later release of this doc; it is however fully acknowledged by the
  45. authors). We will assume that MUI is already installed and working on your
  46. system. MUI is *NOT* distributed with BackMan: you can get it through various
  47. public domain/freeware/shareware collections, through electronic networks, or
  48. directly from the author.
  49.  
  50. MUI has many advantages over other user interfaces, in primis over the
  51. system-supplied GadTools library, especially from a programmer's point of
  52. view: the supposed slowness and space requirements of MUI are definitely
  53. worth it. If you didn't try it out yet, please do: you will be impressed.
  54.  
  55. BackMan supports the MultiUserFileSystem by Geert Uytterhoeven (the same
  56. considerations on copyright apply), and to the knowledge of the authors it is
  57. the only backup program with such support. MultiUser support requires
  58. multiuser.library V39+ and dos.library V39+.
  59.  
  60. BackMan supports data compression through the XPK libraries.
  61.  
  62. Limitations
  63. ~~~~~~~~~~~
  64. Backup/Restore is limited to about 4 Mbytes for unregistered users.
  65.  
  66. The main window
  67. ~~~~~~~~~~~~~~~
  68. Here you can select what operation to perform.
  69.  
  70. You should already know the "About..." part, as it gets displayed for 30
  71. seconds if you're not a registered user.
  72.  
  73. The only option that needs clarification is "Diff": this operation will read
  74. the catalog from the backup and check the file attributes against those on
  75. your drive. It was inspired by the 'h' command of LhA by Stefan Boberg.
  76.  
  77. The Configuration window
  78. ~~~~~~~~~~~~~~~~~~~~~~~~
  79. The first thing you have to do is to bring up the configuration window by
  80. pressing the "Configure..." button in the main window or by selecting the
  81. appropriate menu item.
  82.  
  83. The options seem obvious enough for the aforementioned experienced users.
  84. Please read "BackMan.Doc" for some more hints.
  85.  
  86. Only some notices: the drive list supports more than one device (they appear
  87. separated by commas, as in "DF0,DF1"), but the internal routines don't, so
  88. restrict yourself to one device. Moreover, be careful not to select your hard
  89. disk as the backup device unless you know very well what you're doing, or you
  90. might get really upset by the results.
  91.  
  92. *All* disk devices that have a valid DOS device entry are suported: this
  93. includes CrossDOS disks, DiskSpare disks, hard disks (of which removable
  94. cartridges such as SyQuest drives are a subset), most recoverable RAM drives
  95. (I wouldn't recommend them as backup devices, however). HD floppies are
  96. supported, but you should insert an HD disk *before* you start the backup.
  97.  
  98. The Backup window
  99. ~~~~~~~~~~~~~~~~~
  100. Here you select which files you want to backup.
  101.  
  102. You can backup more than one directory tree at a time by clicking the
  103. "Add..." button and selecting a new directory.
  104.  
  105. You can remove a catalog from the backup by selecting it and clicking the
  106. "Remove" button (you will be asked for confirmation).
  107.  
  108. By double-clicking on an entry in the catalog list you can bring up the file
  109. selection window or change the comment for this catalog, depending on wich
  110. field you double-click. These options are also available as buttons just
  111. below the catalog list. Experiment as you wish, you can't do anything harmful
  112. at this stage.
  113.  
  114. The backup creator is global for all catalogs. It is taken from the
  115. registration key if you have one, but you can change it as you wish.
  116.  
  117. Selecting "Start" will start the backup. Please double-check that you
  118. selected the proper destination medium, or you could overwrite the very same
  119. files you're trying to backup.
  120.  
  121. The Restore/Compare/Diff window
  122. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  123. You will get here after BackMan has read the catalog from the backup, which
  124. usually doesn't take more than a few seconds. The window title shows which
  125. kind of operation you're performing.
  126.  
  127. Basically, here you can select catalogs/files to operate on and change the
  128. destination directory, which by default is set to the same directory the
  129. files originally came from: not much difference from the Backup window.
  130. Again, you can't do any harm here, so experiment at will.
  131.  
  132. The Status window
  133. ~~~~~~~~~~~~~~~~~
  134. This window comes up after you select "Start" from the Backup or
  135. Restore/Compare/Diff windows. It will show you the progress of the operation
  136. you're doing by displaying the directory and file being operated on and some
  137. counters that tell you how many files/bytes have been read or written as yet.
  138.  
  139. Here you can only pause/restart or abort the operation.
  140.  
  141. If you are doing a compressed backup, at the bottom of the status window
  142. there will be a gauge showing the compression ratio. The ratio is calulated
  143. as PackedSize/RealSize, so higher is better.
  144.  
  145. The Authors
  146. ~~~~~~~~~~~
  147. BackMan was written by
  148.  
  149.   Sandro Tolaini    2:332/113.3@fidonet
  150.                     39:102/507.3@amiganet
  151.  
  152.   Flavio Stanchina  2:333/408.9@fidonet
  153.  
  154. Contact us for any question/suggestion/bug report.
  155.  
  156.