home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk934 / abackup / abackupenglish.doc < prev    next >
Text File  |  1993-12-21  |  59KB  |  1,171 lines
  1.  
  2.  
  3.                 ABackup - User's Manual
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.  
  11.       This manual describes release 4.03  of  the  utility    ABackup.  This
  12.   program is (c)1992-1993 by Denis GOUNELLE, any commercial usage  or  selling
  13.   without author's written authorization is strictly forbidden. You  can  copy
  14.   and spread this program under the following conditions:
  15.  
  16.     - all the files are provided
  17.     - the files are not modified in any way
  18.     - you don't charge more than $6 for copy fee
  19.  
  20.       In spite of several tests, no warranty is made  that    there  are  no
  21.   errors in ABackup. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no event will I
  22.   be liable for any damage, direct  or    indirect,  resulting  of  the  use  of
  23.   ABackup.
  24.  
  25. Introduction
  26.  
  27.       ABackup is a backup program written for the Amiga. It  may  be  used
  28.   both to make a backup of  your  hard    disk  or  to  archive  files,  handles
  29.   non-AmigaDOS partitions, has a full Intuition interface,  and  can  use  XPK
  30.   library. Under 2.0 system release, ABackup is able to recognize links and to
  31.   manage high density disks.
  32.       As this program contains some unusal features, it is recommended  to
  33.   read this documentation carefuly.
  34.  
  35.       Criticisms and suggestions will always be welcomed. Write to:
  36.  
  37.                    M. GOUNELLE Denis
  38.                     Boite 71
  39.                   6, rue des cailloux
  40.                  92110 CLICHY - FRANCE
  41.  
  42.       You can also send a message to  the  following  Internet  address  :
  43.   "gounelle@alphanet.ch". Note that this mailbox is not mine, so  please  send
  44.   only short messages. As I don't have direct access to  the  messages,  don't
  45.   expect an answer before a dozen of days.
  46.  
  47. Contribution
  48.  
  49.       This program is SHAREWARE. If you find it useful, I  invite  you  to
  50.   send at least $10 at    the  address  listed  above,  in  order  to  become  a
  51.   registered user. Please use only:
  52.  
  53.       - checks from a French bank
  54.       - cash (French Francs prefered, otherwise any currency of the E.E.C.  is
  55.     accepted, as well as US dollars and Swiss  Francs  ;  in  either  case
  56.     please add a little more for change fee)
  57.       - checks from an European bank (if you use an EuroCheck, please  add  $8
  58.     because my bank taxes it)
  59.  
  60.   If you send me a check, it must be in French Francs and the beneficiary must
  61.   be "M. GOUNELLE Denis". In either case, be sure to give  your  full  address
  62.   and to make it readable.
  63.       As a registered user, you will receive the next version  of  ABackup
  64.   as soon as it will be available. You should be aware that a $10 contribution
  65.   fee only gives right to one update: if you want to receive the next  updates
  66.   regularly, a $20 contribution is required.
  67.  
  68. Thanks
  69.  
  70.   I would like to thanks the following:
  71.  
  72.   Reza Elghazi,
  73.   Jean-Yves Proux,
  74.   Jean-Philippe Rapp,
  75.   Michel Schinz,
  76.   and everyone who send me a suggestion or reported a bug,
  77.  
  78.   Reza Elghazi,
  79.   Stefan Salewski,
  80.   for their help concerning the crash under system 3.0,
  81.  
  82.   Horst Schumann,
  83.   Fred Hamilton,
  84.   beta-tester for non-AmigaDOS partitions support,
  85.  
  86.   Kai Rode,
  87.   Stefan Salewski,
  88.   for the german translation of the program and the documentation,
  89.  
  90.   Bryan Ford,
  91.   Urban Dominik Mueller,
  92.   et the others XPK library authors,
  93.  
  94.   and everyone who send me a contribution.
  95.  
  96.   Also, a lot of thanks to Yves Perronoud, Jean-Philippe Rapp, Marc  Schaefer,
  97.   and Michel  Schinz  for  constant,  enthusiast  and  (almost)  unconditional
  98.   support.
  99.  
  100. Getting_started
  101.  
  102.       ABackup can be run from CLI and  from  Workbench.  Usually,  ABackup
  103.   tries to create a child task that will  perform  all    write  operations,  in
  104.   order to make backup faster.    If  the  task  creation  fails,  ABackup  will
  105.   perform write operations by itself, just like  the  first  versions  of  the
  106.   program.
  107.  
  108.       From the CLI, you can invoke ABackup as follows:
  109.  
  110.       ABackup  [FROM  directory]  [BUFSIZE  size]   [NOCOMP   ext,ext,...]
  111.       [NOTASK] [TMPDIR dir] [SIZE {BYTE|KBYTE|MBYTE|AUTO}] [USEASL]  [FONT
  112.       nameY]
  113.  
  114.   The FROM option allows to specify a directory name for backup.  By  default,
  115.   this one will be the current directory.
  116.   The BUFSIZE option allows to change the size of the  write  buffer  for  the
  117.   child task (for example "BUFSIZE 64" asks for a 64 Kb buffer).  By  default,
  118.   the buffer is 12 Kb large, which gives the same speed  as  version  2.43  of
  119.   ABackup. This buffer is allocated in CHIP memory,  but  is  only  used  when
  120.   backing up to floppy disks. A larger buffer may increase backup speed up  to
  121.   20%, but take care that a very large buffer may not give the best gain:  the
  122.   optimal buffer size depends of the speed of your Amiga, of  the  compression
  123.   method used, and of the average size of your files. On my A3000,  a  128  Kb
  124.   buffer is quite perfect.
  125.   The NOCOMP option allows to  specify    extensions  of    file  names  to  don't
  126.   compress. You can specify up to 10 extensions, separated by a  comma    (e.g.:
  127.   "NOCOMP .info,.run"). This specification overwrites the  one  saved  in  the
  128.   configuration file (see backup options).
  129.   If the creation of the child task is a problem (no memory  etc...)  you  can
  130.   prevent ABackup to create it with the NOTASK argument.
  131.   The TMPDIR argument allows you to change the    temporary  directory  used  by
  132.   ABackup. By default, it uses the "T:" directory, but this may lead to memory
  133.   problems, especially if this directory is assigned to "RAM:T".
  134.   The SIZE argument allows you to change the default unit of the  "Size"  menu
  135.   (see below).
  136.   The USEASL argument allows you to use the file  requester  of  "asl.library"
  137.   instead of the built-in requester.  This  option  will  be  ignored  if  the
  138.   library can't be opened, or if the requester can't be allocated.
  139.   The FONT argument allows you to specify the font to use. By default, ABackup
  140.   uses    the  default  "text"  font.  The  font  will  be  refused  if  it   is
  141.   proportionnal, by there are no size checking. The syntax for    font  name  is
  142.   "nameY", e.g. "topaz8".
  143.  
  144.       From the Workbench, you can change the size of the write  buffer  by
  145.   adding a line of the form "BUFSIZE=<size in Kb>" in the "TOOL  TYPES"  field
  146.   of ABackup icon. You can also specify extensions  of    file  names  to  don't
  147.   compress by adding a line of the form "NOCOMP=ext,ext,...", prevent  ABackup
  148.   to create a child task by adding a line "NOTASK", change  the  unit  of  the
  149.   "Size" menu by adding a line  of  the  form  "SIZE=unit",  ask  to  use  the
  150.   "asl.library" file requester by adding a  line  of  the  form  "USEASL",  or
  151.   select a font by adding a line of the form "FONT=nameY".
  152.       You can set ABackup as "DEFAULT TOOL" of an archive file,  and  call
  153.   it with an icon as an argument. If  this  icon  is  a  directory  icon,  the
  154.   contents of this  directory  will  immediatly  be  loaded,  and  the    backup
  155.   selection screen will be displayed. If this is a  file  icon,  ABackup  will
  156.   assume it's an archive file, load it's catalogue  and  display  the  restore
  157.   selection screen.
  158.  
  159.       When the program starts, a screen is displayed with several  gadgets
  160.   on it: click on the gadget that  matches  the  wanted  action.  The  startup
  161.   screen has also a menu with the "Config...", "About..." and "Quit"  options.
  162.   The first one allows to modify ABackup  configuration  (see  "Configuration"
  163.   section), the second one displays informations about the  program,  and  the
  164.   last one allows to quit ABackup.
  165.  
  166. Configuration
  167.  
  168.       A window appears in the middle of the screen,  with  eight  gadgets.
  169.   The first three gadgets show the names of the viewer programs  corresponding
  170.   to the type of a file (ASCII file, IFF picture or other, see  the  "Viewing"
  171.   section), the two next the names of the  external  compression/decompression
  172.   programs (see the "Compression" section), and  the  last  the  name  of  the
  173.   temporary directory (see the "Getting_started" section).
  174.       At the bottom of the window, three gadgets enable  to  validate  the
  175.   changes, to validate and save the changes, or to  cancel  the  changes.  The
  176.   configuration is saved to the "S:ABackup.config" file, which is loaded  each
  177.   time the program start.
  178.       When you save the configuration, the current color palette  is  also
  179.   saved. This allow to change ABackup default colors,  for  exampl