home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 24b / filer2.zip / FILER2.DOC next >
Text File  |  1986-01-24  |  16KB  |  413 lines

  1.  
  2.  
  3.  
  4.  
  5.                                      FILER v2.00
  6.                                  (BETA TEST VERSION)
  7.  
  8.  
  9.           FILER2 is a general purpose command-driven file handler.
  10.  
  11.           Unlike many currently popular file handling shells, FILER2 is not
  12.           menu-driven; it uses commands similar to those provided by DOS,
  13.           such as COPY, RENAME, ERASE, and so on.   Some users (obviously
  14.           including the author) find commands, once learned, to be more
  15.           efficient and easier to use than menus.
  16.  
  17.           Because many FILER2 commands are the same as DOS commands, the
  18.           obvious question is, "Why use FILER2 at all?".  FILER2 commands
  19.           have two basic advantages over the equivalent DOS commands.
  20.  
  21.           First, FILER2 is much safer:
  22.  
  23.                -- It will NEVER erase or write over a file without giving
  24.                you a chance to change your mind.
  25.  
  26.                -- It offers a "preview" mode that allows you to see what
  27.                effects your commands will have, without actually executing
  28.                the commands.
  29.  
  30.           Second, FILER2 is more powerful:
  31.  
  32.                -- It offers more powerful wildcards than DOS.
  33.  
  34.                -- It offers a "select" mode, which allows you to select or
  35.                pass over individual files that meet your wildcard file
  36.                specification.
  37.  
  38.                -- Many of the individual commands are more powerful than
  39.                DOS equivalents.  RMDIR, for example, doesn't care if the
  40.                directory being removed is empty or is the current
  41.                directory, and it can remove an entire subtree.
  42.  
  43.           This document assumes a basic familiarity with DOS file handling
  44.           commands such as COPY, ERASE, RENAME, CD, etc., and with DOS's
  45.           '*' and '?' wildcards.
  46.  
  47.  
  48.           Execution modes
  49.           ---------------
  50.  
  51.           FILER2 has two basic modes: single command mode, and multiple
  52.           command mode.  In single command mode, FILER2 will execute one
  53.           command and return to the DOS prompt.  In multiple command mode,
  54.           FILER2 will display its own prompt, from which you can execute as
  55.           many file handling commands as you wish.
  56.  
  57.           To execute FILER2 in single command mode, type at the DOS prompt:
  58.  
  59.                FILER2 <command> [parameters] [/switches]
  60.  
  61.           For example:
  62.  
  63.  
  64.  
  65.  
  66.                C> FILER2 erase ch*.* /p
  67.  
  68.           FILER2 will execute the single command "erase ch*.* /p", and you
  69.           will be returned to the DOS prompt.
  70.  
  71.           To execute FILER2 in multi-command mode, type "FILER2" (without
  72.           parameters) at the DOS prompt:
  73.  
  74.                C> FILER2
  75.  
  76.           You will be placed at the FILER2 prompt, which looks like this:
  77.  
  78.                FILER2>
  79.  
  80.           At the FILER2 prompt, you can execute as many FILER2 commands as
  81.           you want.  To return to the DOS prompt, type Q or QUIT.
  82.  
  83.  
  84.  
  85.           Wildcards
  86.           ---------
  87.  
  88.           FILER2's wildcards are similar to, but more powerful than, the
  89.           DOS equivalents.
  90.  
  91.           The '*' wildcard represents any string of characters (including
  92.           the null string), and the '?' wildcard represents any single
  93.           character.  So far, the same as DOS.
  94.  
  95.           However, the '*' wildcard need not be at the end of the filename
  96.           or extension, and there can be more than one '*' in each.  For
  97.           example,
  98.  
  99.                c*d.com
  100.  
  101.           matches 'ced.com', 'crud.com', etc.  And
  102.  
  103.                c*t*n.*m
  104.  
  105.           matches (for example) 'cvtbin.com', 'carton.sum', 'ctn.m', etc.
  106.  
  107.           One other change from DOS is that the '?' never matches a null
  108.           character (an inconsistency in DOS).  That is, 'c???' matches
  109.           'crud' but not 'ced'.
  110.  
  111.           A final change is that missing filenames and extensions are
  112.           ALWAYS assumed to mean '*'.  Thus, 'c' is equivalent to 'c.*',
  113.           and '.com' is equivalent to '*.com'.  DOS uses this convention in
  114.           a few commands, but not consistently.  If you specifically want
  115.           files with no extensions, use '.', as in 'foo.'.
  116.  
  117.           Avoid using consecutive *'s and the sequence '*?'.  However, the
  118.           sequence '?*' is meaningful and useful.  For example, 'c?*'
  119.           matches any filename of 2 or more characters beginning with 'c'.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.           Wildcard substitution
  126.           ---------------------
  127.  
  128.           Wildcard substitution will work pretty much as you'd expect. For
  129.           example, if you type
  130.  
  131.                FILER2 copy a*c.* x*y.*
  132.  
  133.           and FILER2 finds the matching file 'abc.txt', it will copy it to
  134.           a file named 'xby.txt'.
  135.  
  136.           As with DOS, it is possible to create "wildcard mismatches".  For
  137.           example, consider:
  138.  
  139.                FILER2 copy *.* some.txt
  140.  
  141.           Clearly, FILER2 may find more than one file matching "*.*"; these
  142.           will ALL be copied to the same file, "some.txt".  This is called
  143.           a "wildcard mismatch": the set of wildcards in the source
  144.           filespec doesn't match the set of wildcards in the destination
  145.           filespec.  FILER2 will accept wildcard mismatches, but it will
  146.           warn you with the message "WARNING: wildcard mismatch".
  147.  
  148.           Note that you would be saved (in the above "*.* -> some.txt"
  149.           example) by the fact that FILER2 won't overwrite an existing file
  150.           without requesting verification.  Thus, the first matching file
  151.           would be copied to "some.txt", but copying the second file would
  152.           overwrite the new "some.txt", and FILER2 would prompt for
  153.           verification.
  154.  
  155.           One wildcard mismatch that is allowable in DOS but should be
  156.           avoided in FILER2 is exemplified by
  157.  
  158.                FILER2 copy zap.exe b:*.*
  159.  
  160.           Avoid this; you'll end up with a blank filespec.
  161.  
  162.           The general rule is to match the source wildcard sequence by the
  163.           destination wildcard sequence, unless you have a pretty good
  164.           reason for not doing so.
  165.  
  166.  
  167.  
  168.           Option switches
  169.           ---------------
  170.  
  171.           Any FILER2 command may include any or all of these option
  172.           switches:
  173.  
  174.                /P   Preview mode.  In preview mode, FILER2 will process the
  175.                     command normally EXCEPT that it won't actually perform
  176.                     any disk writes, erases, etc.  You can use this to see
  177.                     exactly what effect something like
  178.  
  179.                          move c?*x*t.?r? d:\foo\xx*.xf?
  180.  
  181.                     will have, without actually DOING anything.  In preview
  182.                     mode, all output will be prefixed by "[Prvw]".
  183.  
  184.  
  185.  
  186.  
  187.                /S   Select mode.  In select mode, FILER2 will ask you
  188.                     whether or not you want to process each file that
  189.                     matches the source filespec.  In other words,
  190.  
  191.                          erase *.* /s
  192.  
  193.                     will ask you whether you want to erase each *.* file.
  194.  
  195.                /A   Archive mode.  Affects COPY command only.  With Archive
  196.                     mode set, COPY will only copy files whose archive bits
  197.                     are set.  It will reset the archive bit (on both source
  198.                     and destination) when it is finished.
  199.  
  200.           Switches may be set in any order, before or after the command.
  201.  
  202.  
  203.  
  204.           FILER2 Commands
  205.           ---------------
  206.  
  207.           Many commands may be abbreviated.  The minimum required command
  208.           length is shown in CAPS.  For example, "DELete" may be entered as
  209.           DEL, DELE, DELET, or DELETE.
  210.  
  211.  
  212.           CD or CHDIR - change directory
  213.  
  214.                Exactly like the equivalent DOS command.
  215.  
  216.           CLS - Clear screen
  217.  
  218.                Clears the screen.  ANSI.SYS required.
  219.  
  220.           COPY - copy files
  221.  
  222.                Pretty much like the basic version of the DOS COPY command,
  223.                except that all file overwrites are verified and you have
  224.                the /S, /P, and /A options.  Does not support a COPY from a
  225.                character device (e.g., COPY CON ...), and does not support
  226.                DOS's "+" operator to concatenate files during the copy
  227.                process.
  228.  
  229.           DELete - delete files
  230.  
  231.                Pretty much like the DOS command, except that the /P and /S
  232.                options are available.
  233.  
  234.           DIR - directory
  235.  
  236.                Just a quick 5-up reference list of files matching a given
  237.                filespec.  For real directories, use DOS (below).
  238.  
  239.           DOS - execute a DOS command or program.
  240.  
  241.                For example, "DOS dir" gives you a DOS directory.
  242.  
  243.  
  244.  
  245.  
  246.           ERASE - erase files
  247.  
  248.                Identical to DELete.
  249.  
  250.           FIND - find files
  251.  
  252.                Find files matching a given filespec, anywhere on the disk.
  253.                For example, "FIND *.exe" finds all .exe files on the
  254.                default drive.  Add a directory name to search only a given
  255.                subtree.
  256.  
  257.           MD or MKDir - make a directory
  258.  
  259.                Exactly like the DOS command.
  260.  
  261.           MOVe - move or rename files
  262.  
  263.                Allows you to move files from one drive to another, one
  264.                directory to another, or to rename files.  Examples:
  265.  
  266.                     move temp.foo d:\archive\arc.001
  267.                     move \doc\temp.foo \archive
  268.                     move temp.foo arc.001
  269.  
  270.                (The last is simply a rename operation.)  If the move is
  271.                across drives, MOVE performs a copy and delete; otherwise,
  272.                it simply uses a DOS rename (the file is not actually
  273.                copied).
  274.  
  275.                NOTE: MOVE is identical to REName.  There is a separate
  276.                section, below, that explains MOVE in greater detail.
  277.  
  278.           Quit - return to DOS
  279.  
  280.                Exits multi-command mode.
  281.  
  282.           RD or RMDir - remove a directory or subtree
  283.  
  284.                Removes a directory, without any of DOS's restrictions.  If
  285.                the directory is not empty, deletes all files before
  286.                removal.  If the directory contains subdirectories, removes
  287.                them too.  If the current directory is one of those removed,
  288.                you'll end up at the root.  All file erasures are confirmed.
  289.  
  290.           REName - rename or move a file
  291.  
  292.                Identical to MOVe.
  293.  
  294.           Tree - display a directory tree
  295.  
  296.                Just like DOS, but more compact.
  297.  
  298.           VERsion - display FILER2 version.
  299.  
  300.                Displays version and copyright.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.           More about MOVE and RENAME
  308.           --------------------------
  309.  
  310.           These two commands (which are identical) are somewhat more
  311.           complex than the DOS equivalent (REN or RENAME).  DOS's rename
  312.           does exactly what it says: it renames a file.  FILER2's MOVE can
  313.           be used for that purpose, but it can also be used to move a file
  314.           from one directory to another, or from one disk to another.  When
  315.           a file has been moved, only the new copy of the file remains on
  316.           disk.  Thus,
  317.  
  318.                FILER2 move \util\myprog.exe \lib\someprog.exe
  319.  
  320.           is functionally equivalent to the two DOS commands
  321.  
  322.                copy \util\myprog.exe \lib\someprog.exe
  323.                del \util\myprog.exe
  324.  
  325.           It is useful to know when a file will simply be renamed, and when
  326.           it will be moved.  The rule is:
  327.  
  328.                If the destination filespec contains no path, or if it
  329.                contains a path and it is the same as the source path, then
  330.                it will be renamed.  Otherwise, it will be moved.
  331.  
  332.           Examples (assume that the current dir is C:\UTIL):
  333.  
  334.                move \util\abc.txt cde.txt         [rename]
  335.                move \util\abc.txt \util\cde.txt   [rename]
  336.                move \util\abc.txt c:cde.txt       [rename]
  337.                move abc.txt \lib\abc.txt          [move]
  338.                move abc.txt \lib\cde.txt          [move]
  339.                move \util\abc.txt \lib\abc.txt    [move]
  340.                move abc.txt d:                    [move]
  341.                move abc.txt d:\util               [move]
  342.  
  343.           Note that you can MOVE files from one drive to another.
  344.  
  345.           If files are moved from one directory to another on the same
  346.           disk, FILER2 uses a very safe and efficient DOS function that
  347.           simply moves the directory entry, without physically copying the
  348.           file itself.  If files are moved from one drive to another,
  349.           FILER2 will perform a COPY and DELETE.
  350.  
  351.  
  352.           FILER2 and PCED
  353.           ---------------
  354.  
  355.           FILER2 is PCED compatible.  All PCED editing facilities,
  356.           USERSYNs, etc., are available, as are user-installed commands.
  357.  
  358.           You may find it handy to define synonyms for DOS commands, such
  359.           as:
  360.  
  361.                CED SYN del*ete c:\util\filer2.exe delete
  362.  
  363.           Then a command like "del *.*" will use FILER2's delete function
  364.           rather than the DOS delete function.
  365.  
  366.  
  367.  
  368.  
  369.  
  370.           Copyright and disclaimer
  371.           ------------------------
  372.  
  373.           The FILER2 program and this document are copyrighted by the
  374.           author.  However, they are released for public distribution.
  375.           FILER2 is intended for your PRIVATE, NONCOMMERCIAL USE ONLY.  You
  376.           may make copies of the FILER2 program and of this documentation
  377.           file (you must retain this notice!) for your own use or for the
  378.           use of others.  You may NOT, however, charge for any such copies,
  379.           or in any other way sell the program or attempt to make money
  380.           from it or any modified version of it.  Please.
  381.  
  382.           An exception to the above is granted to recognized user's groups,
  383.           which are authorized to charge a small amount (not to exceed
  384.           $6.00) for media, postage, handling, etc.
  385.  
  386.           Those who wish to use FILER2 in a commercial environment should
  387.           contact the author at the address given below.
  388.  
  389.           I do not warrant that the program is free from defects, that it
  390.           operates as designed, or that the documentation is accurate.  I
  391.           will not be liable for any damages of any kind sustained through
  392.           the use of the program.  By using the program, you agree to this.
  393.  
  394.                                 * * * * * * * * * * *
  395.  
  396.           Remember, this is a TEST version of FILER2.  There may be, and
  397.           probably are, bugs--so use it carefully.  Make liberal use of the
  398.           /P (preview) mode.  Comments, suggestions, and bug reports
  399.           (please be specific) may be reported to the address below, or
  400.           (better) via CompuServe.  The best way to contact me is via the
  401.           IBM Novice Forum (PCS129 or IBMNOV); my user ID is 76703,2002.
  402.  
  403.                                * * * * * * * * * * * *
  404.  
  405.                                 Copyright (c) 1986 by
  406.                                Christopher J. Dunford
  407.  
  408.                                The Cove Software Group
  409.                                     P.O. Box 1072
  410.                               Columbia, Maryland 21044
  411.                                    (301) 992-9371
  412.  
  413.