home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / FB101.ZIP / FULLBACK.DOC < prev    next >
Text File  |  1991-09-06  |  18KB  |  362 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                                        Full-Back v1.01
  12.                                           The Maximal-Fill File Copier
  13.                                                      September 6, 1991
  14.  
  15.                                        Copyright (c) 1991 Josh Coalson
  16.                                                    All Rights Reserved
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27. ShareWare Notice
  28. ============================================================================
  29.  
  30.                 Full-Back v1.01 is made available under the "ShareWare"
  31.                 concept.  You may distribute the programs as long as the
  32.                 archive contains the four files listed in "Full-Back Files"
  33.                 below.  If you find this program useful you are asked to
  34.                 send the author a license fee of $5.  All comments and
  35.                 suggestions would also be appreciated.
  36.  
  37.                      Josh Coalson
  38.                      301 N. West
  39.                      Anaheim, CA  92801
  40.  
  41.                      Kandy Shack:      (714) 636-2667
  42.                      The Cookie Jar:   (714) 997-0350
  43.                      Black Pine:       (714) 539-9374
  44.                      Punkin Duster:    (714) 522-3980
  45.                      Motown L.A. BBS:  (714) 535-1319
  46.  
  47.  
  48.  
  49. Full-Back Files
  50. ============================================================================
  51.  
  52.                 The following files are included in Full-Back v1.01:
  53.  
  54.                 FB.EXE        The command-line version of Full-Back.
  55.                 FULLBACK.EXE  The interactive version of Full-Back.
  56.                 README.DOC    Introductory file, containing information
  57.                               about Full-Back and the use of the command-
  58.                               line version.  README.DOC should be read
  59.                               prior to this one as it acquaintes you with
  60.                               the basics of Full-Back.
  61.                 FULLBACK.DOC  This file, the documentation for the
  62.                               interactive version of Full-Back.
  63.                 HISTORY.DOC   The revision history of Full-Back.
  64.  
  65.  
  66.  
  67. Full-Back Features
  68. ============================================================================
  69.  
  70.                 FULLBACK.EXE has many features that the command-line version
  71.                 FB.EXE does not.  For example, it allows full control of
  72.                 attribute bits, it has customizable configuration files, and 
  73.                 can set volume labels on floppies.  The following sections
  74.                 describe how these features are used.
  75.  
  76.  
  77.  
  78. The Full-Back Interface
  79. ============================================================================
  80.  
  81.                 First, if you haven't loaded and looked at the program yet,
  82.                 you might want to do that now.  You may find it so easy to
  83.                 use that you can skip this entire section!
  84.  
  85.                 The entire process in Full-Back takes place on a single
  86.                 screen consisting of two windows: a menu box where different
  87.                 options are set, and a dialog box, which displays
  88.                 information, help, and occasionally prompts you for input.
  89.                 Also, at the bottom of the screen is a list of keys and
  90.                 their functions.
  91.  
  92.                 The menu box is divided up unto several sections, each
  93.                 section containing one option.  These options let you
  94.                 specify exactly how you want the maximizer/copier to
  95.                 operate.  A single-line box will be around the active
  96.                 option.  Options can be altered by hitting TAB until the
  97.                 box is around the one you want to change, and then using
  98.                 the arrow keys to change it.  The dialog box will have
  99.                 instruction on how to change the active option.
  100.  
  101.                 When all the settings are to your liking, press F10 to
  102.                 begin the maximal-fill copy process.  The section "After
  103.                 F10" describes what happens next.
  104.  
  105.                 Here is a list of other keys and their functions:
  106.  
  107.  
  108.                            F1 : Display help for the active option.
  109.  
  110.                  F2 or CTRL-S : Save your current settings to the
  111.                                 configuration file.  This file is called
  112.                                 FULLBACK.CFG and is stored on your root
  113.                                 directory.  If Full-Back cannot find this
  114.                                 file, it will use built in defaults.
  115.  
  116.                            F4 : Change background color.  F4 moves forward
  117.                                 through colors, SHIFT-F4 moves backwards.
  118.  
  119.                 F5 through F8 : Change foreground colors.  These also have
  120.                                 shift equivalents that go backwards.
  121.  
  122.                        ESCAPE : Exit Full-Back.  Other keys that also exit
  123.                                 are CTRL-Q, CTRL-X, ALT-Q, and ALT-X.  Pick
  124.                                 your favorite.
  125.  
  126.  
  127.  
  128. Full-Back Options
  129. ============================================================================
  130.  
  131.                 These are the ten options that occupy the Option Box:
  132.  
  133.  
  134.    Destination  ------------------------------------------------------------
  135.          Drive  This tells Full-Back to which drive the files will be
  136.                 copied.  The destination drive must be a floppy drive.
  137.  
  138.  
  139.   Delete Files  ------------------------------------------------------------
  140.   From Source?  If this option is set to 'yes' then files are deleted off
  141.                 of the source drive as they are copied onto the destination
  142.                 drive.  This is equivalent to the /m switch on FB.EXE.  If
  143.                 this option is 'no' then files remain on the source drive
  144.                 after copying.
  145.  
  146.  
  147.           File  ------------------------------------------------------------
  148.      Filtering  Full-Back lets you pick the files that it will copy in two
  149.                 ways: you may either use a file mask (like *.* or *.EXE)
  150.                 and attribute masks (explained below); or you may 'point
  151.                 and shoot' the ones you want copied from a list of files.
  152.  
  153.                 If you choose Tags on this option, then a list of all the
  154.                 files in the current directory will appear below as the
  155.                 next option.  This is the Tags option explained below.
  156.  
  157.                 If you choose Masks on this option, then two options appear
  158.                 (instead of the Tags option).  They are File Mask and
  159.                 Attribute Masks (both explained below).
  160.  
  161.  
  162.           Tags  ------------------------------------------------------------
  163.                 If you selected Tags at the File Filtering option, then
  164.                 here is where you pick which files you want copied.  Use
  165.                 up and down arrow keys, PgUp, PgDn, Home, and End to move
  166.                 the cursor through the list of files, and SPACE to toggle
  167.                 the tag on the file.  Tagged files will appear highlighted.
  168.  
  169.  
  170.      File Mask  ------------------------------------------------------------
  171.                 If you selected Masks at the File Filtering option, then
  172.                 this option and the Attribute Masks option (below) will
  173.                 appear.  Here is where you enter a file mask (for
  174.                 example, *.* or *.EXE) like you would for the DIR command.
  175.                 All files matching this filemask and the Attribute Masks
  176.                 (explained next) will be considered for maximizing.
  177.  
  178.  
  179.      Attribute  ------------------------------------------------------------
  180.          Masks  The attribute mask also controls what files Full-Back
  181.                 'sees'.  However, this mask relies on two of the file
  182.                 attribute bits: the Read-Only and Archive bits.  There are
  183.                 three settings for each of those two bits: Set, Clear, and
  184.                 Ignore.  If the Read-Only mask is set to Clear, Full-Back
  185.                 will 'see' only those files whose Read-Only bits are clear.
  186.                 If it is set to Set, Full-Back will 'see' only those files
  187.                 whose Read-Only bits are set.  If it is set to Ignore
  188.                 Full-Back will disregard the Read-Only bit, i.e., it will
  189.                 'see' any file regardless of whether the Read-Only bit is
  190.                 set or clear.
  191.  
  192.                 The above conventions are the same for the Archive
  193.                 Attribute Mask.
  194.  
  195.                 So, in order for a file to be seen by Full-Back, it must
  196.                 match the File Mask AND the Read-Only Attribute Mask AND
  197.                 the Archive Attribute Mask.
  198.  
  199.                 If you need to use only the File Mask and not the
  200.                 Attribute Masks, then set this option to Ignore for both
  201.                 bits.  However, some backup tasks can be made incredibly
  202.                 easy and flexible through use of the attribute bits.
  203.                 Ways to use the attribute bits to simplify backups are
  204.                 described in the section "Attribute Bit Usage."
  205.  
  206.  
  207.         Source  ------------------------------------------------------------
  208.      Attribute  This option tells Fast-Back how to modify the attribute bits
  209.       Settings  of a source file after it has been copied.  The Read-Only
  210.                 bit and and the Archive bit can each be set, cleared, or
  211.                 left unchanged.
  212.  
  213.                 Notice this option is ignored if the Delete Files From
  214.                 Source option is Yes, since a deleted file no longer has
  215.                 file attributes!
  216.  
  217.  
  218.    Destination  ------------------------------------------------------------
  219.      Attribute  This option tells Fast-Back how to modify the attribute bits
  220.       Settings  of a destination file after it has been copied.  The
  221.                 Read-Only bit and and the Archive bit can each be set or
  222.                 cleared, or they can be given the same state as the source
  223.                 file (namely, that given in the Source Attribute Settings
  224.                 option).
  225.  
  226.  
  227.       Priority  ------------------------------------------------------------
  228.                 This option tells Full-Back which kinds of files should
  229.                 receive copy priority.  Full-Back will always select a
  230.                 combination that will maximize the filling of the disk, but
  231.                 certain files will always have a better chance of being
  232.                 copied because of their priority.
  233.  
  234.                 There are three priority settings: Small, Large, and
  235.                 Standard.  The Small setting will give priority to small
  236.                 files, i.e., the smaller the file, the more likely it is to
  237.                 be copied.  This setting useful when you are trying to get
  238.                 rid of a clutter of small files in a directory but it is
  239.                 not very efficient.
  240.  
  241.                 The Large setting will give priority to the largest files.
  242.                 This is the recommended (and default) setting because it
  243.                 insures the greatest fill over a series of disks.  If all
  244.                 the small files were copied at the start, Full-Back would
  245.                 be left with nothing but large files several floppies down
  246.                 the road, and it would be hard to maximize a disk with a
  247.                 few large files.  However, with large-file priority,
  248.                 Full-Back will try to get as many large files out of the
  249.                 way first.
  250.  
  251.                 The last setting, Standard, instructs Full-Back to give
  252.                 high priority to files high on the directory, i.e., the
  253.                 closer the file is to the top of a DOS directory listing,
  254.                 the more likely it is to be copied.  With this setting,
  255.                 the directories of full disks will contain files ordered
  256.                 similarly to the original source directory.  This setting
  257.                 is particularly useful for user-defined priorities.  As
  258.                 an example, if you wanted older files backed up first, you
  259.                 would sort your DOS directory by date in ascending order,
  260.                 and then set Full-Back's file priority to Standard.
  261.                 Full-Back would then consider older files first.
  262.  
  263.  
  264.     Prompt For  ------------------------------------------------------------
  265.  Volume Label?  When this option is set to 'yes' you will be asked for a
  266.                 volume label for the destination floppy once it is full.
  267.                 The volume label you enter will be saved so that it can
  268.                 be used on following disks by just hitting ENTER, but you
  269.                 can always enter a new one.
  270.  
  271.                 When you save the configuration file, the last volume label
  272.                 used is saved for the next session, so if you use one label
  273.                 frequently, you can use F2 or CTRL-S to save it.
  274.  
  275.  
  276.  
  277. Using the Attribute Bits
  278. ============================================================================
  279.  
  280.                 If you are using Full-Back to move files from source to
  281.                 destination, then the only use for attribute bits you might
  282.                 have would be to make the backed up files read-only, in
  283.                 which case you would set Destination Read-Only Attribute
  284.                 to Set, and the rest of the options about attribute bits to
  285.                 either Ignore, Unchanged, or As Source.
  286.  
  287.                 However, if you are keeping the files on the source, but
  288.                 are backing up the files for safekeeping (if you are a BBS
  289.                 SysOp this may sound familiar to you) then the archive bit
  290.                 can help keep track of what has and hasn't been backed up.
  291.  
  292.                 The normal state of a file's archive bit is 'set'; this is
  293.                 how DOS sets it when it is created.  You can tell Full-Back
  294.                 to clear the archive bit of a file that has been copied
  295.                 (signifying that the file has been backed up), and tell
  296.                 Full-Back to only consider files who's archive bit is
  297.                 set (files that haven't been backed up) by using the
  298.                 following attribute bit settings:
  299.  
  300.  
  301.                       File Filtering: Masks      
  302.  
  303.                       File mask: *.*    (or whatever you like)
  304.  
  305.  
  306.                       Attribute masks:
  307.  
  308.                       Read-Only: Ignore
  309.                         Archive: Set
  310.  
  311.  
  312.                       Source Attribute Settings: 
  313.  
  314.                       Read-Only: Unchanged
  315.                         Archive: Clear
  316.  
  317.  
  318.                 With these settings, Full-Back will only consider files
  319.                 that haven't been backed up yet, and will automatically
  320.                 clear the archive bit of all the files it does back up.
  321.                 You'll never have to keep track of it again!
  322.  
  323.  
  324.  
  325. After F10
  326. ============================================================================
  327.  
  328.                 Once you have set the options to your liking and have saved
  329.                 them to your configuration file you are ready to begin
  330.                 copying.  Hit F10 and Full-Back will start the process.
  331.                 Remember that you can hit ESCAPE at any prompt to abort
  332.                 the process, but while files are in the middle of being
  333.                 copied the process cannot be aborted.
  334.  
  335.                 Full-Back will ask for the first disk, and will search it
  336.                 for files already there.  If it finds any, it will ask you
  337.                 if you would like them left on the disk or moved to the
  338.                 source drive for consideration.  This is useful if the last
  339.                 disk you backed up wasn't totally full and you want to fill
  340.                 it with new files.  If you move the files to the source
  341.                 drive, Full-Back will modify those files' attribute bits to
  342.                 the settings you have for the Attribute Masks option so
  343.                 that they will be automatically considered for recopying.
  344.                 If you leave the files on, Full-Back will do its best to
  345.                 fill the remaining space to capacity.
  346.  
  347.                 Full-Back will then quickly compute the best fit and tell
  348.                 you how full the disk will be.  You will be asked if you
  349.                 would like to view the files before they are copied as an
  350.                 extra precaution (you can disable file viewing by using
  351.                 a '/v' on the command line, i.e. FULLBACK /v).  If you
  352.                 answer yes you can scroll through the files to be copied
  353.                 and note their file sizes.
  354.  
  355.                 When you are all done, Full-Back starts the copy process.
  356.                 The filename and its size of each file are displayed as
  357.                 they are copied.  If there are still files left, Full-Back
  358.                 will repeat the process until all files have been copied
  359.                 or it is aborted.  Once Full-Back is done copying it will
  360.                 return you to the active window.
  361.  
  362.