home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff270.lzh / MRBackup / MRBackup.TXT < prev    next >
Text File  |  1989-11-06  |  90KB  |  2,036 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                 MRBackup Version 3.3d
  18.            
  19.                              A Hard Disk Backup Utility
  20.  
  21.                                        for the
  22.  
  23.                                   Commodore Amiga 
  24.  
  25.                                    September 1989
  26.            
  27.                                    Mark R. Rinfret
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.           Introduction
  35.  
  36.                MRBackup provides  a range  of services which support backup
  37.           and restore of files to/from hard  disk.   This program  has been
  38.           available for  over a year and has seen several changes (good and
  39.           bad) during that time.  Version 3 contains  major differences and
  40.           some incompatibilities  with version  2.  See the Changes section
  41.           at the end of this document for details.
  42.  
  43.  
  44.           Requirements
  45.  
  46.                MRBackup requires the AmigaDOS version 1.3  operating system
  47.           and an installed ARP library, version 34.1 or higher (arp.library
  48.           should have been included with MRBackup).  In  addition, MRBackup
  49.           runs best with at least 1 megabyte of RAM installed.  A hard disk
  50.           is not necessary (believe it or not!) to use MRBackup. 
  51.  
  52.  
  53.           Installation
  54.  
  55.                The MRBackup "kit" consists of the following files:
  56.  
  57.                MRBackup            - the program file
  58.                MRBackup.info       - program icon file
  59.                MRBackup.TXT        - document file
  60.                MRBackup.init       - user preferences file
  61.                MRBackup.xcld       - exclude filter file
  62.                MRBackup.cflt       - compression filter file
  63.                arp.library         - ARP shared library
  64.                Install             - CLI command file installation
  65.  
  66.           To perform the default installation, just type
  67.  
  68.                EXECUTE Install
  69.  
  70.           This will install the program  in  the  SYS:C  directory  and the
  71.           support  files  (minus  the  document)  in the S: directory.  The
  72.           arp.library file will be copied to the LIBS: directory if it does
  73.           not already exist. MRBackup looks for its support files either in
  74.           the S: directory or in the directory that is current  at the time
  75.           that MRBackup  is executed.   Of course, you can edit the Install
  76.           file to tailor  it  to  meet  your  requirements.    To  obtain a
  77.           hardcopy of the document file, type
  78.  
  79.                COPY MRBackup.TXT TO PRT:
  80.  
  81.           Operation
  82.  
  83.                To use  MRBackup, click on the program icon or type MRBackup
  84.           at the CLI prompt. MRBackup runs in its  own screen.   During its
  85.           initialization,  MRBackup  will  read  the  user preferences file
  86.  
  87.                                           2
  88.  
  89.  
  90.  
  91.  
  92.  
  93.           (MRBackup.init) and set various program options (including screen
  94.           colors) according to the settings in the preferences file.  
  95.  
  96.  
  97.           User Interface
  98.  
  99.                MRBackup  communicates  with  the  user  through  the use of
  100.           standard Amiga features, such as windows, gadgets, requesters and
  101.           menus.   It also  will communicate  with synthesized voice if you
  102.           enable that option.
  103.  
  104.                MRBackup runs in a  custom screen  (2 bitplanes,  4 colors).
  105.           The colors  of the  screen can be adjusted through options in the
  106.           preferences  file  (color0  -  color3)  or  via  a  color palette
  107.           accessible  from  the  menu.    The  main window displays various
  108.           program  settings  and  status  information  through  the  use of
  109.           numerous gadgets.  A second window is visible only when using the
  110.           Utilities  command,  which  can   be  thought   of  as   a  small
  111.           "program-within-a-program".
  112.  
  113.                The  main  window  has  been  designed  such  that primarily
  114.           dynamic (changing) information is displayed in  the top  half and
  115.           static information is displayed in the bottom half.  If you elect
  116.           to use a console specification (CON: or NEWCON:) for your logging
  117.           device, you can drag MRBackup's screen down to reveal the logging
  118.           window and not miss  what's  going  on  in  the  dynamic  area of
  119.           MRBackup's main window.
  120.  
  121.                There is  one program  menu, named Operations, which invokes
  122.           MRBackup's "actions" (backup, restore, etc.).  Its items  will be
  123.           described in detail later on in this document.
  124.  
  125.  
  126.           Main Window Settings
  127.  
  128.                As  you  view  the  main  window,  you should notice several
  129.           gadgets with boxes containing text or numbers.  The gadget titles
  130.           are placed  either on top of or to the right of the gadgets. When
  131.           changing the contents of  the various  string gadgets,  please be
  132.           sure to hit the RETURN key to complete the change.  MRBackup will
  133.           not recognize the change until the  RETURN key  has been pressed.
  134.           If you  make an  input error  and you  forget to press the RETURN
  135.           key, you may not find out about it  until you  start a  backup or
  136.           restore operation.  Several of  these gadgets  have arrow gadgets
  137.           (>>>>) adjacent to them.  Clicking on the arrow gadgets invokes a
  138.           requester which  assists in  filling in  the gadget values (which
  139.           may also be entered directly into the gadget box). There are also
  140.           a pair  of gadgets near the upper right hand corner of the window
  141.           labelled STOP and PAUSE.  The  purpose of  each of  these gadgets
  142.           will be described in the following paragraphs.
  143.  
  144.                Test Date
  145.  
  146.                                           3
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                     The test  date is used when MRBackup performs a backup.
  154.                Only files which have been created or changed since the test
  155.                date will  be eligible for backup.  You should note that the
  156.                default value for the test date is "01/01/78 00:00:00" which
  157.                is the  Amiga's "beginning of history". This value makes all
  158.                files eligible for backup  operations. You  may enter  a new
  159.                value  (using  the  same  format  as  the default value)  by
  160.                typing  directly  into  the  test  date  string  gadget (and
  161.                pressing RETURN) or you can invoke MRBackup's date requester
  162.                by clicking on the  arrow gadget  adjacent to  the test date
  163.                gadget.  
  164.  
  165.                     If  you   click  on   the  arrow  gadget,  a  requester
  166.                containing the test date will appear.   You  may then change
  167.                the test  date through  a combination of keyboard and gadget
  168.                operations.  Remember that  to  clear  the  gadget,  you may
  169.                press  right-Amiga-x.  A  null  date  value  (all blanks) is
  170.                allowed, should  you want  to backup  all files  in the home
  171.                path, regardless  of their  creation dates. The minimum date
  172.                value  handled  by  this  date  requester  is  01/01/78. The
  173.                required date  and time format is MM/DD/YY HH:MM:SS (24 hour
  174.                clock), the  time  specification  being  optional.  You will
  175.                notice upward and downward pointing "arrows" above each date
  176.                component. Clicking on the appropriate arrow  will increment
  177.                or decrement  the respective portion of the date. Though the
  178.                values normally will  wrap  around,  not  affecting adjacent
  179.                date  components,   certain  situations   will  arise  where
  180.                incrementing a day value  may cause  the month  to increment
  181.                (incrementing  February  28  in  a  non-leap-year will yield
  182.                March 31).  There is also  a "NOW"  gadget.   Though not too
  183.                meaningful by itself, it provides a convenient way to "click
  184.                in" dates like "yesterday".  To do this, simply click on the
  185.                "NOW" gadget, then click on the uparrow gadget above the day
  186.                field of the date.
  187.  
  188.  
  189.                Status
  190.  
  191.                     The Status gadget provides a brief  textual description
  192.                of  the   state  of   MRBackup  during  backup  and  restore
  193.                operations.
  194.  
  195.  
  196.                Error Count
  197.  
  198.                     The Error  Count gadget  displays the  number of errors
  199.                that have occurred during a backup or restore.
  200.  
  201.  
  202.                Home Path 
  203.  
  204.  
  205.                                           4
  206.  
  207.  
  208.  
  209.  
  210.  
  211.                     The  Home  Path  gadget  defines  the home location for
  212.                files being backed up or restored. For backup operations, it
  213.                is the  name of  the "source" or "from" device or directory.
  214.                On restore operations, it is the  name of  the "destination"
  215.                or "to" device or directory. The "Home Path" may be the name
  216.                of any disk directory  or volume  or file-structured logical
  217.                name.
  218.  
  219.  
  220.                Current File
  221.  
  222.                     The Current  File gadget  is updated  during backup and
  223.                restore operations to report the active file.
  224.  
  225.  
  226.                Backup Path
  227.  
  228.                     The  Backup  Path  gadget  defines  the   "offline"  or
  229.                "archived" location  for files  being backed up or restored.
  230.                For backup operations, it is the  name of  the "destination"
  231.                or "to"  device or  directory.  On restore operations, it is
  232.                the name of the  "source"  or  "from"  device  or directory.
  233.                Note that  its meaning  is directly  opposite to that of the
  234.                Home Path gadget.  You should also note that the value input
  235.                to the Backup Path gadget is not verified immediately, as is
  236.                the Home Path.  This  allows  you  to  specify  a  device or
  237.                directory which  is not  currently mounted.   If you make an
  238.                erroneous entry, it will be  detected  and  reported  by the
  239.                backup or restore operations.
  240.                  
  241.                     The  "Backup  Path"  must  specify the name of a floppy
  242.                disk device (DF0:, DF1:, etc.) if formatting is enabled (see
  243.                Formatting in a later paragraph).  Otherwise, it may specify
  244.                any directory, volume or file-structured logical name.
  245.  
  246.  
  247.                Current Backup Volume
  248.  
  249.                     The Current Backup Volume  gadget is  updated by backup
  250.                and  restore  operations  to  display the volume name of the
  251.                backup device or directory.
  252.  
  253.  
  254.                Output Capacity
  255.  
  256.                     The Output Capacity gadget is similar  in concept  to a
  257.                fuel  gauge.    It  graphically displays the amount of space
  258.                remaining on the output  device, which  is specified  by the
  259.                Backup  Path  during  backup  operations  and  the Home Path
  260.                during restore operations.
  261.  
  262.  
  263.  
  264.                                           5
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                Blocks
  271.  
  272.                     For those of you with  a  digital  mindset,  the Blocks
  273.                gadget displays  the same information as the Output Capacity
  274.                gadget, but with a digital readout  of the  number of blocks
  275.                available on the output device.
  276.  
  277.  
  278.                Listing Path
  279.  
  280.                     The Listing  Path gadget  specifies the  pathname to be
  281.                used  when  writing  the   detailed  listing   of  a  backup
  282.                operations.  It  may  specify  the printer (PRT: default), a
  283.                file (i.e. MRBackup.list),  or  some  other  stream oriented
  284.                device, such  as SER:.   The Listing Path is only meaningful
  285.                when the Listing gadget is set to ON.
  286.  
  287.                     Listings are currently only  generated when  the Backup
  288.                command  is  used.  Each  time a backup is started, MRBackup
  289.                checks for the existence of the listing file.  If it exists,
  290.                you will be prompted with a requester which says
  291.  
  292.                     Overwrite contents of listing file (NO = append)?
  293.  
  294.                A  YES  response  to  this requester will cause the previous
  295.                contents of the listing file to be destroyed.  A NO response
  296.                will cause new listing information to be appended to the end
  297.                of the listing file.  In  this manner,  you can  do separate
  298.                backups of  different areas  of your disk while accumulating
  299.                the summary information in one file.
  300.  
  301.  
  302.                Compression Filter
  303.  
  304.                     The Compression Filter gadget  specifies the  name of a
  305.                file which  contains pathname patterns of files which should
  306.                not be compressed during backup.   The default  name of this
  307.                filter is  "S:MRBackup.cflt". It has been found that certain
  308.                files will actually expand when subjected  to the Lempel-Ziv
  309.                compression  algorithm  employed  by  MRBackup.  Files which
  310.                fall into this category include archives created by  the ARC
  311.                and Zoo  programs.  Also, files previously compressed should
  312.                not be compressed a second time.  Other  files which exhibit
  313.                this behavior  include several types of graphics files, such
  314.                as IFF ILBM files and GIF files.  
  315.  
  316.                     These  pathname  patterns  use  ARP-style  wildcarding.
  317.                That  is,   both  the  asterisk  (*)  and  the  number-sign,
  318.                question-mark combination  (#?)  can  be  used  to represent
  319.                multiple-character  sequences.    The full range of AmigaDOS
  320.                filename pattern specification can be employed.  
  321.  
  322.  
  323.                                           6
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                     The compression filter file  can  be  created  with any
  330.                text editor  or word processor which will output plain text.
  331.                Each line of  the  file  should  contain  only  one pattern.
  332.                Blank  lines  are  ignored.  Also,  the  specifications  are
  333.                case-insensitive.  That   is,  "SYSTEM"   and  "system"  are
  334.                equivalent.  It  is  important  to  note  that  the pathname
  335.                specifications  are  assumed  to  be  RELATIVE  to  the home
  336.                device.  Everything up to and including the colon (:) in the
  337.                Home Path specification should  be omitted  from the exclude
  338.                filter specifications.  
  339.                 
  340.                     There  are  three  built-in  patterns which need not be
  341.                included in the compression filter file.  They are:
  342.  
  343.                *.arc     Files created by the ARC archiver
  344.                *.zoo     Files created by the Zoo archiver
  345.                *.Z       Files  created  by  MRBackup  compression  or  the
  346.                          standalone "compress" utility.
  347.  
  348.                Other specifications that you might want to include are:
  349.  
  350.                *.GIF     Graphics Interchange Format files (Compuserve)
  351.                *.IFF     IFF files (assuming you use this convention)
  352.  
  353.                Naturally, in  order to fully utilize this feature, you will
  354.                have to adopt some  naming  conventions  for  files  of this
  355.                category.
  356.  
  357.                 
  358.                Backup Volume Prefix
  359.  
  360.                     When  the  Backup  Path  names  a  floppy  diskette and
  361.                formatting is enabled, MRBackup  must  give  a  name  to the
  362.                newly  formatted  diskette.    The default naming convention
  363.                creates a string of the form "Backup MM-DD-YY.n"  where <MM-
  364.                DD-YY> is the current date and <n> is the sequence number of
  365.                the  diskette  being  formatted.    You  can  override  this
  366.                convention  (somewhat)  by  typing  a  value into the Backup
  367.                Volume Prefix gadget.  The diskette sequence number  will be
  368.                appended  to  the  prefix  you  choose.    Note that certain
  369.                special  characters  are  forbidden  (#,  ?,  `,  ',  :, ").
  370.                MRBackup will convert these to a period.
  371.  
  372.  
  373.  
  374.                Exclude Filter
  375.  
  376.                     The Exclude  Filter gadget  names a file which contains
  377.                lines describing files which should not  be backed  up.  The
  378.                default pathname  for this  file is "S:MRBackup.xcld".   Any
  379.                filename matching an entry in  this  list  will  be excluded
  380.                from  a  backup.  The  format  of the Exclude Filter file is
  381.  
  382.                                           7
  383.  
  384.  
  385.  
  386.  
  387.  
  388.                identical to that of the Compress Filter file. Here are some
  389.                examples:
  390.  
  391.                ; Exclude all object files
  392.                #?.o
  393.                ; Exclude all files beginning with "System"
  394.                system*
  395.                ; Exclude all ".info" files
  396.                *.info
  397.                ; Exclude the "include" directory and all subdirectories
  398.                include
  399.                ;  Exclude  any  file  ending  in  a  period followed by one
  400.                character
  401.                #?.?
  402.  
  403.  
  404.                Preferences
  405.  
  406.                     The Preferences gadget specifies  the name  of the file
  407.                containing all  of MRBackup's custom settings. When MRBackup
  408.                is started, it first  looks for  the file  MRBackup.init, in
  409.                the current  directory.   If that file isn't found, it looks
  410.                for  S:MRBackup.init.    You  may  change  some  or  all  of
  411.                MRBackup's default  settings, using  the gadgets describe in
  412.                this section, then save  them to  the file  specified by the
  413.                Preferences  gadget.  Each  line  in  the  file is either an
  414.                option setting, of the form:
  415.  
  416.                OPTION = VALUE
  417.  
  418.                or a comment. Comment lines begin  with a  semi-colon (;). A
  419.                sample initialization file is included on the next page.  It
  420.                illustrates the use of all possible parameter settings.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.                                           8
  442.  
  443.  
  444.  
  445.  
  446.  
  447.           ; This is the MRBackup preferences/initialization file.
  448.           ; This file is comprised of parameter settings and comment lines.
  449.           ; Parameter setting lines are of the form:
  450.           ;     <keyword> = <value>
  451.           ; where <keyword> names the parameter to be set and <value> is
  452.           ; either a boolean (YES/NO) or a string value.
  453.           ; Leading blanks are discarded and empty lines are ignored.
  454.           ; Comments may begin with a semi-colon (;).
  455.           ; Decimal value for screen color 0
  456.           color0 = 0
  457.           ; Decimal value for screen color 1
  458.           color1 = 3020
  459.           ; Decimal value for screen color 2
  460.           color2 = 4080
  461.           ; Decimal value for screen color 3
  462.           color3 = 3616
  463.           ; Level of Lempel-Ziv file compression.
  464.           compression = 13-Bit
  465.           ; Level of Lempel-Zip file decompression.
  466.           decompression = 13-Bit
  467.           ; Should MRBackup generate a paginated listing during backup?
  468.           listing = YES
  469.           ; Should MRBackup talk to me?
  470.           speech = YES
  471.           ; How should floppies be formatted during backup?
  472.           format = Quick
  473.           ; Should MRBackup split large files across multiple floppies?
  474.           bigfiles = YES
  475.           ; Should MRBackup set archive bits during backup/restore?
  476.           setarchivebits = NO
  477.           ; Should MRBackup test archive bits during backup?
  478.           testarchivebits = NO
  479.           ; What is the name of the logging file or device?
  480.           log = NEWCON:0/10/640/190/MRBackup.Log
  481.           ; What is the name of the home device/volume/directory?
  482.           home = DH0:
  483.           ; What is the name of the backup device/volume/directory?
  484.           backup = DF0:
  485.           ; What is the name of the listing device or file?
  486.           list = PRT:
  487.           ; What is the name of the exclude filter file?
  488.           exclude = MRBackup.xcld
  489.           ; What is the name of the compression filter file?
  490.           cfilter = MRBackup.cflt
  491.           ; What is the prefix to be used when naming backup diskettes?
  492.           prefix = MyBackup
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.                                           9
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.           Log File
  508.  
  509.                The Log File gadget contains the name of the file  or device
  510.           (including  console)  which  will  receive  special informational
  511.           messages output by MRBackup during the  course of  its operation.
  512.           You  can  disable  the  log  file simply by clearing the Log File
  513.           gadget and pressing the RETURN key.  Any stream-oriented  file or
  514.           device  specification  is  allowed.    If  you wish to direct the
  515.           logging output  to  a  window,  use  a  CON:  or  NEWCON: console
  516.           specification.  Example:
  517.  
  518.           NEWCON:0/10/640/190/MRBackup-LOG
  519.  
  520.           If you  do specify  a console,  you must be aware that the window
  521.           will be opened on  the WorkBench  screen, rather  than MRBackup's
  522.           custom  screen.    To  view  the  console  window,  just flip the
  523.           WorkBench screen to the front with the Left-Amiga  N combination.
  524.           When you  are done viewing it, return to the MRBackup screen with
  525.           Left-Amiga M.
  526.  
  527.  
  528.           Listing
  529.  
  530.                The Listing gadget is an ON/OFF gadget (clicking  on it will
  531.           invert  its  value)  which  controls  whether  a  listing will be
  532.           produced when performing a backup.
  533.  
  534.  
  535.           Test Archive Bits
  536.  
  537.                Each AmigaDOS file has a  special  flag,  called  an archive
  538.           bit,  which  can  be  used  to indicate whether the file has been
  539.           archived by a disk backup program.    If  the  Test  Archive Bits
  540.           gadget is  set to  ON, only  files whose archive bits are not set
  541.           will be considered for  backup (the  test date  is also applied).
  542.           This  gives  you  a  very  accurate method for incremental backup
  543.           selection if  you're careful  with your  backup diskette library.
  544.           Also, see the Set Archive Bits gadget description.
  545.  
  546.  
  547.           Set Archive Bits
  548.  
  549.                If this gadget is enabled, MRBackup will set the archive bit
  550.           of any file that it  backs  up.  The  archive  bit  will normally
  551.           remain set  until the file is modified in some way. On subsequent
  552.           backups, if the file remains unchanged and the  Test Archive Bits
  553.           gadget is  enabled, the  file will  be excluded from that backup.
  554.           This  provides  an  alternative  to  the  Test  Date  when  doing
  555.           incremental backups.
  556.  
  557.                The setting of the archive bits is deferred until the backup
  558.  
  559.                                          10
  560.  
  561.  
  562.  
  563.  
  564.  
  565.           is completed or the current diskette is filled.  Thus,  should an
  566.           error occur during the backup, you won't be left with files whose
  567.           archive bits have been set but in reality do not exist on  a good
  568.           backup disk.
  569.  
  570.  
  571.           Big Files
  572.  
  573.                The Big  Files gadget  is an ON/OFF gadget which toggles its
  574.           value when clicked. When  ON, it  enables the  archiving of "big"
  575.           files.  Big  files  are  files  whose  size exceeds the formatted
  576.           capacity of a standard 3.5" diskette  (1756 blocks).  In order to
  577.           backup big  files, MRBackup  must split  them across  two or more
  578.           diskettes. In order to  accomplish  this,  a  special information
  579.           file,  MRBackup.bigfile,  is  written  to  each  backup  diskette
  580.           containing a big file.  MRBackup also  requires formatting  to be
  581.           enabled in  order for a big file backup to be attempted. If these
  582.           conditions are not met,  MRBackup will  simply skip  over the big
  583.           file, reporting the event.
  584.  
  585.  
  586.           Voice
  587.  
  588.                The Voice  gadget is an ON/OFF gadget which enables/disables
  589.           MRBackup's ability to speak to you, using the Amiga's synthesized
  590.           voice  capabilities.    This  is  especially  useful  when  doing
  591.           backups. When a new diskette is required, MRBackup will call you.
  592.           In order  to enable  the voice  option, your system must have the
  593.           SPEAK: device mounted.  SPEAK: was introduced with version 1.3 of
  594.           AmigaDOS.
  595.  
  596.  
  597.           Compression
  598.  
  599.                The Compression  gadget determines if file compression is to
  600.           be performed during backup and, if  so, the  size of  the "codes"
  601.           used to  perform the  compression.   Clicking on this gadget will
  602.           cause it to cycle through its range of values from "None" to "16-
  603.           Bit".    See  the  section titled "Compression/Decompression" for
  604.           more details on file compression.
  605.  
  606.  
  607.           Decompression
  608.  
  609.                The Decompression gadget behaves in much the same  manner as
  610.           the  Compression  gadget,  except  that  it controls the level of
  611.           decompression to be performed  during restore  operations.  Thus,
  612.           you  can  independently  control  backup and restore compression.
  613.           During restore, files which  were compressed  with a  larger code
  614.           size  than  that  selected  by  the  Decompression gadget will be
  615.           copied  to  the  home  device,  rather  than  being decompressed.
  616.           Should you wish to decompress these files later, MRBackup will do
  617.  
  618.                                          11
  619.  
  620.  
  621.  
  622.  
  623.  
  624.           it for you.   Just use  the Utilities  command in  the Operations
  625.           menu.
  626.  
  627.  
  628.           Formatting
  629.  
  630.                The Formatting gadget controls the level of formatting to be
  631.           applied to a diskette when a  backup is  done.   Clicking on this
  632.           gadget  will  cause  it  to  cycle  through its range of possible
  633.           values.  They are:
  634.  
  635.                     None - The  diskette  is  assumed  to  be preformatted.
  636.                     Files backed up to the diskette will either be added to
  637.                     files already on the diskette.  If a  file by  the same
  638.                     name already exists, it will be overwritten.
  639.  
  640.                     Normal - The diskette will be completely formatted.  
  641.  
  642.                     Quick  -   The  diskette   must  have  been  previously
  643.                     formatted.  It may be a brand new diskette or  one with
  644.                     old files  on it.  All information about existing files
  645.                     on the diskette is erased.  Since only  two tracks need
  646.                     to be  rewritten in  order to  do this, the diskette is
  647.                     initialized very  quickly.    If  you  batch-format new
  648.                     disks  as  you  purchase  them,  this  mode  is  highly
  649.                     recommended, as it will save you a fair  amount of time
  650.                     over the "Normal" mode.
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.                                          12
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.                Error Handling
  686.  
  687.                     The Error  Handling gadget  controls the level of error
  688.                handling that MRBackup will employ during backup and restore
  689.                operations.   Clicking on this gadget will cause it to cycle
  690.                through its range of values.  They are:
  691.  
  692.                     Interactive - When an  error  is  encountered, MRBackup
  693.                     will  report   the  error,  then  present  you  with  a
  694.                     requester  listing   the  recovery   options  that  are
  695.                     available.
  696.  
  697.                     Retry - When an error occurs, MRBackup will attempt the
  698.                     operation again, up to the number  of retries specified
  699.                     in the  Retries gadget  (later). Errors will be counted
  700.                     and displayed in the Error Count gadget.
  701.  
  702.                     Ignore - MRBackup  will  attempt  to  recover  from the
  703.                     error by retrying up to the number of retries specified
  704.                     in the Retries gadget.    If  recovery  isn't achieved,
  705.                     MRBackup will  skip the  current operation and go on to
  706.                     the next.  For obvious reasons, this mode  of operation
  707.                     is not  recommended, though it is provided for the user
  708.                     who sees a need for it.
  709.  
  710.                     Abort - upon  detection  of  any  error,  MRBackup will
  711.                     promptly   terminate   the   current   operation  after
  712.                     reporting the error.
  713.  
  714.  
  715.                Retries
  716.  
  717.                     The Retries gadget determines the number  of times that
  718.                MRBackup will  attempt to  recover from a file or disk error
  719.                before aborting or proceeding to the next file.
  720.  
  721.  
  722.           Compression/Decompression
  723.  
  724.                The form of compression employed by  MRBackup is Lempel-Ziv,
  725.           used in   popular  archiving programs and the compress program on
  726.           Unix systems. It is reasonably efficient,  performing compression
  727.           "on-the-fly"  (requires  only  1  pass  of  a file) and can yield
  728.           compression factors on the order of 35% - 65% (typical). 
  729.  
  730.                Compression is achieved by  remapping  byte  sequences  in a
  731.           file  to  new  "codes".    Usually, the remapping results in code
  732.           sequences whose total number of bits is less  than the  number of
  733.           bits in  the original  file data.  The codes have a maximum size,
  734.           specified  as  a  number  of  bits,  which  governs  the  overall
  735.  
  736.                                          13
  737.  
  738.  
  739.  
  740.  
  741.  
  742.           performance of  the compression.  MRBackup supports code sizes in
  743.           the range of 12-16 bits.   The  larger  code  sizes  require more
  744.           processor time  to compress  a given file and more memory to hold
  745.           the code tables.  Using 12-Bit codes requires an additional 30000
  746.           bytes of  memory (vs.  no compression).   16-Bit codes require an
  747.           additional 414000 (yes!) bytes.  You will not be able  to use 16-
  748.           Bit  codes  on  a  minimally  equipped Amiga.  Depending upon the
  749.           amount of memory you  have available,  you may  have to terminate
  750.           some applications  and/or close  some windows in order to free up
  751.           enough memory to use 16-Bit codes.  If this doesn't  work, reduce
  752.           the code  size until you find a value that works on your machine.
  753.  
  754.  
  755.           The Operations Menu
  756.  
  757.                MRBackup currently  has  one  Menu,  titled  the "Operations
  758.           Menu".    Each  item  in  the  menu  causes  some operation to be
  759.           performed.  The Operations Menu items are:
  760.  
  761.  
  762.                Backup
  763.  
  764.                     This command  begins  the  backup  process.  You should
  765.                first be sure that all program settings are correct.
  766.  
  767.  
  768.                Colors
  769.  
  770.                     The Colors command pops up a color palette requester on
  771.                your screen.  With it, you can change  the 4  colors used by
  772.                MRBackup's screen and windows.
  773.  
  774.  
  775.                Resume Backup
  776.  
  777.                     This  command  allows  you  to backup your hard disk in
  778.                stages or recover from  an  interruption,  such  as  a power
  779.                failure. Prior  to "starting" each backup diskette, MRBackup
  780.                writes information about its  current  internal  state  to a
  781.                file named  S:MRBackup.context. The  first line of this file
  782.                is the disk sequence number (1..n).  The second  line is the
  783.                name  of  the  first  file  to be written to the floppy. The
  784.                third line is the backup "delta date". Subsequent  lines are
  785.                the names  of files  and directories in MRBackup's top-level
  786.                file list. As long as the  file specified  in line  2 can be
  787.                found, MRBackup  should be  able to resume your backup, even
  788.                if changes  have  occurred  since  the  original  backup was
  789.                interrupted. You  may even edit the context file for special
  790.                situations where  you  wish  to  backup  a  disjoint  set of
  791.                directories.
  792.  
  793.  
  794.  
  795.                                          14
  796.  
  797.  
  798.  
  799.  
  800.  
  801.                Restore
  802.  
  803.                     Restore  allows   you  to  recover  files  from  backup
  804.                diskettes  previously  created  with  the  Backup  or Resume
  805.                Backup commands.  MRBackup will  prompt you for diskettes as
  806.                they are needed. Note  that  there  is  no  rigid  order for
  807.                restoring diskettes.
  808.  
  809.  
  810.                Load Preferences
  811.  
  812.                     This command  reads all  MRBackup program settings from
  813.                the file specified  by  the  Preferences  gadget.  You would
  814.                typically use this command to restore MRBackup's settings to
  815.                your startup settings.
  816.  
  817.  
  818.                Save Preferences
  819.  
  820.                     This command writes the MRBackup's current  settings to
  821.                the file  specified by  the Preferences  gadget. This allows
  822.                you   to   establish   MRBackup's   default   initialization
  823.                parameters.  MRBackup  will  attempt  to  make a copy of the
  824.                current preferences to a file of the same name, but  with an
  825.                extension  of  ".bak".    If  the  preferences name you have
  826.                specified does not currently exist, MRBackup will inform you
  827.                that it could not make a backup.  
  828.  
  829.  
  830.                Utilities
  831.  
  832.                     The  Utilities  command  provides  tools for performing
  833.                certain operations on select groups of  files.   It provides
  834.                its own window and support gadgetry.  The utilities provided
  835.                and the means for  accessing them  are described  in a later
  836.                section  of  this  document.    PLEASE  READ  THE  UTILITIES
  837.                DOCUMENTATION CAREFULLY!  Operation  of  these  utilities is
  838.                not  entirely  intuitive  and  there  are  certain operating
  839.                characteristics that you must be aware of if you are  to use
  840.                them correctly.   Also, these utilities do not attempt to be
  841.                a replacement for the standard AmigaDos  utilities.  Rather,
  842.                they  are  provided  as  a convenience for use while running
  843.                MRBackup.
  844.  
  845.  
  846.                Quit
  847.  
  848.                     Alas - all good things must come to an end. As much fun
  849.                as MRBackup  is to  use, you'll probably want to put it away
  850.                once in a while :-).
  851.  
  852.  
  853.  
  854.                                          15
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                Backing Up a Disk
  861.  
  862.                     The instructions  that follow  assume you  are going to
  863.                backup your  hard disk,  or a  portion of it, to unformatted
  864.                diskettes.  You may also move  files from/to  just about any
  865.                file-structured  volume   or  directory.  Just  remember  to
  866.                disable  disk   formatting   to   relax   the   Backup  Path
  867.                restrictions. To back up your hard disk, or a section of it,
  868.                first get an indication  of the  size of  the area  with the
  869.                Info command,  "ls" (if  you have  it), List,  etc. To get a
  870.                rough estimate of the  number of  diskettes required, divide
  871.                the total  number of bytes (blocks * 512) by 800000.  If you
  872.                have enabled file compression, multiply this result by 0.60.
  873.                This should  give you  a very rough estimate (probably high)
  874.                of the number of diskettes required to back up that area. 
  875.  
  876.                     The  diskettes  selected  for   backup   need   not  be
  877.                preformatted, as MRBackup will format them as needed. If you
  878.                are using previously formatted diskettes, remember  that you
  879.                can save  time if  you use the Quick format option. Remember
  880.                that formatting (Normal  or  Quick)  will  destroy  any data
  881.                previously stored on your diskettes.
  882.  
  883.                     Once your diskettes are ready and stacked neatly within
  884.                reach (get some labels and your favorite marker  pen, too!),
  885.                the  fun  begins.  First, modify the pathname specifications
  886.                according to your requirements.  Normally,  the  "Home Path"
  887.                would be the device name of your hard disk or a directory on
  888.                it (e.g. DH0:) while the  "Backup  Path"  would  specify the
  889.                device name of  one of your floppy drives (e.g. DF0:). While
  890.                earlier versions  of  MRBackup  were  pretty  rigid  in this
  891.                regard,  this  version  will  allow  you to specify ANY disk
  892.                device name  in  either  specification.  PLEASE  BE CAREFUL!
  893.                Many  users  asked  for  this increased flexibility. Just be
  894.                aware that it carries with it an increased risk that you now
  895.                have  more  "opportunity"  to  burn  yourself  with improper
  896.                pathname specifications.
  897.  
  898.                     Finally, the listing path may  be  set  to  the printer
  899.                device (PRT:)  or to  the name  of a file on a hard drive or
  900.                any available floppy drive not being used by the backup. The
  901.                listing path  will be  ignored if you set the Listing gadget
  902.                to OFF.
  903.  
  904.                     Make sure that you have set the desired  options in the
  905.                main window, then select Backup from the Operations menu. 
  906.  
  907.                     Once  the  date  has  been  entered, the rest is fairly
  908.                automatic. You will be prompted immediately  for a diskette.
  909.                Insert it  into the  floppy drive  that you specified in the
  910.                backup path and the disk requester will be satisfied. Should
  911.                you  want  to  abort,  simply  hit  the CANCEL gadget in the
  912.  
  913.                                          16
  914.  
  915.  
  916.  
  917.  
  918.  
  919.                requester. Also, you may abort  the  backup  process  at any
  920.                time by  hitting the  STOP gadget  which appears  in the top
  921.                left area  of the  screen. This  gadget is  checked prior to
  922.                each block  write operation,  so be  patient if  it does not
  923.                respond  immediately.  Use  the  STOP  gadget  with caution-
  924.                it really lives  up to  its name! You may also use the PAUSE
  925.                gadget to suspend a backup or  restore operation.   Once the
  926.                PAUSE  gadget  is  hit,  it  must be hit again to resume the
  927.                current operation.
  928.  
  929.                     As each diskette is  filled, you  should promptly label
  930.                it.  If   formatting  is   enabled,  MRBackup  automatically
  931.                generates volume names of the form:
  932.  
  933.                     Backup MM-DD-YY.<sequence number>
  934.  
  935.                Also to be noted is the  fact that  the files  on the backup
  936.                media   retain   the  creation/modification  date,  comments
  937.                (FileNotes) and protection bits of their counterparts on the
  938.                home device.
  939.  
  940.                     You will find that the Amiga's multitasking environment
  941.                shines when using this program. For those long-haul backups,
  942.                get everything  started, then shove MRBackup's screen to the
  943.                back and go start something useful.  MRBackup will  carry on
  944.                without your  watchful eye.  When it  needs a disk, the disk
  945.                requester will pop out in front  of everything  and MRBackup
  946.                will ask  (out loud, if voice is enabled ) for another disk.
  947.                Having something else to do will make the time pass faster.
  948.  
  949.  
  950.                Restoring the Backups
  951.  
  952.                     No, this isn't always the bad part. Backup  and restore
  953.                can also  be useful  when your  hard disk is crowded and you
  954.                have to "juggle" data  around.  The  restoration  process is
  955.                quite similar,  mechanically, to  the backup  process - it's
  956.                just reversed. In addition,  the  meanings  of  the pathname
  957.                specifications  are   altered  somewhat.   The  "Home  path"
  958.                describes the destination for  the  restored  files  and, as
  959.                with the  backup process, may specify any valid directory or
  960.                file-structured device pathname. The "Backup Path" describes
  961.                the file  or files  to be  restored and  thus may be defined
  962.                down to the file level (1 file).
  963.  
  964.                     Note that on a  restore  operation,  the  file creation
  965.                date of the backup file is compared to its matching file (if
  966.                it exists) on the home  device.  If  the  file  on  the home
  967.                device has  the same  date or is newer, the file will not be
  968.                replaced. If you wish to restore the older copy, it  must be
  969.                deleted first.
  970.  
  971.  
  972.                                          17
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.           Utilities Operation
  980.  
  981.                The  MRBackup  Utilities  window  is  activated by selecting
  982.           "Utilities" from the Operations  menu.   The utilities  provide a
  983.           range of  services which  augment the  power of MRBackup and lend
  984.           convenience to its use.  PLEASE READ THIS SECTION CAREFULLY!  The
  985.           proper operation  of these  utilities may run counter to what you
  986.           expect and some of the features/capabilities are quite subtle.
  987.  
  988.                The first point to be  noted  is  that  these  utilities are
  989.           designed  primarily  to  perform  operations  across directory or
  990.           device boundaries, though the Compress and  Decompress operations
  991.           may be  performed in  a single directory and the Delete operation
  992.           always works  on  a  single  directory.    At  the  heart  of the
  993.           utilities' operation is a highly interactive file requester which
  994.           supports the concept of  "extended  selection"  (quite  common on
  995.           you-know-who's  computer).    With  extended  selection,  you can
  996.           select a subset of files listed for a given directory  by holding
  997.           down the  SHIFT key  during the selection process.  This group of
  998.           files may then be "fed" to the desired operation.  I will discuss
  999.           this in more detail later on.
  1000.  
  1001.                Now, let's  get acquainted  with the  layout of the MRBackup
  1002.           Utilities window.  If  MRBackup  isn't  already  running  on your
  1003.           Amiga,  fire  it  up  and  select  the Utilities command from the
  1004.           Operations menu.  Refer to the screen while reading this document
  1005.           to maintain your orientation.
  1006.  
  1007.                Note  that  when  the  Utilities  are selected, a new window
  1008.           appears.  Also note the "close  box" (rectangle  with the  dot in
  1009.           the middle)  on the  title bar  of the MRBackup Utilities window.
  1010.           The utilities are exited by clicking in the close box.  Though it
  1011.           is possible  to flip  back and forth between the Utilities window
  1012.           and the main window (for parameter viewing purposes),  you should
  1013.           confine  your  actions  to  the  Utilities  window  until you are
  1014.           through with the services that  it  provides.    Mouse-clicks and
  1015.           menu  operations  in  the  main  window  are  ignored  while  the
  1016.           Utilities window is open.
  1017.  
  1018.                Now let's get oriented.  The top-leftmost  gadget is labeled
  1019.           "DRIVE".   This gadget  allows you to cycle through the currently
  1020.           mounted disk volumes (logical  and physical  drives). This gadget
  1021.           is only  active when either the "From" or "To" switch (later) has
  1022.           been set to "ON".  To the right of the  DRIVE gadget  is a string
  1023.           gadget labeled  "FileSpec".  This gadget allows you to limit your
  1024.           file  searches  ("From"  directory  only)  to  only  those  files
  1025.           matching a  given pattern.  Normally, this pattern, if specified,
  1026.           will include the wildcard characters  "*",  "#?"  and  "?".   For
  1027.           instance (and  we're jumping ahead of ourselves a little), if you
  1028.           want to  decompress a  group of  files, it  is highly recommended
  1029.           that you  first enter  the string "*.Z" into the FileSpec gadget.
  1030.  
  1031.                                          18
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.           This limits visibility to only those files which end in ".Z" (the
  1038.           only files  which can  be decompressed).  If you wanted to delete
  1039.           all  object  files,  you  would  probably  enter  "*.o"  into the
  1040.           FileSpec gadget.   Get  the picture?   For  those who are totally
  1041.           unfamiliar with  wildcard (meta)  characters, an  asterisk (*) or
  1042.           number  sign  and  question  mark  (#?) are used to represent any
  1043.           number  of  characters,  while  a  question  mark  (?) represents
  1044.           exactly one character.  Got the drift?  Good.
  1045.  
  1046.                Below  the  FileSpec  gadget  are  two  triplets of gadgets,
  1047.           labeled "From" and "To".    The  "From"  gadget  is  a  device or
  1048.           directory  pathname  specification  for  a  group  of files to be
  1049.           operated on.  The "To" gadget  specifies the  device or directory
  1050.           which is  the destination for these files (when it is appropriate
  1051.           to have a destination - DELETE has no  destination).   The ON/OFF
  1052.           switches to  the left  of the From and To gadgets determine which
  1053.           path's files are currently displayed in  the file  display box at
  1054.           the bottom  of the  window.   To the  left of the "From" and "To"
  1055.           pathname gadgets are a couple of  upward pointing  arrows.  These
  1056.           gadgets attempt  to obtain the parent directory or device for the
  1057.           pathname currently displayed.  For example, if the  "From" gadget
  1058.           is currently displaying the pathname
  1059.  
  1060.                DH0:Devs/Printers
  1061.  
  1062.           clicking on the arrow gadget will cause
  1063.  
  1064.                DH0:Devs
  1065.  
  1066.           to be  displayed, the  file display  box (big  box at the bottom)
  1067.           will be cleared and a new file scan will be started.   You should
  1068.           also note  that the switch gadget related to that gadget need not
  1069.           be open for this behavior to occur.
  1070.  
  1071.                The next string gadget (down) is labeled "Info".  The "Info"
  1072.           gadget is used to display general information about the status of
  1073.           the Utilities, including  the  name  of  the  current  file being
  1074.           processed and error reports. 
  1075.  
  1076.                Now we  get to the good part.  You should see a big box with
  1077.           a  border in the center of the  screen. Immediately  to its right
  1078.           is a  slider gadget.   To  the right  of the slider are two boxes
  1079.           labeled "All Files" and "Clear".   These  all  make  up  the file
  1080.           requester that  control the Utilities operation.  You've probably
  1081.           used similar file requesters before.    Though  I  wrote original
  1082.           code for  this, I  tip my  hat to Charlie Heath (MicroSmiths) and
  1083.           Peter da Silva for  their pioneering  in this  area.   I borrowed
  1084.           heavily from  their prior  works.  In discussing the operation of
  1085.           the file requester, I  will be  referring back  to the previously
  1086.           described gadgets.
  1087.  
  1088.                In order  to do something here, you first have to select one
  1089.  
  1090.                                          19
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.           or more files to "do it to".  This group of files is described by
  1097.           the "From"  list.  You can start a scan for this list by entering
  1098.           the desired starting path in the From pathname gadget and hitting
  1099.           the RETURN  key or  by clicking  on the associated switch gadget.
  1100.           If you have done  this correctly,  you should  immediately note a
  1101.           bustle  of  activity  as  the  disk is searched and the screen is
  1102.           updated.  You should observe filenames appearing in the requester
  1103.           display box and the slider bar should start to shrink.  Depending
  1104.           on the starting path you  entered  into  the  "From"  gadget, you
  1105.           might notice that some of the filenames are displayed in the same
  1106.           color as the title bar, while others are  displayed in  the color
  1107.           used by the requester and gadget borders.  Those displayed in the
  1108.           menu bar's color are simple filenames,  while the  others are the
  1109.           names of  directories.   If you want a good illustration of this,
  1110.           select FONTS: or DEVS:  as the  starting path.   You  should also
  1111.           note  that  the  filenames  appear  in unsorted order.  They will
  1112.           remain unsorted until you click on the slider.
  1113.  
  1114.                Now let's discuss the  interactive and  interruptible nature
  1115.           of the  file requester.   The normal human tendency is to start a
  1116.           scan, then sit back until some indication is given that  the scan
  1117.           is complete, then start mucking with the list of files.  Don't be
  1118.           so polite!  You can do just about anything, including clicking on
  1119.           those big  boxes to  the right  (command buttons)  that I haven't
  1120.           described yet.  To select a file, position the mouse pointer over
  1121.           its name  in the  display box  and click once.  You should notice
  1122.           that the filename is now displayed in reverse video.   This means
  1123.           that the  file is  selected.   If you  click the  same file again
  1124.           (after a short pause), the file will revert to normal  video (the
  1125.           unselected state - sort of like Rhode Island :-).  If you wish to
  1126.           select multiple files, depress the SHIFT  key (either  one) prior
  1127.           to  clicking  the  mouse.    Otherwise,  the  previously selected
  1128.           file(s) will be deselected.   If  you wish  to select  ALL files,
  1129.           wait until  the scan is complete, then click in the little box to
  1130.           the  right  of  the  "All  Files"  gadget.    To  clear  all file
  1131.           selections, click  in the  little box to the right of the "Clear"
  1132.           gadget.
  1133.  
  1134.                You will  notice that  only 12  filenames can  appear in the
  1135.           display  box  at  any  time.    By  using  the  slider,  you  can
  1136.           view/select other files in the list.  You  do this  by "dragging"
  1137.           the slider  bar -  click the  mouse on  it and, while holding the
  1138.           mouse button down, drag the mouse pointer downward.  As  you drag
  1139.           it, other  filenames should  be revealed (depending upon how many
  1140.           files exist in the  currently selected  directory).   The size of
  1141.           the  slider  bar  is  proportional  to the number of files in the
  1142.           directory.  If half  of the  files are  visible, the  bar will be
  1143.           one-half the  size of  the slider box.  Also, note that if a scan
  1144.           is in progress, the file list will be resorted (case-insensitive)
  1145.           each time you click on the slider.
  1146.  
  1147.                To descend  to deeper levels in the directory structure, you
  1148.  
  1149.                                          20
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.           can either type a new name in the From gadget  (the hard  way) or
  1156.           you can  double-click (two  mouse clicks in rapid succession) any
  1157.           of the red (directory name) entries  visible in  the display box.
  1158.           A new  scan will  immediately be started even if the current scan
  1159.           is not complete.  To go back up the directory tree, click the up-
  1160.           arrow  gadget  described  earlier.    Again, the current scan (if
  1161.           active) will be abandoned and  a  new  one  started  at  the next
  1162.           higher level.
  1163.  
  1164.                The preceding  discussion has focused on the behavior of the
  1165.           file requester when  the  "From"  list  is  active.    Though its
  1166.           behavior  for  the  "To"  list  is similar, there are some strong
  1167.           differences.  First of all, the  object  of  a  "To"  scan  is to
  1168.           select a target DIRECTORY (not a file).  Although both file names
  1169.           and directory names appear in the display list when doing  a "To"
  1170.           scan,  only  directory  names  can  be  selected.  Also, extended
  1171.           selection  (via  SHIFT  key  or  the   "All  Files"   gadget)  is
  1172.           meaningless here  and so  it is  not supported.  You just use the
  1173.           "To"  scan  to  locate  a   target   directory.      Once  found,
  1174.           double-clicking on  the directory  name will cause it to be added
  1175.           to the "To" pathname.    The  interruptible  nature  of  the file
  1176.           requester is also supported for this mode.
  1177.  
  1178.                Before getting to the processing options (soon, I promise!),
  1179.           there is one other file requester behavior to note.  If you start
  1180.           a scan  for one list, then start a scan for the other list before
  1181.           the first one is complete, the partial results of the  first scan
  1182.           will be  abandoned.   If the scan is allowed to complete, you may
  1183.           then activate the other list, do some navigating, then reactivate
  1184.           the other list.  It will be redisplayed immediately without a re-
  1185.           scan.  This may not be what you  want, especially  if both "From"
  1186.           and "To"  lists are  on diskettes  which have  been swapped in or
  1187.           out.  To force a rescan, just position the mouse pointer into the
  1188.           appropriate "From"  or "To"  pathname gadget and press the RETURN
  1189.           key.
  1190.  
  1191.                OK, let's get back to those labeled buttons at the bottom of
  1192.           the window.   Those are the "command buttons" which tell MRBackup
  1193.           to start performing specific processing  on  the  files  you have
  1194.           selected.    For  all  operations,  the  name  of  the file being
  1195.           processed is displayed in the "Info" gadget.  If an  error occurs
  1196.           that MRBackup  considers "tolerable", you will be prompted with a
  1197.           requester  that  will  give  you  the  choice  of  continuing  or
  1198.           aborting.  
  1199.  
  1200.                As each file is processed, its name is removed from the list
  1201.           and the display box is refreshed.   When  processing is complete,
  1202.           one of two things will happen.  If there were errors, the display
  1203.           box will be left displaying the names of the files  that were not
  1204.           processed.   If all went well, a new scan will be started for the
  1205.           "From" list. 
  1206.  
  1207.  
  1208.                                          21
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.                You may interrupt a command button's processing at  any time
  1215.           by clicking  on it again.  This will cause a requester to pop up,
  1216.           asking if you wish to abort the operation.  A "Yes" response will
  1217.           terminate the  current command,  while a "No" response will allow
  1218.           processing to continue.
  1219.            
  1220.                Please note that no support currently  exists for processing
  1221.           a complete  hierarchy of  subdirectories.  Though you are allowed
  1222.           to select directory entries,  the  utilities  won't automatically
  1223.           descend to  the next level and process files there. You will have
  1224.           to "manually" descend to the next lower level  by double-clicking
  1225.           on the directory entry.
  1226.  
  1227.                The description  of the command buttons and their processing
  1228.           follows:
  1229.  
  1230.  
  1231.           Compress
  1232.  
  1233.                The  selected  files  will  be  compressed,  using  the same
  1234.           Lempel-Ziv method used by the Backup command.  The number of bits
  1235.           used is determined by the Compression gadget setting  in the main
  1236.           window.  Unlike  the  Backup  command,  however, files that don't
  1237.           compress properly are not copied  instead.    The  file  date and
  1238.           comment are maintained. The destination file will have the suffix
  1239.           ".Z" appended to its name.  Also -  and this  is important!  - if
  1240.           the "From"  and "To"  specifications are  identical, the original
  1241.           file will be deleted if the compression is  successful.   This is
  1242.           standard Unix  compress behavior which seems quite appropriate to
  1243.           me.
  1244.  
  1245.  
  1246.           Decompress
  1247.  
  1248.                The  selected  files  will  be  decompressed.    The maximum
  1249.           compression code  size allowed is determined by the Decompression
  1250.           gadget setting  in the  main window.  Note that  only files whose
  1251.           names end in ".Z" will be processed, regardless of what may be in
  1252.           your selection list.  It is  a good  idea to  type ".Z"  into the
  1253.           FileSpec  gadget  to  limit  visibility only to compressed files.
  1254.           This will  prevent  confusion.  The  file  date  and  comment are
  1255.           maintained.  Again,  as  with  compress,  if  the "From" and "To"
  1256.           specifications are the same,  the original  file will  be deleted
  1257.           after a successful decompression.
  1258.  
  1259.  
  1260.           Copy
  1261.  
  1262.                The  selected  files  will  be copied to the "To" directory,
  1263.           which MUST BE DIFFERENT  than the  "From" directory.   File dates
  1264.           and comments are maintained.
  1265.  
  1266.  
  1267.                                          22
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.           Rename
  1275.  
  1276.                The selected  files are  renamed (moved) to a new directory.
  1277.           The "From"  and "To"  directories MUST  BE DIFFERENT.   Also note
  1278.           that you  cannot rename across device boundaries.  If you wish to
  1279.           do this, use a combination of the Copy and Delete operations.
  1280.  
  1281.  
  1282.           Delete
  1283.  
  1284.                The selected files are deleted.  Period.   Please be careful
  1285.           with this  as there is currently no "last chance" prompt prior to
  1286.           the operation.  
  1287.  
  1288.  
  1289.           SetArcBit
  1290.  
  1291.                The AmigaDOS "archive bit"  will  be  set  for  all selected
  1292.           files.  This could be used to inhibit the backup of certain files
  1293.           when the "Use Archive Bits" flag is set.
  1294.  
  1295.  
  1296.           ClrArcBit
  1297.  
  1298.                The AmigaDOS "archive bit" will be cleared for  all selected
  1299.           files.   This would  assure that certain files would be backed up
  1300.           when the "Use Archive Bits" flag  is set.   Another  use for this
  1301.           operation  is  to  "unmark"  files  that  were marked as archived
  1302.           during a failed backup operation.  This would be done  before the
  1303.           "Resume Backup" command is used.
  1304.  
  1305.                There's room for lots more stuff here, but the usual lack of
  1306.           time keeps me from getting them in this release.  I would like to
  1307.           add  a  MakeDir  command  and  possibly  add an "Execute" command
  1308.           button which would fire a command off to a CLI.  Also  nice would
  1309.           be  some  running  statistics  (file  count,  bytes in/out, etc.)
  1310.           during file processing.  Support for  nested directories  is next
  1311.           on the  agenda.  Please give me your feedback on your impressions
  1312.           and any suggestions you might have.
  1313.  
  1314.  
  1315.           Using RAD: for Speedy Backups
  1316.  
  1317.                John Hopf of Newport, RI, called me to  report a  "bug" with
  1318.           MRBackup when  he used  RAD: as his backup destination.  Huh?  It
  1319.           seems that John  discovered  that  MRBackup  is  blazingly (well,
  1320.           quite)  fast  when  RAD:  is  used  as the output device.  John's
  1321.           approach is to backup to  RAD:,  then  DiskCopy  from  RAD:  to a
  1322.           floppy diskette.   Though  the process sounds klunky, the overall
  1323.           reduction in time is remarkable (about a factor of 6).
  1324.  
  1325.  
  1326.                                          23
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.                The only  thing keeping  John from  employing this technique
  1333.           fully was the failure of MRBackup to properly format RAD:.  Well,
  1334.           that's  no  longer  a  problem.    If  you  wish  to  employ this
  1335.           technique, add an entry to your DEVS:MountList file which creates
  1336.           a RAD: drive with a structure identical to a 3.5" floppy disk. Be
  1337.           sure to Mount the drive when you boot your system. Start MRBackup
  1338.           with "Run  MRBackup",  leaving  the  CLI  free  for  the DiskCopy
  1339.           command.   Now, proceed to do your backups.  MRBackup will prompt
  1340.           for a new disk each time RAD:  is  full.    At  this  point, push
  1341.           MRBackup's screen to the back, pop a floppy disk into a drive and
  1342.  
  1343.                diskcopy from rad: to <floppydrive>
  1344.  
  1345.           When the  copy completes,  pop MRBackup's screen to the front and
  1346.           click the  OK  gadget  on  the  requester,  allowing  MRBackup to
  1347.           proceed.
  1348.  
  1349.                Thanks for an excellent idea, John!
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.                                          24
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.           Warranties and Support
  1393.  
  1394.                There are  no warranties,  either expressed or implied, with
  1395.           regard to the use of this  program. Use  it at  your own  risk. I
  1396.           have tested  MRBackup thoroughly, but not exhaustively.  A bug or
  1397.           two is bound to be lurking  around, though  none that  would shut
  1398.           you down completely.
  1399.            
  1400.                As for  support, I will do my best to respond to bug reports
  1401.           for as long as I have  an  Amiga  in  working  condition  (I hope
  1402.           that's  a  l-o-n-g  time).  If  you  have  a  situation which has
  1403.           worsened as a result of using  MRBackup,  I  will  work  with you
  1404.           immediately to  rectify the problem. I will only support the most
  1405.           recent version, so please know your version number if you call. 
  1406.  
  1407.                MRBackup is a "laid  back shareware"  program. I  would like
  1408.           some compensation  for my efforts, especially for the effort that
  1409.           went into version 3.0.   A  donation of  $10.00 would  be greatly
  1410.           appreciated. However, I welcome feedback from all MRBackup users,
  1411.           so  don't  be  reluctant  to  call  or  write  if  you're  a non-
  1412.           contributing  user.  Matter  of  fact,  you can consider the long
  1413.           distance phone call (Rhode Island is long distance  to everywhere
  1414.           - even Rhode Island :-( ) to be a contribution!  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.                                          25
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.           MRBackup Roll of Honor
  1452.  
  1453.                The  following   users  have  sent  shareware  contributions
  1454.           exceeding the  requested $2.00  for a  copy of  MRBackup. I would
  1455.           like  to  publicly  thank  them  by including their names in this
  1456.           "MRBackup Roll of Honor".
  1457.  
  1458.                Toby Cabot,              Warwick, RI
  1459.                Henrik Clausen,          Denmark
  1460.                Paul Coene,              Rochester, NY
  1461.                James De Marco,          N. Chelmsford, MA
  1462.                Allan Duncan,            Australia
  1463.                Andrew Drummond,         Cayman Islands, British West Indies
  1464.                Clive Ellis,             Escondido, CA
  1465.                Don Estok,               USCG, Kodiak, AK 
  1466.                Robert Farrel,           Tivoli, NY
  1467.                Otto Gruber,             Wappingers Falls, NY
  1468.                Volker Herrmann,         Giessen, West Germany
  1469.                Ray Hulinsky,            Lincoln, NE
  1470.                Alan Kelm,               Ottawa, Ontario
  1471.                Tony Koehn,              Hutchinson, KS
  1472.                Ken Lazzaro,             El Cajon, CA
  1473.                Henry Marszal,           Vermilion, OH
  1474.                Justin Parker,           Santa Fe, NM
  1475.                Grant Robertson,         Los Angeles, CA
  1476.                John Sauter,             Merrimack, NH
  1477.                W.H. Stanton,            St. Albans, England 
  1478.                Lorrie Shattuck,         Walled Lake, MI
  1479.                Alexander Smith,         Ottawa, Ontario
  1480.                Milt Very,               Oakdale, CA
  1481.                Ralph Watson,            Chesterfield, SC
  1482.                Tom Zartler,             West Chester, PA
  1483.  
  1484.                Roll  of  honor   members   will   receive   special  notice
  1485.           (unsolicited/free  updates,   in  some  cases)  of  new  MRBackup
  1486.           releases and other PD stuff that I may find the time to write. 
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.                                          26
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.           Permissions
  1511.  
  1512.                You  are  permitted  to  use  MRBackup  and  redistribute it
  1513.           freely. No charge (other than reasonable duplication fees - $5.00
  1514.           or less) may be made for MRBackup. 
  1515.  
  1516.                If you wish to contact me, I can be reached at the following
  1517.           addresses:
  1518.  
  1519.                Usenet: mrr@amanpt1.Newport.RI.US  (always)
  1520.                Compu$erve:    72017, 136          (infrequently)
  1521.                BUX:           markr               (infrequently)
  1522.  
  1523.                or
  1524.  
  1525.                Mark R. Rinfret
  1526.                348 Indian Avenue
  1527.                Portsmouth, RI 02871
  1528.                401-846-7639 (home) (1900-2200 weekdays, 0700-2200 weekends)
  1529.                401-849-8900 (work) (0700-1730)
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.                                          27
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.           Changes
  1570.  
  1571.                This section  lists changes, in reverse chronological order,
  1572.           as they have appeared  in official  releases of  MRBackup. I have
  1573.           attempted to be thorough, but may have missed a few key items.
  1574.  
  1575.           Version 3.3d
  1576.  
  1577.                This release came about largely as a result of conversations
  1578.           I had with Tom Zartler of West Chester, Pa. Tom reported a couple
  1579.           of bugs and offered some suggestions that will show up in version
  1580.           4.0 (which is well on its way!).
  1581.  
  1582.                The Rename function in the Utilities  window was brain-dead.
  1583.           It's been fixed.
  1584.  
  1585.                If you  copied a  file using  the utilities  and the From/To
  1586.           selections were on the  same disk,  the result  (for large files,
  1587.           anyway) was  a slow,  tedious grind.  This was  due to the use of
  1588.           asynchronous  I/O   in  a   situation  where   it  obviously  was
  1589.           counterproductive.      MRBackup      now     chooses     between
  1590.           synchronous/asynchronous I/O. Asynchronous I/O  is used  when the
  1591.           From and To devices are different.
  1592.  
  1593.                Tom  suggested  that  when  the  Set Archive Bits option was
  1594.           enabled, the backup copy of the file should have its  archive bit
  1595.           set,  as  well  as  the  original  file.  I  think  someone  else
  1596.           recommended this also, but I was too dense at the time to realize
  1597.           what was  being said.  What's implied here is the fact that since
  1598.           the file exists on a backup disk, it  IS archived.  If you should
  1599.           restore  from  that  disk,  the  archive  status  is still valid.
  1600.           Agreed!
  1601.  
  1602.                If you left Utilities with  either  of  the  "scan switches"
  1603.           enabled,  upon  return  you  would find that they didn't function
  1604.           properly. MRBackup now resets the switches prior to first use.
  1605.  
  1606.                I may catch some  flak for  the most  obvious change. You'll
  1607.           notice  that  all  of  the  gadget  borders  are  gone.  I dunno-
  1608.           sometime a week or two ago, I decided that all those boxes on the
  1609.           screen were U-G-L-Y! I hope you agree.
  1610.  
  1611.                MRBackup is  more efficient  in its use of buffer memory for
  1612.           copying/compressing files. 
  1613.  
  1614.                Some of you complained  that the  abrupt color  change after
  1615.           MRBackup loaded its parameter file was unsettling. I had some fun
  1616.           with this one and implemented a more gradual color shift that has
  1617.           a nice  effect. It's more pronounced, the more your colors differ
  1618.           from MRBackup's defaults.
  1619.  
  1620.  
  1621.                                          28
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.            
  1629.           Version 3.3c
  1630.  
  1631.                If I  keep up  at this  rate, I'm  gonna' run  out of single
  1632.           letters of  the alphabet  (groan). The minor enhancement added in
  1633.           version 3.3a (detection of  disk  inserted)  is  probably  a nice
  1634.           idea. Unfortunately,  the system tells you about ANY diskinserted
  1635.           event. When  using RAD:,  you get  bitten since  the requester is
  1636.           really a "dummy", blocking the formatting of RAD: while you sneak
  1637.           behind MRBackup's back and do a DiskCopy to a floppy.  As soon as
  1638.           you'd  insert   the  floppy  disk,  the  requester  would  see  a
  1639.           diskinserted event and start formatting RAD:.
  1640.  
  1641.                My approach to this was to inhibit detection of diskinserted
  1642.           events if the request is for an output disk.  Input disk requests
  1643.           (generated by Restore) will be satisfied by a disk insertion.
  1644.  
  1645.  
  1646.           Version 3.3b
  1647.  
  1648.                Sigh... Version 3.3a lasted all of a day.  Under  my pile of
  1649.           "input" was  a letter from Andrew Drummond of the Cayman Islands,
  1650.           describing a problem with Resume Backup.  He claimed  that if you
  1651.           were not  positioned at  the "root"  (e.g. CD DH1:) when invoking
  1652.           Resume Backup, an error would occur.  He  was right.  Thanks very
  1653.           much, Andrew! Version 3.3b corrects the problem. There was also a
  1654.           related problem that would cause a  Task Held  requester when the
  1655.           resume failed. That has been fixed, also. 
  1656.  
  1657.                Also,  Andrew  and  others  have  claimed to get a GURU when
  1658.           clicking  the  close  gadget  of  the  main  window  (terminating
  1659.           MRBackup).  I  have  beat  upon  MRBackup in every way that I can
  1660.           think of to duplicate this problem  and I  can't recreate  it. If
  1661.           others of  you experience  this problem with version 3.3b, PLEASE
  1662.           give me some feedback. Painful detail is required.  For instance,
  1663.           what  sequence  of  steps  got  you  the  GURU? Was anything else
  1664.           running at the time? 
  1665.  
  1666.                I apologize for the bugs in  previous versions  of MRBackup.
  1667.           I know  how frustrating  they can  be for you, the user. The fact
  1668.           is, I've been trying to do too much with too little time and have
  1669.           been  careless  in  my  approach  to changes. MRBackup is a large
  1670.           program with a lot of interaction between many source modules and
  1671.           support libraries.  Work on  a program  this size really requires
  1672.           full-time concentration and I've been lucky to steal an hour at a
  1673.           time,  here  and  there,  to  effect  changes.  I guess I've been
  1674.           relying too much on a saturated memory. And, it's almost time for
  1675.           my 40 year overhaul. 'Nuff excuses.
  1676.  
  1677.                What really  surprises me  is the  encouragement I've gotten
  1678.           from users who have been "bitten"  by bugs  in MRBackup.  I often
  1679.  
  1680.                                          29
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.           hear "MRBackup  is a  great program, but there are these few bugs
  1687.           I'd like to tell you about...and here's a contribution."  Wow!
  1688.           That's tolerance! Thank you  all for  your continued  support and
  1689.           feedback. I'll continue to try to do my part.
  1690.  
  1691.  
  1692.           Version 3.3a
  1693.  
  1694.                In  case  you  were  wondering  -  a  letter at the end of a
  1695.           version number implies bug fixes only.  Much as  I hate  to admit
  1696.           it, there  were still  bugs in  the handling of big files. If you
  1697.           got an error 205 on the "big file", you saw the problem. Though I
  1698.           did extensive  testing of  this feature, it was with a "relative"
  1699.           home path, which masked the problem.  My thanks  to Justin Parker
  1700.           of Santa Fe, New Mexico, for pointing out the problem. Dare I say
  1701.           the problem  is fixed?  Waalll...you be  the judge.  As always, I
  1702.           apologize for any problems this may have caused you. 
  1703.  
  1704.                Actually,  I  did  sneak  in  one  minor enhancement. During
  1705.           restore,  the  "next  disk"  requester  will   recognize  a  disk
  1706.           insertion and automatically terminate.
  1707.            
  1708.  
  1709.           Version 3.3
  1710.  
  1711.                I  finally  ran  MRBackup  through  lint (Gimpel) and, after
  1712.           wading through lots of "noise", found several bugs  that may have
  1713.           been haunting  MRBackup for quite a while. Hopefully, the changes
  1714.           I made will eliminate some of the mysterious gurus reported  by a
  1715.           few users.  Thanks for your patience.
  1716.  
  1717.           Version 3.2
  1718.  
  1719.                The  primary   change  is  in  MRBackup's  disk  formatting.
  1720.           MRBackup can now  format  drives  other  than  3.5"  floppies. In
  1721.           particular, those  with sufficient  memory may  want to try using
  1722.           the RAD: device as an intermediate destination for  backups.  See
  1723.           the  section  entitled  "Using  RAD:  for Speedy Backups". Though
  1724.           MRBackup has not been  tested with  a 5  1/4" drive,  that should
  1725.           work, also.  If you  have access  to one, I would appreciate your
  1726.           feedback on MRBackup's ability to use it.
  1727.  
  1728.  
  1729.           Version 3.1
  1730.  
  1731.                The color requester has been fixed up a little.   The system
  1732.           will  not  hang  when  the  right mouse button is clicked and the
  1733.           color requester is active.
  1734.  
  1735.                There was a problem when handling  "file in  use".  MRBackup
  1736.           would quit when the intent was to ignore the error.
  1737.  
  1738.  
  1739.                                          30
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.                The first page header was incomplete.
  1746.  
  1747.                MRBackup now  checks for  the existence of the listing file.
  1748.           If it exists, the user is prompted for the decision  to overwrite
  1749.           or append to the listing file.
  1750.  
  1751.  
  1752.           Version 3.0
  1753.  
  1754.                This  version  incorporated  some  massive changes. The user
  1755.           interface  has  been  totally  redone.    All  program  parameter
  1756.           settings are  now done via gadgets and requesters (vs. the former
  1757.           Flags menu) in the  main  window.    The  Pathname Specifications
  1758.           window  is   history.  Pathname  specification  gadgets  are  all
  1759.           complemented by the ARP file requester. 
  1760.  
  1761.                MRBackup's screen now has  only 4  colors (vs.  8). This was
  1762.           done to  reduce memory  consumption. To offset this, MRBackup now
  1763.           has a color palette which will allow you to customize its colors.
  1764.           You may  then save  your color settings with the Save Preferences
  1765.           menu command.    The  Progress  Window  is  gone.    A  new, more
  1766.           generalized  logging  capability  has  taken  its  place. See the
  1767.           section describing the "Log Path".
  1768.  
  1769.                MRBackup employs overlays as  a  memory  conserving feature.
  1770.           This  technique  allows  program  segments to be "rolled in" from
  1771.           disk  when  needed.  MRBackup  frees  unneeded  overlay segments,
  1772.           thereby giving memory back to the system for use by other tasks.
  1773.  
  1774.                MRBackup is  now dependent  upon the ARP library, created by
  1775.           MicroSmiths, Inc.  You  must  have  arp.library  present  in your
  1776.           Libs: directory in order to run MRBackup.
  1777.  
  1778.                The  compression/decompression  algorithm  in  MRBackup  now
  1779.           supports compression codes up to 16  bits wide.   This  was added
  1780.           primarily as a convenience to Unix system users who typically use
  1781.           16 bit compression.  
  1782.  
  1783.                Disk  reads  and   writes   are   now   done  asynchronously
  1784.           (overlapped).    This  feature  is  probably  more  academic than
  1785.           practical. Since you're most  likely  going  to  be  using floppy
  1786.           drives as your backup medium, MRBackup will spend a great deal of
  1787.           its time waiting for the floppy drive, negating the advantages of
  1788.           overlapped  I/O.    Ah  well,  it  doesn't hurt.  I would like to
  1789.           extend a special "Thank You" to Matt Dillon.  I  borrowed heavily
  1790.           from his async I/O routines which were distributed on Usenet.
  1791.  
  1792.                There is a new Quick format option which greatly reduces the
  1793.           time required to format a diskette. 
  1794.  
  1795.                A new Pause gadget has been added, allowing you to suspend a
  1796.           backup or restore operation.
  1797.  
  1798.                                          31
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.                The voice  option now  uses the new SPEAK: device introduced
  1806.           with KickStart version 1.3.  SPEAK: must be  mounted in  order to
  1807.           enable the voice option.
  1808.  
  1809.                MRBackup now allows you some control over the naming of your
  1810.           backup  disks.    If  you  don't   care  for   MRBackup's  naming
  1811.           convention,  there  is  a  Backup Volume Prefix gadget which will
  1812.           allow you to specify the  primary  part  of  a  backup diskette's
  1813.           volume  name.    MRBackup  still  sequences  backup  diskettes by
  1814.           appending the diskette number to the volume name.
  1815.  
  1816.                Some incompatibilities exist with old MRBackup support files
  1817.           (MRBackup.init,  MRBackup.xcld,   MRBackup.cflt).    The  comment
  1818.           character  for  these  files  is  now  the  semi-colon,  which is
  1819.           consistent  with  the  comment  character  used  by the CLI. This
  1820.           change was necessitated  by  the  introduction  of AmigaDOS-style
  1821.           wildcard  patterns  which  use  the number sign (previous comment
  1822.           character) as a meta-character.
  1823.  
  1824.                The old "Use Archive Bits" option has given  way to  two new
  1825.           gadgets, "Test Archive Bits" and "Set Archive Bits".  This allows
  1826.           you to independently test  and set  file archive  bits when doing
  1827.           backups.
  1828.  
  1829.                If you  have tried  to use  the Big Files option in the past
  1830.           without success, try it again.   I  spent  quite  a  bit  of time
  1831.           testing this and it appears to be quite solid.  For my test case,
  1832.           I created a 2.4 MB file which required 3 floppy disks to back up.
  1833.           After backup,  the original  was renamed  and the backup copy was
  1834.           restored.  The files were then compared using  cmp (Aztec compare
  1835.           utility) with no differences reported. 
  1836.  
  1837.                Many other minor changes and bug fixes have been added.
  1838.  
  1839.  
  1840.           Bugs
  1841.  
  1842.                There are  none that  I know  of, but there might still be a
  1843.           gnat or two lurking in MRBackup. PLEASE! - If you discover a bug,
  1844.           let me know about it!  I'll fix it!  I promise!
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.                                          32
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.                                         Index
  1864.  
  1865.           "All Files" gadget  . . . . . . . . . . . . . . . . . . .  19, 20
  1866.           "Clear" gadget  . . . . . . . . . . . . . . . . . . . . . . .  20
  1867.           "Current File" gadget . . . . . . . . . . . . . . . . . .  19, 21
  1868.           "From" gadget . . . . . . . . . . . . . . . . . . . . . . . .  19
  1869.           "NOW" gadget  . . . . . . . . . . . . . . . . . . . . . . . . . 4
  1870.           "To" gadget . . . . . . . . . . . . . . . . . . . . . . . . .  19
  1871.           Abort
  1872.                error handling . . . . . . . . . . . . . . . . . . . . .  13
  1873.           Archive bit . . . . . . . . . . . . . . . . . . . . . . . . .  23
  1874.           Archive Bits  . . . . . . . . . . . . . . . . . . . . . . . .  10
  1875.           Arp.library . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1876.           ARP-style wildcarding . . . . . . . . . . . . . . . . . . . . . 6
  1877.           Arrow gadget  . . . . . . . . . . . . . . . . . . . . . . . .  19
  1878.           Backing Up a Disk . . . . . . . . . . . . . . . . . . . . . .  16
  1879.           Backup  . . . . . . . . . . . . . . . . . . . . . . . . .  14, 15
  1880.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  14
  1881.           Backup Path . . . . . . . . . . . . . . . . . . . . . . .  16, 17
  1882.           Backup Path gadget  . . . . . . . . . . . . . . . . . . . . . . 5
  1883.           Backup Volume Prefix  . . . . . . . . . . . . . . . . . . . . . 7
  1884.           Beginning of history  . . . . . . . . . . . . . . . . . . . . . 4
  1885.           Big files . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1886.           Big Files gadget  . . . . . . . . . . . . . . . . . . . . . .  11
  1887.           Blocks gadget . . . . . . . . . . . . . . . . . . . . . . . . . 6
  1888.           Changes . . . . . . . . . . . . . . . . . . . . . . . . . . .  28
  1889.           Charlie Heath . . . . . . . . . . . . . . . . . . . . . . . .  19
  1890.           ClrArcBit
  1891.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  23
  1892.           Code sizes
  1893.                compression  . . . . . . . . . . . . . . . . . . . . . .  14
  1894.           Codes, compression  . . . . . . . . . . . . . . . . . . . . .  13
  1895.           Colors
  1896.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  14
  1897.           Command buttons . . . . . . . . . . . . . . . . . . .  20, 21, 22
  1898.           Comment lines . . . . . . . . . . . . . . . . . . . . . . . . . 8
  1899.           Comments  . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  1900.           Compress  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  1901.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  22
  1902.           Compression Filter  . . . . . . . . . . . . . . . . . . . . . . 6
  1903.           Compression filter file
  1904.                format of  . . . . . . . . . . . . . . . . . . . . . . . . 7
  1905.           Compression gadget  . . . . . . . . . . . . . . . . . . .  11, 22
  1906.           Compression/Decompression
  1907.                description  . . . . . . . . . . . . . . . . . . . . . .  13
  1908.           Copy
  1909.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  22
  1910.           Creation/modification date  . . . . . . . . . . . . . . . . .  17
  1911.           Current Backup Volume . . . . . . . . . . . . . . . . . . . . . 5
  1912.           Current File gadget . . . . . . . . . . . . . . . . . . . . . . 5
  1913.           Date and time format  . . . . . . . . . . . . . . . . . . . . . 4
  1914.           Decompress  . . . . . . . . . . . . . . . . . . . . . . . . .  18
  1915.  
  1916.                                          33
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  22
  1923.           Decompression gadget  . . . . . . . . . . . . . . . . . .  11, 22
  1924.           Delete
  1925.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  23
  1926.           Disk sequence number  . . . . . . . . . . . . . . . . . . . .  14
  1927.           Document file . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1928.           Error Count . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  1929.           Error Count gadget  . . . . . . . . . . . . . . . . . . . . .  13
  1930.           Error Handling gadget . . . . . . . . . . . . . . . . . . . .  13
  1931.           Exclude Filter file
  1932.                format of  . . . . . . . . . . . . . . . . . . . . . . . . 7
  1933.           Exclude Filter gadget . . . . . . . . . . . . . . . . . . . . . 7
  1934.           Extended selection  . . . . . . . . . . . . . . . . . . . . .  18
  1935.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  21
  1936.           File creation date  . . . . . . . . . . . . . . . . . . . . .  17
  1937.           File display box  . . . . . . . . . . . . . . . . . . . . . .  19
  1938.           File requester  . . . . . . . . . . . . . . . . . . . . . . .  19
  1939.           FileSpec  . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  1940.           FileSpec gadget . . . . . . . . . . . . . . . . . . . . . . .  18
  1941.           Formatting gadget . . . . . . . . . . . . . . . . . . . . . .  12
  1942.           From gadget . . . . . . . . . . . . . . . . . . . . . . . . .  19
  1943.           Home Path . . . . . . . . . . . . . . . . . . . . . . . .  16, 17
  1944.           Home Path gadget  . . . . . . . . . . . . . . . . . . . . . . . 5
  1945.           Ignore
  1946.                error handling . . . . . . . . . . . . . . . . . . . . .  13
  1947.           Incremental backup  . . . . . . . . . . . . . . . . . . . . .  10
  1948.           Initialization parameters . . . . . . . . . . . . . . . . . .  15
  1949.           Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1950.           Installation  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1951.           Interactive
  1952.                error handling . . . . . . . . . . . . . . . . . . . . .  13
  1953.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1954.           Lempel-Ziv  . . . . . . . . . . . . . . . . . . . . . . .  13, 22
  1955.           Lempel-Ziv compression  . . . . . . . . . . . . . . . . . . . . 6
  1956.           Listing gadget  . . . . . . . . . . . . . . . . . . . . .  10, 16
  1957.           Listing Path  . . . . . . . . . . . . . . . . . . . . . . . 6, 16
  1958.           Listing Path gadget . . . . . . . . . . . . . . . . . . . . . . 6
  1959.           Load Preferences  . . . . . . . . . . . . . . . . . . . . . .  15
  1960.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  15
  1961.           Main Window Settings  . . . . . . . . . . . . . . . . . . . . . 3
  1962.           Matt Dillon . . . . . . . . . . . . . . . . . . . . . . . . .  31
  1963.           Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  1964.           MRBackup Roll of Honor  . . . . . . . . . . . . . . . . . . .  26
  1965.           MRBackup Utilities  . . . . . . . . . . . . . . . . . . . . .  18
  1966.           MRBackup.bigfile  . . . . . . . . . . . . . . . . . . . . . .  11
  1967.           MRBackup.context  . . . . . . . . . . . . . . . . . . . . . .  14
  1968.           MRBackup.init . . . . . . . . . . . . . . . . . . . . . . . .  15
  1969.           MRBackup.xcld . . . . . . . . . . . . . . . . . . . . . . . . . 7
  1970.           ON/OFF switches . . . . . . . . . . . . . . . . . . . . . . .  19
  1971.           Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  1972.           Operations Menu . . . . . . . . . . . . . . . . . . . . . . .  14
  1973.           Output Capacity gadget  . . . . . . . . . . . . . . . . . . . . 5
  1974.  
  1975.                                          34
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.           Parent directory  . . . . . . . . . . . . . . . . . . . . . .  19
  1982.           Pathname specifications . . . . . . . . . . . . . . . . . . .  16
  1983.           PAUSE gadget  . . . . . . . . . . . . . . . . . . . . . . . .  17
  1984.           Permissions . . . . . . . . . . . . . . . . . . . . . . . . .  27
  1985.           Peter da Silva  . . . . . . . . . . . . . . . . . . . . . . .  19
  1986.           Preferences . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1987.           Preferences gadget  . . . . . . . . . . . . . . . . . . . . .  15
  1988.           Protection bits . . . . . . . . . . . . . . . . . . . . . . .  17
  1989.           Quick format option . . . . . . . . . . . . . . . . . . . . .  16
  1990.           Quit  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1991.           Rename
  1992.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  23
  1993.           Restore . . . . . . . . . . . . . . . . . . . . . . .  11, 15, 17
  1994.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  15
  1995.           Restoring the Backups . . . . . . . . . . . . . . . . . . . .  17
  1996.           Resume Backup . . . . . . . . . . . . . . . . . . . .  14, 15, 23
  1997.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  14
  1998.           Retries gadget  . . . . . . . . . . . . . . . . . . . . . . .  13
  1999.                error handling . . . . . . . . . . . . . . . . . . . . .  13
  2000.           Retry
  2001.                error handling . . . . . . . . . . . . . . . . . . . . .  13
  2002.           Save Preferences  . . . . . . . . . . . . . . . . . . . . . .  15
  2003.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  15
  2004.           Select multiple files . . . . . . . . . . . . . . . . . . . .  20
  2005.           Set Archive Bits  . . . . . . . . . . . . . . . . . . . . . .  10
  2006.           SetArcBit
  2007.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  23
  2008.           Settings  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  2009.           Slider  . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  2010.           Slider bar
  2011.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  20
  2012.           Speak . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  2013.           SPEAK: device . . . . . . . . . . . . . . . . . . . . . . . .  11
  2014.           Status gadget . . . . . . . . . . . . . . . . . . . . . . . . . 4
  2015.           STOP gadget . . . . . . . . . . . . . . . . . . . . . . . . .  17
  2016.           Support files . . . . . . . . . . . . . . . . . . . . . . . . . 2
  2017.           Switch gadget
  2018.                Utilities  . . . . . . . . . . . . . . . . . . . . . . .  20
  2019.           Test Archive Bits . . . . . . . . . . . . . . . . . . . . . .  10
  2020.           Test Date . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  2021.           To gadget . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  2022.           Up-arrow gadget . . . . . . . . . . . . . . . . . . . . . . .  21
  2023.           User Interface  . . . . . . . . . . . . . . . . . . . . . . . . 3
  2024.           Using RAD: for Speedy Backups . . . . . . . . . . . . . . . .  23
  2025.           Utilities . . . . . . . . . . . . . . . . . . . . . . . .  15, 18
  2026.                Operations Menu  . . . . . . . . . . . . . . . . . . . .  15
  2027.           Utilities Operation . . . . . . . . . . . . . . . . . . . . .  18
  2028.           Voice gadget  . . . . . . . . . . . . . . . . . . . . . . . .  11
  2029.           Volume names  . . . . . . . . . . . . . . . . . . . . . . . .  17
  2030.           Warranties and Support  . . . . . . . . . . . . . . . . . . .  25
  2031.           Yesterday . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  2032.  
  2033.  
  2034.                                          35
  2035.  
  2036.