home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / FILE / KBFM11.ZIP / FM.DOC next >
Encoding:
Text File  |  1992-06-12  |  23.0 KB  |  514 lines

  1.  
  2.                                KB-File Manager
  3.                                  Version 1.1
  4.                       Copyright (C) 1992 by Kent Briggs
  5.  
  6.  
  7.                                 Introduction
  8.                                 ------------
  9.  
  10.     KB-File Manager (KB-FM) is an easy to use, yet powerful DOS file manager
  11.     that lets the user copy, move, delete, and perform other functions on
  12.     individual files or groups of files.  Files are selected by "tagging"
  13.     them on the screen and then processing them through a "Lotus" style
  14.     menu.  Safeguards are built in to prevent a file from being overwritten
  15.     without your permission.  KB-FM is for people who want a more powerful
  16.     utility than the PC-Magazine "CO.COM" program but don't want to shell
  17.     out $100 for a commercial program like "XTree Gold."
  18.  
  19.  
  20.                                 Distribution
  21.                                 ------------
  22.  
  23.     KB-FM is distributed as Shareware with a registration fee of $10.
  24.     Shareware is a "try before you buy" concept where users are encouraged
  25.     to share the programs with friends and business associates, upload to
  26.     electronic bulletin board systems (BBS), etc.  Those that find the
  27.     programs useful should register their copy to support the author's
  28.     efforts and to receive technical support or other benefits.
  29.  
  30.     KB-FM is distributed in a compressed format in a file called KBFM10.ZIP.
  31.     The compressed file contains the following files that must stay together
  32.     for distribution:
  33.  
  34.     FM.EXE          KB-FM Program
  35.     FM.DOC          KB-FM Documentation (9 pages)
  36.     FMCONFIG.EXE    KB-FM Configuration program for registered users
  37.     ORDER.FRM       KB-FM Registration order form
  38.  
  39.  
  40.                              FMCONFIG Program
  41.                              ----------------
  42.  
  43.     The shareware version of KB-FM has black and white screen colors and an
  44.     opening message screen with a three-second pause.  No operating
  45.     functions of KB-FM are crippled.  As an additional incentive to
  46.     register, a unique serial number will be sent to registered users.  This
  47.     serial number is used by the FMCONFIG program to disable the opening
  48.     message screen and will let the user customize the KB-FM screen colors.
  49.     The user can select from a default black and white or color configuration,
  50.     or make a custom color configuration by selecting individual colors for
  51.     11 separate areas of the screen.  FMCONFIG will also personalize your
  52.     registered copy of KB-FM by placing your name (or company name) and serial
  53.     number on the help screen.
  54.  
  55.  
  56.                                      1
  57.  
  58.  
  59.                                 Registration
  60.                                 ------------
  61.  
  62.     To register your copy of KB-File Manager, print the order form, fill it
  63.     out and send in your registration fee.  You can use the following DOS
  64.     command to print the order form:
  65.  
  66.     COPY ORDER.FRM PRN
  67.  
  68.     There are four line items on the order form:
  69.  
  70.     1. KB-FM Registration (no disk)   :  $10
  71.     2. KB-FM Diskette, 5.25"          :   $3
  72.     3. KB-FM Diskette, 3.5"           :   $3
  73.     4. KB-FM Site License Registration: $150
  74.  
  75.     Item 1 is the normal registration option for users who already have the
  76.     KB-FM shareware files and just need the serial number for the FMCONFIG
  77.     program.  No disks are provided.  Your serial number will be valid for
  78.     all future versions of KB-FM that have a $10 registration fee.  This
  79.     means that you can self-upgrade at no cost.  If the registration fee
  80.     is raised, then you can upgrade to a new serial number by paying the
  81.     difference between the new fee and the fee you originally paid.
  82.  
  83.     Items 2 and 3 are disks that contain the same shareware files that are
  84.     distributed through the normal shareware channels.  These are for people
  85.     who have read about KB-FM but do not have a modem or other means of
  86.     obtaining the latest version.  The $3 charge is to cover my costs of
  87.     materials and postage.  A registration serial number is NOT provided
  88.     with items 2 or 3.
  89.  
  90.     Item 4 is a site license for companies who need more than 15 copies of
  91.     KB-FM.  With a site license, you may make unlimited copies of KB-FM for
  92.     use on the site.  A site is defined as one or more buildings used by a
  93.     company or institution on a contiguous area of land.  The site license
  94.     includes a registration serial number and a 5.25" and 3.5" disk.  You
  95.     may upgrade to a site license at any time by subtracting $10 for every
  96.     registered copy you already have from the $150 site license fee.
  97.  
  98.     When ordering items 1 or 4, please include the name that KB-FM will be
  99.     registered to.  This name (30 characters max) will be placed on the help
  100.     screen by the FMCONFIG program.
  101.  
  102.     For orders or technical support, write to:
  103.  
  104.     Kent Briggs
  105.     109A Romana Cir.
  106.     Hewitt, TX  76643
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                      2
  114.  
  115.  
  116.                                 Disclaimer
  117.                                 ----------
  118.  
  119.     This software is provided as is and without warranty.  The author
  120.     assumes no liability for damages, either direct or consequential, which
  121.     may result from the use of this product.
  122.  
  123.  
  124.                                Installation
  125.                                ------------
  126.  
  127.     No special installation is needed to run KB-FM.  However, you will
  128.     probably want to put FM.EXE in your DOS path so that it will execute
  129.     from any directory.  The DOS path is defined in your AUTOEXEC.BAT file
  130.     and lists a string of directories that are searched if DOS cannot find a
  131.     program in the current directory.  Put FM.EXE in one of those
  132.     directories or modify the PATH statement so that it contains the KB-FM
  133.     directory.  Refer to your DOS manual for use of the PATH command.
  134.  
  135.     To start KB-FM, type FM at the DOS command line and press Enter.  You
  136.     may enter optional parameters on the command line:
  137.  
  138.     FM [pathspec][filespec] [/N,/E,/S,/D,/A,/U][R]
  139.  
  140.     Pathspec is the directory that KB-FM will display on startup.  The
  141.     default directory is the current directory.  The Filespec is the file
  142.     name filter that determines which files to display.  The default
  143.     filespec is *.* which displays all files.  The / options determine the
  144.     file sort order: N=name, E=extension, S=size, D=date, A=attribute, and
  145.     U=unsorted.  Use an R suffix to reverse the sort.  The default sort is
  146.     /N.  The following example will show the batch files in the root
  147.     directory on drive A and sort them by date in reverse order:
  148.  
  149.     FM A:\*.BAT /DR
  150.  
  151.  
  152.                                 KB-FM Screen
  153.                                 ------------
  154.  
  155.     The screen is divided into three main areas that contain information
  156.     about the current directory.  The File List is the large box on the left
  157.     side of the screen.  It contains the list of files in the current
  158.     directory that match the filespec.  The list contains the file name and
  159.     extension, size, date and time, and attributes.  The four possible
  160.     attributes are A for archive, S for system, H for hidden, and R for
  161.     read-only.  Refer to your DOS manual for a description of file
  162.     attributes.  The file list is sorted by the current sort order.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                                      3
  171.  
  172.  
  173.     The Directory List is the box in the upper right corner of the screen.
  174.     This list contains the subdirectories of the current directory and all
  175.     of the logical drives on the computer.  The name of the current
  176.     directory is displayed at the bottom of the directory list in a separate
  177.     box.  The number of subdirectories and drives are displayed under the
  178.     directory list.  If the current directory is not a root directory, then
  179.     the first item in the directory list will always be a ".." which
  180.     represents the parent directory of the current directory.  The date and
  181.     time that the directory was created are also shown in the list.  The
  182.     directory list is always sorted by name in ascending order.  Hidden
  183.     directories are not displayed in the list.
  184.  
  185.     The box in the lower right corner of the screen contains additional
  186.     information about the files in the current directory.  The filespec
  187.     shows the current file name filter that determines which files are
  188.     displayed.  The default filespec is *.* which displays all files.  The
  189.     current file sort order is shown under the filespec.  "Rev" will be
  190.     displayed if the sort is in reverse (descending) order.  Both the
  191.     filespec and sort order can be set from the FM.EXE command line or
  192.     changed from the top line menu.  The filespec and sort order remain in
  193.     effect even after changing directories.
  194.  
  195.     Below the Filespec/Sort order box is the Tagged files box that displays
  196.     the number and total size of tagged files.  Files can be tagged with the
  197.     + key and untagged with the - key (use the numeric keypad).  Files are
  198.     tagged so that they can be processed (copied, deleted, etc.) all at once
  199.     instead of one at a time.
  200.  
  201.     The bottom line of the screen contains information on the number and
  202.     total size of the files in the file list and the number and percentage
  203.     of free disk space on the current drive.  The menus are displayed on the
  204.     top line of the screen when the / key is pressed.
  205.  
  206.  
  207.                                 Active Keys
  208.                                 -----------
  209.  
  210.     Scrolling:  Press the left and right cursor keys or the Tab key to
  211.     move the highlight bar between the file list and directory list.  Press
  212.     the up and down cursor keys to scroll the highlight bar in the file and
  213.     directory lists.  Press PageUp and PageDown to scroll a whole page of
  214.     files or directories.  Press Home to move to the top of the lists and
  215.     End to move to the bottom.  A down arrow will appear at the bottom of
  216.     the list if more files (or directories) are in the list below the last
  217.     one shown.  An up arrow will appear at the top of the list if more files
  218.     (or directories) are in the list above the first one shown.
  219.  
  220.     Change Dir:   With the highlight bar in the directory list, press Enter
  221.                   to change to that directory.  If the highlight bar is on
  222.                   the ".." directory, then the new directory will be the
  223.                   parent of the current directory.  If the highlight bar is
  224.                   on a drive, then the new directory will be the current
  225.                   directory on the new drive.
  226.  
  227.                                      4
  228.  
  229.  
  230.     File Tagging: With the highlight bar in the file list, press the + key
  231.                   (use the numeric keypad) to tag the current file.  An arrow
  232.                   will appear on the left side of the file name.  Press - to
  233.                   untag a file.
  234.  
  235.     Menus:        With the highlight bar in the file list, press / to display
  236.                   the File Menu on the top line.  With the highlight bar in
  237.                   the directory list, press / to display the Directory Menu on
  238.                   the top line.  Press Esc or the down arrow to remove the top
  239.                   line menu.
  240.  
  241.     File Search:  Press any other key to search for a file (or directory) that
  242.                   begins with that character (i.e., press P to search for a
  243.                   file name that begins with P).  The search begins at the
  244.                   highlight bar and goes down until a match is found or until
  245.                   the bottom of the list is reached at which time the search
  246.                   will continue at the top of the list and continue until the
  247.                   original starting point is reached.  If a match is found,
  248.                   the highlight bar will be moved to that file (or directory).
  249.  
  250.  
  251.                                Directory Menu
  252.                                --------------
  253.  
  254.     With the highlight bar in the directory list, press / to display the
  255.     directory menu:
  256.  
  257.     DIRECTORY:  Make  Remove  Help  Quit
  258.  
  259.     To select a menu item, press the left or right cursor keys until the
  260.     item is highlighted and then press Enter.  As a shortcut, just press the
  261.     key corresponding to the first letter in the menu item.  Press Esc or
  262.     the down arrow key to cancel the menu.
  263.  
  264.     Make:   Select Make to make a new subdirectory in the current directory.
  265.             This is the same as the DOS MD command.  A prompt will appear
  266.             like this:
  267.  
  268.             New subdirectory for C:\
  269.  
  270.             Type in a valid directory name and press Enter or press Esc
  271.             to cancel.
  272.  
  273.     Remove: Select Remove to remove the directory that is currently
  274.             highlighted.  This is the same as the DOS RD command.  A Yes/No
  275.             conformation prompt will appear before the directory is removed.
  276.             An error message will be displayed if the directory is not
  277.             empty.
  278.  
  279.     Help:   Select Help to display the help screen.  If you are a registered
  280.             user, your name and registration serial number will be displayed.
  281.             A list of the active keys and menu functions are listed on this
  282.             screen.  Press any key to return from the help screen.
  283.  
  284.                                      5
  285.  
  286.  
  287.     Quit:   Select Quit to exit the KB-FM program.
  288.  
  289.  
  290.                                  File Menu
  291.                                  ---------
  292.  
  293.     With the highlight bar in the file list, press / to display the file
  294.     menu:
  295.  
  296.     FILE: Copy Move Delete Rename Sort Tag Filespec Attribute Help Quit
  297.  
  298.     To select a menu item, press the left or right cursor keys until the
  299.     item is highlighted and then press Enter.  As a shortcut, just press the
  300.     key corresponding to the first letter in the menu item.  Press Esc or
  301.     the down arrow key to cancel the menu.
  302.  
  303.     Copy:      Select Copy to copy files from the current directory to a
  304.                designated destination directory.  If one or more files are
  305.                tagged, then the tagged files will be copied.  A prompt will
  306.                appear like this:
  307.  
  308.                Copy 3 tagged file(s) to: _
  309.  
  310.                If no files are tagged, then the current highlighted file is
  311.                copied.  A prompt will appear like this:
  312.  
  313.                Copy KBFM10.ZIP to: _
  314.  
  315.                Type in a valid directory just as you would using the DOS
  316.                COPY command or press Esc to cancel the Copy command.  KB-FM
  317.                will ensure that the destination drive/directory exists
  318.                before an attempt is made to copy the files.  The arrow "tag"
  319.                is removed after a successful copy and the file is "marked"
  320.                with an asterisk.
  321.  
  322.                If an error occurs during the copy process, the speaker will
  323.                beep and a brief error message will be displayed.  The copy
  324.                process will continue if other files in the list are tagged.
  325.                You can press any key to interrupt the copy process.  An
  326.                error will occur if the file has attributes other than "A"
  327.                (archive) or if the destination drive is full.
  328.  
  329.                If a file with the same name already exists in the
  330.                destination directory, the copy process is interrupted with
  331.                the following prompt like this:
  332.  
  333.                KBFM10.ZIP already exists.
  334.                (R)eplace, (S)kip, (N)o_prompting, (Q)uit?
  335.  
  336.                Press R to overwrite the file and continue the copy process.
  337.                Press S to skip the file and continue with the next tagged
  338.                file.  Press N to overwrite the file and all other files that
  339.                might already exist.  Press Q to cancel the Copy command.
  340.  
  341.                                      6
  342.  
  343.  
  344.     Move:      Select Move to move files from the current directory to a
  345.                designated destination directory.  If one or more files are
  346.                tagged, then the tagged files will be moved.  A prompt will
  347.                appear like this:
  348.  
  349.                Move 3 tagged file(s) to: _
  350.  
  351.                If no files are tagged, then the current highlighted file is
  352.                moved.  A prompt will appear like this:
  353.  
  354.                Move KBFM10.ZIP to: _
  355.  
  356.                Type in a valid directory just as you would using the DOS
  357.                COPY command (there is no DOS MOVE command) or press Esc to
  358.                cancel the Move command.  KB-FM will ensure that the
  359.                destination drive/directory exists before an attempt is made
  360.                to move the files.
  361.  
  362.                The move process is the same as the Copy command except the
  363.                files are deleted if they are successfully copied.
  364.  
  365.     Delete:    Select Delete to delete files from the current directory.  If
  366.                one or more files are tagged, then the tagged files will be
  367.                deleted.  A prompt will appear like this:
  368.  
  369.                Delete 3 tagged file(s) (Y/N) ?
  370.  
  371.                If no files are tagged, then the current highlighted file is
  372.                deleted.  A prompt will appear like this:
  373.  
  374.                Delete KBFM10.ZIP (Y/N) ?
  375.  
  376.                Press Y to delete the file(s) or any other key to cancel the
  377.                delete command.  A file will not be deleted if it has
  378.                attributes other than "A" (archive).
  379.  
  380.     Rename:    Select Rename to give the current highlighted file a
  381.                different name.  Other tagged files are not affected.  A
  382.                prompt will appear like this:
  383.  
  384.                Rename KBFM10.ZIP to: _
  385.  
  386.                Type in a valid DOS filename or press Esc to cancel the
  387.                Rename command.  An error will occur if the name is invalid
  388.                or another file with the same name already exists.
  389.  
  390.     Sort:      Select Sort to set the sort order for the current directory
  391.                and all subsequent directories.  A submenu will appear as
  392.                follows:
  393.  
  394.                Sort by: Name Extension Size Date Attribute Unsorted Reverse
  395.  
  396.  
  397.  
  398.                                      7
  399.  
  400.  
  401.                Select the file sort order from this list.  Select Unsorted
  402.                to reload the current directory and leave it in the original
  403.                DOS order.  Select Reverse to reverse the current sort order
  404.                with a descending sort.  The current sort order is displayed
  405.                in the lower right box on the screen.  The sort order remains
  406.                in effect until you change it again.  The default sort order
  407.                is by Name and can be changed from the FM.EXE command line
  408.                (see the Installation section discussed earlier).
  409.  
  410.     Tag:       Select Tag to tag or untag a group of files all at once.
  411.                Individual files are tagged/untagged with the +/- keys.  A
  412.                submenu will appear as follows:
  413.  
  414.                Tag:  All  None  Marked  Unmarked  Flip
  415.  
  416.                Select All to tag all files in the list.  Select None to
  417.                untag and unmark all files in the list.  Select Marked to tag
  418.                all files that are marked with an asterisk.  These files have
  419.                recently been copied or had their attributes changed.  Select
  420.                Unmarked to tag all files that are currently marked with an
  421.                asterisk.  Select Flip to tag all untagged files and to untag
  422.                all tagged files.  Marked files remain marked with an asterisk.
  423.  
  424.     Filespec:  Select Filespec to change the current filespec.  The filespec
  425.                is the file name filter that determines which files to
  426.                display.  A prompt will appear as follows:
  427.  
  428.                Enter new filespec: _
  429.  
  430.                Type in a new filespec or press Esc to cancel.  The default
  431.                filespec is *.* which displays all files.  The current
  432.                filespec remains in effect until you change it again.  You
  433.                can change the default filespec from the FM.EXE command line
  434.                (see Installation section).  Here are some filespec examples:
  435.  
  436.                *.DOC      ; display only files with an extension of .DOC
  437.                K*.*       ; display only files that start with a K
  438.  
  439.     Attribute: Select Attribute to change the attributes of files in the
  440.                current directory.  If one or more files are tagged, then the
  441.                tagged files will be changed.  A prompt will appear like
  442.                this:
  443.  
  444.                Change attributes of 3 tagged files(s) to (+/-ASHR): _
  445.  
  446.                If no files are tagged, then the attributes of the current
  447.                highlighted file are changed.  A prompt will appear like
  448.                this:
  449.  
  450.                Change attributes of KBFM10.ZIP to (+/-ASHR): _
  451.  
  452.                The four possible attributes are A for archive, S for system,
  453.                H for hidden, and R for read-only.  Refer to your DOS manual
  454.  
  455.                                      8
  456.  
  457.  
  458.                for a description of file attributes.
  459.  
  460.                Type in the attributes to change by preceding each one with a
  461.                + to turn on or a - to turn off.  Press Esc to cancel the
  462.                Attribute command.  Here are some examples:
  463.  
  464.                +H-S            ; turn on H attribute and turn off S attribute
  465.                                ; the A and R attributes are not affected.
  466.  
  467.                -H-S-R-A        ; turn off all attributes
  468.  
  469.     Help:      Select Help to display the help screen.  If you are a
  470.                registered user, your name and registration serial number will
  471.                be displayed.  A list of the active keys and menu functions are
  472.                listed on this screen.  Press any key to return from the help
  473.                screen.
  474.  
  475.     Quit:      Select Quit to exit the KB-FM program.
  476.  
  477.  
  478.                                 Miscellaneous
  479.                                 -------------
  480.  
  481.     KB-File Manager 1.1 was written in Turbo Pascal 6.0 (approximately 2100
  482.     lines of code) on a Gateway 2000 486DX2/50 computer.  The program was
  483.     beta tested on several types of computers including workstations on a
  484.     LANtastic network.
  485.  
  486.     Version 1.1 does not have all the features that I want, but it is a good
  487.     starting point.  My goal was to get a bug-free version on the shareware
  488.     market and improve on it from there.  Users who register KB-FM can use
  489.     their serial numbers to self-upgrade as new versions are released.  If
  490.     the registration fee is raised, then those users can upgrade by paying
  491.     the difference between the new fee and the fee they originally paid.
  492.  
  493.     Here are some features that I may add in future versions:
  494.  
  495.     ASCII file viewer
  496.     COM, EXE, and BAT launcher
  497.     Secure file deletion: overwrite with zeros before deleting
  498.     Mouse support
  499.     Pull-Down menus
  500.     Hot-Keys
  501.  
  502.     Please send your own suggestions to:
  503.  
  504.     Kent Briggs
  505.     109A Romana Cir.
  506.     Hewitt, TX  76643
  507.  
  508.     You can also leave e-mail addressed to me on the Exec-PC BBS at
  509.     (414)-789-4210.  Exec-PC is PC-Pursuitable through WIMIL.
  510.  
  511.  
  512.                                      9
  513.  
  514.