home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / PLJV.ZIP / LJV.DOC < prev    next >
Text File  |  1991-06-27  |  57KB  |  1,566 lines
  1.  
  2.         LJV Tool Kit for OS/2 and DOS               Release 1e
  3.         June 26, 1991
  4.  
  5.         Copyright 1989-1991 by Les J. Ventimiglia
  6.  
  7.  
  8.  
  9.         Introduction
  10.         ____________
  11.  
  12.         Over the years, I have been developing tools to increase my
  13.         productivity in programming for OS/2 and/or DOS.  My goal was 
  14.         to produce or at least enhance many of the commands that come
  15.         as default with the operating system.  I have put several of
  16.         these onto bulletin boards to test the shareware concept. I
  17.         have asked for a meager amount from my users to support my
  18.         development. I am aware that there are many users of my
  19.         tools out there with only about 1% willing to support my
  20.         efforts.  
  21.  
  22.         Now, in an effort to let it be known that shareware is NOT
  23.         freeware, I am forced to submit programs that work correctly
  24.         but lack some advanced features.  To get the advanced
  25.         features, each user will have to register with me for the
  26.         meager sum.
  27.  
  28.  
  29.  
  30.         Contents
  31.         ________
  32.  
  33.         The following programs are included in this release of the 
  34.         LJV Tool Kit.
  35.  
  36.  
  37.         Program      Rev. Comments               Price for registered
  38.                                               version (bound or protected)
  39.         ------------ ---- ---------------------------------------------
  40.         LJV.DOC           This document file.
  41.         ATTR.EXE     6.2  File attribute changer.        5
  42.         BGREP.EXE    6.5  Binary Grep                   10
  43.         COMP.EXE     6.9a Binary File Compare           10
  44.         ERA.EXE      6.6  File erase.                    5
  45.         FCOMP.EXE    6.9  Source File Compare           10
  46.         FF.EXE       6.3  File Find
  47.         FREE.EXE     6.4  Disk free space
  48.         JET.EXE      2.3  HP LaserJet print program      5
  49.         LSD.EXE      6.4  List Directory/Files
  50.         LWHAT.EXE    1.0  What string/checksum displayer
  51.         RFD.EXE      6.7  Remove Files/Directories       5
  52.         SWEEP.EXE    6.2  Execution Sweeper
  53.         TAB.EXE      6.4  Tab remover/inserter.          5
  54.         TOUCH.EXE    6.3  File Date/Time toucher.        5
  55.         TREE.EXE     6.2  Directory tree displayer.     
  56.         VCD.EXE      6.8  Ventimiglia Change Directory  15
  57.         C.CMD             Batch file for use with VCD.
  58.         
  59.         The price for all of the registered versions of the tools is
  60.         $40.  When ordering, one should specify which set of tools is
  61.         being purchased, either the bound set (BLJV) or the
  62.         protected mode only set (PLJV).
  63.  
  64.         Features
  65.         ________
  66.         
  67.         - simple command line interface.
  68.         - color (most programs)
  69.         - HPFS long filename support.
  70.         - added functionallity over OS versions of similar programs.
  71.         - Bound programs run under OS/2 and in the DOS-BOX or under
  72.           DOS.
  73.                         
  74.         Changes from previous release
  75.         _____________________________
  76.  
  77.         Release 1a has updated versions of FCOMP, JET and SWEEP.
  78.         Release 1b has updated versions of COMP and FREE.
  79.         Release 1c has updated versions of FCOMP, LCD and ERA.
  80.         Release 1d has LCD renamed to VCD to eliminate confusion
  81.                        between my directory change program and
  82.                        another program also called LCD.
  83.                        TAB.EXE has been updated. 
  84.         Release 1e has removed the beep from non-restricted versions.
  85.  
  86.  
  87.         VIO/Network/Windows Warnings
  88.         ____________________________
  89.  
  90.  
  91.         Through out the testing of the enclosed tools, I have found
  92.         that the VIO functions used to display out put onto the
  93.         screen may not work as expected when run in real mode in a
  94.         Windows windowed DOS session or if your are running the 
  95.         Novell client software on top of real mode DOS.
  96.  
  97.         For Windows 3.0, I have found that if I run a VIO'ed program
  98.         in a windowed DOS box, I tend to get black characters on a
  99.         black background.  This problem goes away as soon as the
  100.         cursor reaches the bottom of the windowed box.
  101.  
  102.         For Novell, I have found that running VIO'ed programs tend to
  103.         crash the client software if the network card is set to I/O
  104.         port at 2e0h.  The solution to this problem it to move the
  105.         port address to 300h.  Port 2f0h tends to conflict with
  106.         Windows 3.0.
  107.  
  108.         Common parameter syntax
  109.         _______________________
  110.  
  111.         All programs in this tool kit share a common parameter
  112.         parsing philosophy.  In general parameters can be entered in
  113.         any order (except where specified).
  114.  
  115.         Options are preceeded by the forward slash character, "/". 
  116.         The dash character is not used for options, I just found too
  117.         many cases where someone used the dash character in filenames
  118.         making parsing difficult.
  119.  
  120.         Options can be combined or be specified separately before or
  121.         after any of the filespecs.
  122.         
  123.                 /sv == /v/s == /s /v
  124.  
  125.         The help option is "/?" and is available on all programs.
  126.  
  127.  
  128.  
  129.         CHANGING FILENAME COLORS and ADDING COLORS FOR NEW EXTENSIONS
  130.         _____________________________________________________________
  131.  
  132.         
  133.         Several of my programs use color to distinguish the various
  134.         types of files.  If you do not like the default color scheme,
  135.         you can patch the file at your own risk.  Only experienced 
  136.         computer users should attempt patching programs.  Each
  137.         program listed below allows color changes.
  138.  
  139.                 ATTR.EXE        ERA.EXE         FF.EXE
  140.                 LSD.EXE         RFD.EXE
  141.         
  142.         Each of these programs contain a table of extensions, each
  143.         with its own color.  The table allows one to specify up to 
  144.         30 filename extensions to color.  You should know how to use 
  145.         DEBUG or SYMDEB or similar patching program to make these 
  146.         modifications.  Always make a backup copy of the program 
  147.         before patching.  
  148.  
  149.         The patches will be made to a table that contains the 
  150.         extensions and the associated color.  You can find the table
  151.         by searching for the string "HERE".
  152.  
  153.         After the string "HERE" are 8 bytes, in the following order:
  154.                 
  155.            - Foreground Color of Messages.
  156.            - Foreground Color of Directory entries.
  157.            - Foreground Color of Long File Names (those > 11 characters).
  158.            - Default Foreground Color.
  159.            - 3 bytes of zeros. 
  160.            - Number of color entries (NumberOfEntries).
  161.  
  162.         After the NumberOfEntries byte, starts the extension color
  163.         table.  Each entry in the table is 4 bytes long, the first 3
  164.         bytes contain the extension in UPPERCASE letters.  If the
  165.         extension is only 1 or 2 bytes in length, insert blanks
  166.         BEFORE the extension to make it 3 bytes long. The extension
  167.         "C" should be adjusted to be "  C".  The byte following the
  168.         extension is its foreground color.  DO NOT PUT MORE THAN 30
  169.         ENTRIES IN THE TABLE.
  170.  
  171.         Once you have filled in the extension table, you will have to
  172.         put the count of extension entries in the NumberOfEntries
  173.         byte.  The default table has the following 17 extensions:
  174.  
  175.                 ASM     COM     EXE     LNK     TXT
  176.                 BAT     DEF       H     LRF
  177.                   C     DLL     INC     OBJ
  178.                 CMD     DOC     LIB     SYS
  179.  
  180.         You can add to this table (max 30 entries) or change any of
  181.         the existing ones, just make sure the NumberOfEntries field
  182.         reflects the new total of entries.
  183.  
  184.  
  185.  
  186.         SHAREWARE
  187.         _________
  188.  
  189.         LJV.ZIP is distributed under the SHAREWARE concept.
  190.         You are encouraged to copy and share this kit with other users.
  191.         Please do not remove the copyright or the user-supported notice.
  192.  
  193.         SUPPORT SHAREWARE WITH YOUR REGISTRATION FEES!!
  194.         
  195.         SHAREWARE is based on these three beliefs:
  196.  
  197.         1.  The value of software is best assessed by the
  198.             user on his own system.
  199.         2.  Creation of personal computer software can and
  200.             should be supported by computing community.
  201.         3.  That copying of programs should be encouraged,
  202.             rather than restricted.
  203.  
  204.  
  205.         Copyright/License/Warranty
  206.         __________________________
  207.  
  208.         This document and the current version of this took kit
  209.         ("the software") are copyrighted by the author. The
  210.         copyright owner hereby licenses you to: use the software; make
  211.         as many copies of the program and documentation as you wish;
  212.         give such copies to anyone; and distribute the software and
  213.         documentation via electronic means.
  214.  
  215.         However, you are specifically prohibited from charging, or
  216.         requesting donations, for any such copies, however made. 
  217.  
  218.         No copy of the software may be distributed or given away without
  219.         this document; and this notice must not be removed.
  220.  
  221.         There is no warranty of any kind, and the copyright owner is not
  222.         liable for damages of any kind. By using the software, you agree
  223.         to this.
  224.  
  225.         Registered versions of LJV programs will not display the 
  226.         "Not Registered" notice when run.  These registered programs
  227.         MUST not be copied except for purposes of backup and must be
  228.         used only by the registered owner.  You are prohibited from
  229.         any other copying of registered versions by any other means.
  230.  
  231.  
  232.  
  233.         Registration
  234.         ____________
  235.  
  236.  
  237.         To receive a registered tool kit, send registration fee 
  238.         and/or questions to :
  239.  
  240.         Les J. Ventimiglia
  241.         15247 Monroe Ave.
  242.         Moorpark, CA. 93021
  243.  
  244.         (805) 529-6370
  245.  
  246.         Individual programs can be separately registered.  Pricing
  247.         for each program can be found in the Contents section or in
  248.         the help info for the program.
  249.  
  250.         Group discounts should be negotiated.
  251.  
  252.         OS/2 Protected mode tool kit (PLJV.ZIP)...........$40.00
  253.         Bound version tool kit.......(BLJV.ZIP)...........$40.00
  254.        
  255.         _____________________________________________________________
  256.                                                                      
  257.  
  258.                                 ATTR.EXE
  259.        
  260.         _____________________________________________________________
  261.  
  262.  
  263.         ATTR is an enhanced ATTR command.
  264.  
  265.  
  266.         Change History
  267.         ______________
  268.  
  269.  
  270.         Version 6.0 12sep90 is the first release as Shareware.  
  271.         Version 6.1 25feb91 modified for registration.
  272.         Version 6.2 18jun91 Removed beep from non-registered version.
  273.  
  274.  
  275.         Syntax
  276.         ______
  277.  
  278.  
  279.         ATTR [/sqvpm] [-+=ahrs] [filespec ...]
  280.  
  281.         Where : /s = Traverse all subdirectories below the ones
  282.                      specified.
  283.                 /q = Quiet mode. Nothing is displayed.
  284.                 /m = Mono (no color).
  285.                 /p = Pause when screen is full.
  286.                 /v = Forces verification of each attribute change. 
  287.                      You then have the option of changing or not 
  288.                      changing the attribute for each file.
  289.                 /? = For this usage summary.
  290.  
  291.                 - removes attributes.
  292.                 + adds attributes.
  293.                 = sets attributes to only those specified.
  294.  
  295.                 a (archive) h (hidden) r (readonly) s (system)
  296.  
  297.                 filespec = Any filename or directory. Multiple
  298.                      specifications can be used, long filenames that
  299.                      contain spaces should be enclosed in quotes.
  300.                      Wild card characters can be used in any specification.
  301.  
  302.         If verify (/v) if not specified, the files will be displayed
  303.         along with the attributes associated with the file.
  304.         If the entry is a directory, it will be preceeded by "\".
  305.  
  306.         All 8.3 names will be listed first, followed by 8.3 directory
  307.         names, long file name files, and finally long file name
  308.         directories.
  309.  
  310.         NOTE: The /s and /v options can be found only on the registered
  311.               version.
  312.  
  313.  
  314.         EXAMPLES
  315.         ________
  316.         
  317.         To display the attributes of files in the current directory and
  318.         all files in its subdirectories:
  319.  
  320.                 ATTR /s
  321.  
  322.         To set attr.doc and attr.exe to readonly:
  323.  
  324.                 ATTR attr.doc attr.exe +r
  325.  
  326.         To set just the archive bit for attr.doc:
  327.  
  328.                 ATTR =a attr.doc
  329.  
  330.         To remove the hidden bit from all files on the disk:
  331.  
  332.                 ATTR -h \*.*/s
  333.  
  334.         _____________________________________________________________
  335.                                                                      
  336.  
  337.                                BGREP.EXE
  338.        
  339.         _____________________________________________________________
  340.  
  341.  
  342.         BGREP (Binary Grep).  Searches for binary patterns within
  343.         files. 
  344.  
  345.         This documentation describes the registered version of BGREP. 
  346.         The non-registered version does not support the /s
  347.         options. Nor does it allow wild card hex patterns.
  348.  
  349.  
  350.         Change History
  351.         ______________
  352.  
  353.  
  354.         Version 6.0 10jun90 Added HPFS support.
  355.         Version 6.1 11sep90 was the first release as Shareware.
  356.                             Added Pause (/p) switch.
  357.         Version 6.2 20sep90 Fixed "out of memory" in DOS.
  358.         Version 6.3 03oct90 Cleaned up typo in help message.
  359.         Version 6.4 25feb91 Updated copyright, modified for
  360.                                 registration.
  361.         Version 6.5 18jun91 Removed beep from non-registered version.
  362.  
  363.         Syntax
  364.         ______
  365.  
  366.  
  367.         BGREP [/smp] filespec hex-pattern
  368.  
  369.         Where : /s = Traverse all subdirectories below the ones
  370.                      specified.
  371.                 /m = Mono (no color).
  372.                 /p = Pause when screen is full.
  373.                 /? = For this usage summary.
  374.  
  375.                 filespec = File(s) to search.  Only one
  376.                      specification can be used, long filenames that
  377.                      contain spaces should be enclosed in quotes.
  378.                      Wild card characters can be used in the specification.
  379.  
  380.                 hex-pattern = any even sequence of hexidecimal
  381.                      digits, (0..9,A..F,a..f).  This pattern must
  382.                      contain an even number of digits (2 per byte).
  383.                      No spaces are allowed within the pattern.  To
  384.                      specify any byte as wild replace the
  385.                      corresponding two hex digits with two question
  386.                      marks (??).
  387.  
  388.  
  389.         OPERATION
  390.         _________
  391.  
  392.  
  393.         For each match of "hex-pattern" found, BGREP will display the
  394.         pattern in hex and ascii format along with the starting
  395.         offset into the file.
  396.  
  397.  
  398.         EXAMPLES 
  399.         ________
  400.  
  401.  
  402.         To find all occurrances of 0334 in "myfile" use: 
  403.  
  404.                 BGREP myfile 0334
  405.  
  406.         To find all occurances of a 4 byte hex pattern starting with
  407.         a wild hex digit followed by 414243 in any of the files in
  408.         the current directory :
  409.  
  410.                 BGREP *.*  ??414243
  411.  
  412.         OS/2 users should use * instead of *.* to search all files.
  413.  
  414.         _____________________________________________________________
  415.                                                                      
  416.  
  417.                                 COMP.EXE
  418.        
  419.         _____________________________________________________________
  420.  
  421.  
  422.         COMP (Binary COMPare files).  This utility allows one to 
  423.         compare all the files in one tree against those of another 
  424.         tree, great for checking backups.
  425.  
  426.         This documentation describes the registered version of COMP. 
  427.         The non-registered version does not support the /e or /s
  428.         options. Nor does it display the mis-matches found.
  429.  
  430.  
  431.         Change History
  432.         ______________
  433.  
  434.  
  435.         Version 6.0 24jun90 was the first release as Shareware.
  436.         Version 6.1 15aug90 Modified display of data mismatch offset
  437.                             from decimal to hexidecimal.
  438.         Version 6.2 11sep90 Fixed "comp x: y:" bug.
  439.                             Fixed "comp *.xyz *.x" bug.
  440.                             Fixed protected mode wild card matching.
  441.         Version 6.3 11oct90 Increased compare buffer size to 32k from 20k
  442.         Version 6.4 12oct90 Added code to display first 10 mismatches.
  443.         Version 6.5 19nov90 Increased compare buffer size to 32k from 20k
  444.         Version 6.6 09dec90 Fixed "comp abc.* efg.*" bug
  445.         Version 6.7 18dec90 Split into registered and non-registered
  446.                             versions.
  447.         Version 6.8 25feb91 Updated copyright.
  448.         Version 6.9 05mar91 Number each mismatch, indicate when more
  449.                             than 10 mismatchs occur (registered only).
  450.                             Fixed display of % sign.
  451.         Version 6.9a 18jun91 Removed beep from non-registered version.
  452.  
  453.  
  454.         Syntax
  455.         ______
  456.  
  457.  
  458.         COMP [/ems] filespec1 filespec2
  459.  
  460.         Where : /m = Mono (no color).
  461.                 /? = Displays usage summary.
  462.  
  463.                 /e = Display errors only.  
  464.                 /s = Traverse all subdirectories below the ones
  465.                      specified.
  466.  
  467.                 filespec1 is the source file or directory
  468.  
  469.                 filespec2 is the target file or directory    
  470.         
  471.         Wild card characters are accepted in the filespecs. Long file
  472.         names containing spaces should be enclosed in quotes.
  473.  
  474.         The following errors may appear:
  475.         
  476.         NOT FOUND     : The target file could not be found.
  477.         SIZE MISMATCH : The source and target are of different sizes.
  478.         DATA MISMATCH @XXXXXXXX : The source and target are the same
  479.                       size, but differ in content starting at xxxxxxx.
  480.                 
  481.         EXAMPLES
  482.         ________
  483.  
  484.         
  485.         To check the contents of one tree on drive c: against the
  486.         contents of your backup on drive d:
  487.  
  488.                 COMP c:\source d:\target /s
  489.  
  490.         The same operation as above but showing errors only:
  491.  
  492.                 COMP /se c:\source d:\target
  493.  
  494.         To compare only assembler source files in the current
  495.         directory against those in the parent directory:
  496.  
  497.                 COMP *.asm ..
  498.  
  499.  
  500.         ERRORLEVEL
  501.         __________
  502.  
  503.  
  504.         Since COMP sets the errorlevel on return to the command
  505.         prompt, it can be used in batch files.  The Errorlevel will
  506.         be set to a value between 0 and 7 as follows:
  507.  
  508.                 No errors found returns 0.
  509.                 Any target files not found will OR in a 1.
  510.                 Any file size mis-matches wll OR in a 2.
  511.                 Any file data mis-compares will OR in a 4.
  512.  
  513.         Thus if any target files are not found and if there is a data
  514.         mis-compare, the errorlevel will be set to 4 OR'd with 1 = 5.
  515.  
  516.         _____________________________________________________________
  517.                                                                      
  518.  
  519.                                  ERA.EXE
  520.        
  521.         _____________________________________________________________
  522.  
  523.  
  524.         ERA (Erase/Delete Files). A safe file deletion program.
  525.  
  526.         This documentation describes the registered version of ERA. 
  527.         The non-registered version does not support the /s, /v or /a
  528.         options.
  529.  
  530.  
  531.         Change History
  532.         ______________
  533.  
  534.  
  535.         Version 6.0 10jun90 Added HPFS long filename support
  536.         Version 6.1 11sep90 First release as Shareware.  
  537.                             Modified colors to use a color table.
  538.                             Corrected detection of short extensions
  539.                             for the display color.
  540.         Version 6.2 03oct90 Added code to not delete "ea data. sf"  
  541.         Version 6.3 04oct90 /av options no longer give error message.
  542.         Version 6.4 25feb91 Updated copyright, modified for
  543.                                 registration.
  544.         Version 6.5 08apr91 Fixed display when one file was deleted
  545.                                 using the /sv options.
  546.         Version 6.6 18jun91 Removed beep from non-registered version.
  547.  
  548.  
  549.         Syntax
  550.         ______
  551.  
  552.  
  553.         ERA [/pqsvma] filespec...filespec
  554.  
  555.         Where : /p = Preview mode. This mode allows you to review
  556.                      what would be deleted (removed) without actually
  557.                      deleting the files.
  558.                 /q = Quiet mode. Nothing is displayed on the screen. 
  559.                      No verification is requested.
  560.                 /s = Traverse all subdirectories below the ones
  561.                      specified.
  562.                 /v = Forces verification of each deletion. You then have 
  563.                      the option of deleting or not deleting each file.
  564.                 /m = Mono (no color).
  565.                 /a = Allows removal of Hidden/System/ReadOnly files.
  566.                      ERA will not remove these files without this option.
  567.                 /? = For this usage summary.
  568.  
  569.                 filespec = Any filename or directory. Multiple
  570.                      specifications can be used, long filenames that
  571.                      contain spaces should be enclosed in quotes.
  572.                      Wild card characters can be used in any specification.
  573.  
  574.         The default is to display the files if wild card are used. ERA
  575.         then asks you if you want to delete the files.  If you do not
  576.         use wild cards, ERA will delete the specified files without
  577.         any prompts.
  578.  
  579.         System files can only be deleted by using both the /a and the 
  580.         /v options.
  581.  
  582.         All 8.3 names will be listed first, followed by long filenames.
  583.  
  584.  
  585.         EXAMPLES
  586.         ________
  587.  
  588.         
  589.         To delete attr.doc and attr.exe from the current directory:
  590.  
  591.           ERA attr.doc attr.exe
  592.  
  593.         To delete all files with .obj and .map extension without
  594.           confirmation:
  595.  
  596.         ERA *.obj *.map/q
  597.  
  598.         _____________________________________________________________
  599.                                                                      
  600.  
  601.                                FCOMP.EXE
  602.        
  603.         _____________________________________________________________
  604.  
  605.  
  606.         FCOMP (Source File COMPare).  This utility allows one to
  607.         compare all of the source files in one tree against those of 
  608.         another tree.  
  609.  
  610.         FCOMP displays its output in a choice of two different formats.
  611.  
  612.         This documentation describes the registered version of FCOMP. 
  613.         The non-registered version does not support the /d, /f or /s
  614.         options.
  615.  
  616.  
  617.         Change History
  618.         ______________
  619.  
  620.  
  621.         Version 6.0 24jun90 First release as Shareware.  
  622.         Version 6.1 27jul90 Fixed the /f option. File 1 info after 
  623.                                 the first 38 characters was not being 
  624.                                 displayed.
  625.         Version 6.2 11sep90 Fixed "fcomp x: y:" bug.
  626.                             Fixed "fcomp *.xyz *.x" bug.
  627.                             Fixed protected mode wild card matching.
  628.         Version 6.3 09dec90 Fixed "fcomp abc.* efg.*" bug
  629.         Version 6.4 26dec90 Split into registered and non-registered
  630.                                 versions.
  631.         Version 6.5 22feb91 Added code to prevent hang when max line
  632.                                 exceeded.
  633.         Version 6.6 25feb91 Updated copyright. Fixed bug which
  634.                                 expanded printf formatting
  635.                                 incorrectly.
  636.         Version 6.7 03mar91 Fixed problem with redirection caused by 
  637.                                 printf fix in rev 6.6.
  638.         Version 6.8 08apr91 Fixed which hung when files with more
  639.                                 than 5000 lines were read in.
  640.         Version 6.9 18jun91 Removed beep from non-registered version.
  641.  
  642.         Syntax
  643.         ______
  644.  
  645.  
  646.         FCOMP [/dfms] filespec1 filespec2
  647.  
  648.         Where : /d = Display in "diff" format. Additions, deletions, 
  649.                      and changes to filespec1 to make filespec2 are shown.
  650.  
  651.                 /f = When displaying the changes in "column" format, 
  652.                      the first 38 columns of each line is displayed.
  653.                      This option will cause the remaining characters 
  654.                      in each line to be displayed.     
  655.  
  656.                 /m = Mono (no color).
  657.                 /s = Traverse all subdirectories below the ones
  658.                      specified.
  659.                 /? = Displays usage summary.
  660.  
  661.                 filespec1 is the source file or directory
  662.  
  663.                 filespec2 is the target file or directory    
  664.         
  665.         Wild card characters are accepted in the filespecs. Long file
  666.         names containing spaces should be enclosed in quotes.
  667.  
  668.  
  669.         EXAMPLE
  670.         _______
  671.  
  672.         
  673.         To compare the contents of one tree on drive c: against the
  674.         contents of your backup on drive d:, show results in column 
  675.         format (the default):
  676.  
  677.                 FCOMP c:\source d:\target /s
  678.  
  679.         To compare file 1.doc to 2.doc and show the results in "diff"
  680.         format:
  681.  
  682.                 FCOMP 1.doc 2.doc /d
  683.  
  684.         _____________________________________________________________
  685.                                                                      
  686.  
  687.                                   FF.EXE
  688.        
  689.         _____________________________________________________________
  690.  
  691.  
  692.         FF (File Finder).  Searches disks for specified files. 
  693.  
  694.  
  695.         Change History
  696.         ______________
  697.  
  698.  
  699.         Version 6.0 06jun90 Added HPFS support.
  700.         Version 6.1 14aug90 was the first release as Shareware.
  701.                             Modified display of data mismatch offset
  702.                             from decimal to hexidecimal.
  703.         Version 6.2 08sep90 Corrected detection of short extensions
  704.                             for the display color.
  705.                             Added Pause (/p) switch.
  706.         Version 6.3 25feb91 Updated copyright.
  707.  
  708.  
  709.         Syntax
  710.         ______
  711.  
  712.  
  713.         FF [/a] [/c] [d:[\]]filespec
  714.  
  715.         Where : /a = Starts search on floppy drive A:
  716.                 /c = Starts search on hard disk C:, skipping A: and B:
  717.                 /m = Mono (no color).
  718.                 /p = Pause when screen is full.
  719.                 /? = For this usage summary.
  720.  
  721.                 d: = Drive for search, if not specified, the current
  722.                      drive will be used.
  723.    
  724.                 filespec = File(s) to search for.  Only one
  725.                      specification can be used, long filenames that
  726.                      contain spaces should be enclosed in quotes.
  727.                      Wild card characters can be used in the specification.
  728.  
  729.         NOTE: If filename is in the DOS format (8.3) and extension is
  730.               not supplied, FF will search for all extensions.
  731.  
  732.         EXAMPLES:
  733.         
  734.         To find all files on the current drive that have a base name
  735.         of "myfile" use :
  736.  
  737.                 FF myfile
  738.  
  739.         To find all occurances of format programs on any drive use:
  740.  
  741.                 FF format /a
  742.  
  743.         To find all files ending with the .xyz extension on any of
  744.         your hard drives use:
  745.  
  746.                 FF /c *.xyz
  747.  
  748.         _____________________________________________________________
  749.                                                                      
  750.  
  751.                                 FREE.EXE
  752.        
  753.         _____________________________________________________________
  754.  
  755.  
  756.         FREE (Display Free space on disk).
  757.  
  758.  
  759.         Change History
  760.         ______________
  761.  
  762.  
  763.         Version 6.0 06jun90 Added HPFS detection.
  764.         Version 6.1 15sep90 Added commas to bytes display.    
  765.                             First release as Shareware.
  766.         Version 6.2 20sep90 Corrected detection of machine mode.
  767.         Version 6.3 25feb91 Updated copyright. Added bytes allocated
  768.                                 to display.
  769.         Version 6.4 05mar91 Move blank line in output.
  770.  
  771.         
  772.         Syntax
  773.         ______
  774.  
  775.  
  776.         FREE [d[:]...]
  777.  
  778.         Where : d[:] is any valid logical drive letter.
  779.                      The colon is not required.
  780.  
  781.         OPERATION
  782.         _________
  783.  
  784.  
  785.         FREE uses system calls to get the amount of free space and
  786.         total space on the logical drive(s) requested.  FREE also
  787.         determines (if it can) what file system the logical drive
  788.         has been formatted for (FAT or HPFS).  FAT is the File
  789.         Allocation Table format used in DOS and OS/2 1.1.  HPFS is
  790.         the OS/2 file system introduced in version 1.2.
  791.  
  792.         EXAMPLES 
  793.         ________
  794.  
  795.  
  796.         To display the free space of the current disk:
  797.  
  798.                         FREE
  799.  
  800.         To display the free space of drives C: and D:
  801.  
  802.                         FREE c d      or   FREE c: d:
  803.  
  804.  
  805.         _____________________________________________________________
  806.                                                                      
  807.  
  808.                                  JET.EXE
  809.        
  810.         _____________________________________________________________
  811.  
  812.  
  813.         JET prints listings or text files on HP Laserjet printers. 
  814.         Pages are printed on 8.5" by 11" paper at 160 lines per page.
  815.         Lines on the page can be up to 156 columns in length.
  816.  
  817.         This documentation describes the registered version of COMP. 
  818.         The non-registered version does not support the /s or /l
  819.         options. Nor does it display the mis-matches found.
  820.  
  821.  
  822.         Change History
  823.         ______________
  824.  
  825.  
  826.         Version 2.0 20feb91 Started modifications for OS/2.
  827.         Version 2.1 25feb91 Fixed long line problem, modified for
  828.                                 registration.
  829.         Version 2.2 05mar91 Issue printer reset when done with printing.
  830.         Version 2.3 18jun91 Removed beep from non-registered version.
  831.  
  832.         
  833.         Syntax
  834.         ______
  835.  
  836.  
  837.         JET [/sfl] filespec...filespec
  838.  
  839.         where /s = Affects all files below the specified (or implied)
  840.                    directories.
  841.  
  842.               /f = Suppress the printing of Form Feeds.
  843.  
  844.               /l = Places line numbers to the left of each line.
  845.  
  846.         NOTE: If you are using the Microsoft Macro Assembler to produce 
  847.               listings, set the page directive to the following:
  848.  
  849.               PAGE 159,132
  850.                 
  851.               This is due to the fact that MASM always gives you one
  852.               more line than you ask for.
  853.                           
  854.         NOTE: If the first character of the file is a Form Feed, it is
  855.               always ignored (not printed).
  856.          
  857.        
  858.         EXAMPLES
  859.         ________
  860.  
  861.         
  862.         To print all assembler listings in your current directory:
  863.  
  864.                 JET *.lst
  865.  
  866.         To print all "C" files with line numbers:
  867.  
  868.                 JET *.c /l
  869.  
  870.         To print a lst file in one continuous listing without page
  871.         breaks:
  872.  
  873.                 JET file.lst /f 
  874.  
  875.         _____________________________________________________________
  876.                                                                      
  877.  
  878.                                  LSD.EXE
  879.        
  880.         _____________________________________________________________
  881.  
  882.  
  883.         LSD (LiSt Directories).  Displays a sorted directory listing.
  884.  
  885.  
  886.         Change History
  887.         ______________
  888.  
  889.  
  890.         Version 6.0 24jun90 was the first release as Shareware.  
  891.         Version 6.1 25jun90 added the /1 option.
  892.         Version 6.2 13jul90 fixes the /d /e and /f options what were broken
  893.                             when I added long filename support.  I didn't 
  894.                             notice the bug until someone pointed it out to me, 
  895.                             I never use those options myself.
  896.                             Put colors used to display filenames in an array
  897.                             so that experienced users may change the
  898.                             colors to their favorite.
  899.         Version 6.3 09dec90 Fixed display of short names that had an
  900.                             extension longer than 3 characters or had 
  901.                             multiple dots.
  902.         Version 6.4 26feb91 Updated copyright. Now uses colors to
  903.                                 distinguish long file names.
  904.  
  905.  
  906.         Syntax
  907.         ______
  908.  
  909.  
  910.         LSD [/defhmnpsw1] [filespec ...]
  911.  
  912.         Where : /d = Sort by date/time.
  913.                 /e = Sort by extension.
  914.                 /f = Sort by filesize.
  915.                 /h = Show hidden and system files along with normal files.
  916.                 /m = Mono (no color).
  917.                 /n = No date/time/filesize (long filename display only).
  918.                 /p = Pause when screen is full.
  919.                 /s = Traverse all subdirectories below the ones
  920.                      specified.
  921.                 /w = Display 8.3 filenames in wide format (up to 5
  922.                      per line).
  923.                 /1 = Display directory entries one per line.
  924.                 /? = For this usage summary.
  925.  
  926.                 filespec = Any filename or directory. Multiple
  927.                      specifications can be used, long filenames that
  928.                      contain spaces should be enclosed in quotes.
  929.                      Wild card characters can be used in any specification.
  930.  
  931.         The last sort option (/def) specified will be used.
  932.  
  933.         All files listed will be preceeded by an attribute indictor and 
  934.         a directory indicator.
  935.  
  936.         R=ReadOnly H=Hidden S=System <space>=Normal
  937.  
  938.         If the entry is a directory, it will be preceeded by "\".
  939.  
  940.         All 8.3 names will be listed first, followed by 8.3 directory
  941.         names, long file name files, and finally long file name
  942.         directories.
  943.  
  944.  
  945.         EXAMPLES
  946.         ________
  947.  
  948.         
  949.         To display the files in the current directory and all files in 
  950.         its subdirectories sorted by date, pausing when screen is full:
  951.  
  952.                 LSD /spd
  953.  
  954.         To display the files on drive A: in order of filesize.
  955.  
  956.                 LSD a:\/f
  957.  
  958.         To display all files in the root directory in wide format:
  959.  
  960.                 LSD /wh c:\
  961.  
  962.         To display all .com files in the bin directories of 
  963.         drives c: and a:
  964.  
  965.                 LSD c:\bin\*.com a:\bin\*.com
  966.  
  967.         Many users prefer to use a command line editor and equate a 
  968.         synonym to lsd.  I use the synonym "d" for "lsd /hp ".
  969.  
  970.  
  971.         _____________________________________________________________
  972.                                                                      
  973.  
  974.                                 LWHAT.EXE
  975.        
  976.         _____________________________________________________________
  977.  
  978.  
  979.         LWHAT (Displays WHAT string found in executables and
  980.                 calculates any files checksum value).
  981.  
  982.  
  983.         Change History
  984.         ______________
  985.  
  986.  
  987.         Version 1.0 05jun91 Original version.
  988.  
  989.  
  990.         Syntax
  991.         ______
  992.  
  993.  
  994.         LWHAT [/scn] filespec...filespec
  995.  
  996.         Where : /s = Affects all files below the specified (or implied)
  997.                      directories.
  998.                 /c = Print checksum calculated for each file. 
  999.                 /n = Do not display filename.
  1000.  
  1001.         OPERATION
  1002.         _________
  1003.  
  1004.  
  1005.         LWHAT scans each file for a valid WHAT string beginning with
  1006.         either @[#] or @(#).  WHAT strings are used to view the
  1007.         version of the software and its use.  The checksum option can
  1008.         be used to validate the copy of a file matches the original.
  1009.  
  1010.         When scanning for the WHAT string, LWHAT searches first for a
  1011.         WHAT string beginning with @[#], then, if necessary for one
  1012.         beginning with @(#).
  1013.  
  1014.  
  1015.  
  1016.         EXAMPLES
  1017.         ________
  1018.  
  1019.  
  1020.         To display the WHAT string of all files in the c:\PLJV
  1021.         directory:
  1022.  
  1023.                         LWHAT c:\pljv\* 
  1024.  
  1025.         To display the WHAT string of all files containing them and
  1026.         the checksum of all files on drive C: use
  1027.  
  1028.                         LWHAT c:\* /sc
  1029.  
  1030.  
  1031.         _____________________________________________________________
  1032.                                                                      
  1033.  
  1034.                                  RFD.EXE
  1035.        
  1036.         _____________________________________________________________
  1037.  
  1038.  
  1039.         RFD (Remove Files & Directories). A safe and fast way to
  1040.         remove entire trees of files and directories.
  1041.  
  1042.  
  1043.         Change History
  1044.         ______________
  1045.  
  1046.  
  1047.         Version 6.0 06jun90 Added HPFS long filename support
  1048.         Version 6.1 15aug90 First release as Shareware.  
  1049.                             Modified colors to use a color table.
  1050.         Version 6.2 08sep90 Corrected detection of short extensions
  1051.                             for the display color.
  1052.         Version 6.3 16sep90 Removed real-mode message when no files 
  1053.                             were in directory being removed.
  1054.         Version 6.4 03oct90 Added code to not delete "ea data. sf"  
  1055.         Version 6.5 14dec90 Fixed "rfd a:\" under DOS.
  1056.         Version 6.6 26feb91 Updated copyright notice. Add
  1057.                                 registration notice.
  1058.         Version 6.7 18jun91 Removed beep from non-registered version.
  1059.  
  1060.         Syntax
  1061.         ______
  1062.  
  1063.  
  1064.         RFD [/pqma] path [path ...]
  1065.  
  1066.         Where : /p = Preview mode. This mode allows you to review
  1067.                      what would be deleted (removed) without actually
  1068.                      deleting the files.
  1069.                 /q = Quick mode. Directories are removed, nothing is
  1070.                      displayed on the screen. No prompts are used.
  1071.                 /m = Mono (no color). All messages will be plain white.
  1072.                 /a = Allows removal of Hidden/System/ReadOnly files.
  1073.                      RFD will not remove these files without this option.
  1074.                 /? = For this usage summary.
  1075.  
  1076.                 path = Any directory. Multiple specifications can be 
  1077.                      used, long filenames that contain spaces should be 
  1078.                      enclosed in quotes.  Wild card characters can be 
  1079.                      used in any specification.
  1080.  
  1081.         The default is to display the files in each directory and
  1082.         then RFD asks you if you want to delete the directory.
  1083.  
  1084.         All files listed will be preceeded by an attribute indictor and 
  1085.         a directory indicator.
  1086.  
  1087.         R=ReadOnly H=Hidden S=System <space>=Normal
  1088.  
  1089.         If the entry is a directory, it will be preceeded by "\".
  1090.  
  1091.         All 8.3 names will be listed first, followed by long filenames.
  1092.  
  1093.         EXAMPLES:
  1094.         
  1095.         To remove the contents of all files and directories from floppy
  1096.         disk A: (i.e. clean it up)
  1097.  
  1098.         RFD a:\/qa
  1099.  
  1100.         To remove the directories \TMP and \BACKUP with verification
  1101.         from drive C:
  1102.  
  1103.         RFD c:\tmp c:\backup
  1104.  
  1105.         _____________________________________________________________
  1106.                                                                      
  1107.  
  1108.                                SWEEP.EXE
  1109.        
  1110.         _____________________________________________________________
  1111.  
  1112.  
  1113.         SWEEP (Runs an application in the current directory and all
  1114.         of its sub-directories).
  1115.  
  1116.  
  1117.         Change History
  1118.         ______________
  1119.  
  1120.  
  1121.         Version 6.0 06jun90 Added HPFS detection.
  1122.                             First release as Shareware.
  1123.         Version 6.1 26feb91 Updated copyright.        
  1124.         Version 6.2 04mar91 Fixed help message.       
  1125.  
  1126.         
  1127.         Syntax
  1128.         ______
  1129.  
  1130.  
  1131.         SWEEP application-and-its-options
  1132.  
  1133.         SWEEP is used to execute a program (such as a grep
  1134.         utility) against many files in many directories.  Most
  1135.         application programs can not traverse through
  1136.         sub-directores.  This SWEEP utility will do the traversing
  1137.         for the program executing the program after changing to 
  1138.         each sub-directory.
  1139.  
  1140.         To use SWEEP, you must first change to the directory in which
  1141.         you want to start the sweep from.
  1142.  
  1143.         _____________________________________________________________
  1144.                                                                      
  1145.  
  1146.                                  TAB.EXE
  1147.        
  1148.         _____________________________________________________________
  1149.  
  1150.  
  1151.         TAB (Removes or adds tab characters to source files).
  1152.  
  1153.         This documentation describes the registered version of COMP. 
  1154.         The non-registered version does not support the /s or /q
  1155.         options.
  1156.  
  1157.  
  1158.         Change History
  1159.         ______________
  1160.  
  1161.  
  1162.         Version 6.0 06jun90 Added HPFS support.
  1163.         Version 6.1 15sep90 Added check to prevent translation on
  1164.                             files with the following extensions:
  1165.                             .exe .obj .lib .com .bin .sys .dll .res
  1166.         Version 6.2 26feb91 Made /s/e options valid on registered
  1167.                                 veraion. Updated copyright.
  1168.         Version 6.3 06jun91 Increased line buffers to 512 bytes to allow
  1169.                                 for expansion of long lines.
  1170.         Version 6.4 18jun91 Removed beep from non-registered version.
  1171.  
  1172.  
  1173.         Syntax
  1174.         ______
  1175.  
  1176.  
  1177.         TAB [-+#] [/sq] filespec...filespec
  1178.  
  1179.         Where : /s = Affects all files below the specified (or implied)
  1180.                      directories.
  1181.                 /q = Quite mode. TAB will not display filenames as the 
  1182.                      conversion takes place.
  1183.  
  1184.                 -# = Compression of up to # spaces per tab.
  1185.                 +# = Expansion of a tab to up to # spaces.
  1186.  
  1187.         The last -# or +# specified is used. Default is +8.
  1188.  
  1189.  
  1190.         OPERATION
  1191.         _________
  1192.  
  1193.  
  1194.         TAB reads each specified file and processes the file a line
  1195.         at a time.  Each processed line is written out to a temporary
  1196.         file that has the same base name but with an extension of
  1197.         ".@@@".  TAB converts only tab characters that are found
  1198.         outside of quoted strings.  Be careful not to use TAB on
  1199.         non-text files, it will permanently alter the file.
  1200.  
  1201.  
  1202.         EXAMPLES
  1203.         ________
  1204.  
  1205.  
  1206.         To remove the tabs from all "C" source files in the current 
  1207.         directory:
  1208.  
  1209.                         TAB *.c *.h
  1210.  
  1211.         To put the tabs back into the "C" source files:
  1212.  
  1213.                         TAB /v -8 *.c *.h
  1214.  
  1215.  
  1216.         _____________________________________________________________
  1217.                                                                      
  1218.  
  1219.                                TOUCH.EXE
  1220.        
  1221.         _____________________________________________________________
  1222.  
  1223.  
  1224.         TOUCH (File Date/Time Stamper).  Sets the files creation 
  1225.         date and time.
  1226.  
  1227.         This documentation describes the registered version of COMP. 
  1228.         The non-registered version does not support the /s option.
  1229.  
  1230.  
  1231.         Change History
  1232.         ______________
  1233.  
  1234.  
  1235.         Version 6.0 06jun90 Added HPFS support.
  1236.         Version 6.1 11sep90 Added address to help message.
  1237.         Version 6.2 27feb91 Modified for registration, copyright
  1238.                                 notice updated.
  1239.         Version 6.3 18jun91 Removed beep from non-registered version.
  1240.  
  1241.  
  1242.         Syntax
  1243.         ______
  1244.  
  1245.  
  1246.         TOUCH [/sv] [/tHHMM] [/dMMDD[YY]] filespec...filespec
  1247.  
  1248.         Where : /s = Traverse all subdirectories below the ones
  1249.                      specified.
  1250.  
  1251.                 /v = Displays each file as it is touched.
  1252.  
  1253.                 /? = For this usage summary.
  1254.  
  1255.                 /tHHMM = Set the touch time to HHMM. 
  1256.                      Where HH is the hour (00 to 23).
  1257.                            MM is the minute (00 to 59).
  1258.       
  1259.                 /dMMDD[YY] = Set the touch date to MMDD[YY].
  1260.                      Where MM is the month (01 to 12).
  1261.                            DD is the day of month (01 to 31).
  1262.                            YY is the last two digits of the year. 
  1263.  
  1264.                 filespec = Any filename or directory.  Multiple
  1265.                      specification can be used, long filenames that
  1266.                      contain spaces should be enclosed in quotes.
  1267.                      Wild card characters can be used in the specification.
  1268.  
  1269.  
  1270.         OPERATION
  1271.         _________
  1272.  
  1273.  
  1274.         The file(s) creation date will be set to the value specified.
  1275.  
  1276.         The Year will default to the current year if not given.
  1277.         The Date will default to the current date if not given.
  1278.         The Time will default to the current time if not given.  
  1279.  
  1280.  
  1281.         EXAMPLES 
  1282.         ________
  1283.  
  1284.  
  1285.         To touch all files in the current working directory with
  1286.         today's date and a time of 0000 while displaying each filename
  1287.         as it is being touched:
  1288.  
  1289.                         TOUCH *.* /vt0000
  1290.  
  1291.         To touch all files on drive A: including all files in all
  1292.         subdirectories to Jan 01, 1989 at 12pm:
  1293.  
  1294.                         TOUCH a:\*.* /st1200d010189
  1295.  
  1296.         The following line is will do the same touch:
  1297.  
  1298.                         TOUCH /s a:\*.* /t1200 /d010189
  1299.  
  1300.         _____________________________________________________________
  1301.                                                                      
  1302.  
  1303.                                 TREE.EXE
  1304.        
  1305.         _____________________________________________________________
  1306.  
  1307.  
  1308.         TREE (Directory Tree lister).  Allows one to visualize 
  1309.         the tree structure of a disk.  
  1310.  
  1311.  
  1312.         Change History
  1313.         ______________
  1314.  
  1315.  
  1316.         Version 6.0 15sep90 Added HPFS support.
  1317.                             Added Pause and Mono switches.    
  1318.                             First release as Shareware.
  1319.         Version 6.1 20sep90 Fixed "out of memory" problem in DOS.
  1320.         Version 6.2 27feb91 Updated copyright, added commas to number
  1321.                                 output.
  1322.  
  1323.  
  1324.         Syntax
  1325.         ______
  1326.  
  1327.  
  1328.         TREE [/smp] [path...path]
  1329.  
  1330.         Where : /s = Show total size of all files in each directory
  1331.                      encountered.
  1332.                 /m = Mono (no color). All messages will be plain white.
  1333.                 /p = Pause when screen is full.
  1334.                 /? = For this usage summary.
  1335.  
  1336.                 path = Any directory. Multiple specifications can be 
  1337.                      used, long filenames that contain spaces should be 
  1338.                      enclosed in quotes.  No wild cards allowed.
  1339.  
  1340.  
  1341.         OPERATION
  1342.         _________
  1343.  
  1344.  
  1345.         TREE uses the IBM graphic characters to display the directory
  1346.         structure of the path specified.  If no path is specified,
  1347.         TREE start with the current directory.  If displaying in
  1348.         color, each level of the tree will be shown in a different
  1349.         color.
  1350.  
  1351.  
  1352.         EXAMPLES 
  1353.         ________
  1354.  
  1355.  
  1356.         To display the entire tree of drive c: with sizes of
  1357.         all files in its subdirectories:
  1358.  
  1359.                         TREE c:\ /s
  1360.  
  1361.         To display the tree starting from the current directory:
  1362.  
  1363.                         TREE
  1364.  
  1365.         To display the same tree on different disks with sizes:
  1366.  
  1367.                         TREE c:\myfiles d:\myfiles /s
  1368.  
  1369.  
  1370.         _____________________________________________________________
  1371.                                                                      
  1372.  
  1373.                                  VCD.EXE
  1374.        
  1375.         _____________________________________________________________
  1376.  
  1377.  
  1378.         VCD (Ventimiglia Change Directory) is an enhanced change directory
  1379.         utility featuring a full screen mode and a command line
  1380.         pop-up window for similar name directory changes.
  1381.  
  1382.  
  1383.         This documentation describes the registered version of VCD. 
  1384.         The non-registered version does not support the full screen
  1385.         mode of operation.
  1386.  
  1387.  
  1388.         Change History
  1389.         ______________
  1390.  
  1391.  
  1392.         Version 6.0 15jun90 was the first release as Shareware.
  1393.         Version 6.1 21jun90 fixed bug which corrupted the root
  1394.                             directory entry of the vcd data file 
  1395.                             during a fullscreen rescan.
  1396.         Version 6.2 14aug90 fixes problem of running c.cmd while in the 
  1397.                             %TMP% directory while in protected mode.
  1398.         Version 6.3 11nov90 Fixed bug which cacused program to display
  1399.                             garbage on screen when entire map was <=
  1400.                             current number of lines per screen.
  1401.         Version 6.4 09dec90 Modified to work with shell programs that
  1402.                             cannot handle the OS/2 "&" operator.
  1403.         Version 6.5 26feb91 Modified for registration, copyright
  1404.                                 updated.
  1405.         Version 6.6 08apr91 Directory names are now sorted.
  1406.         Version 6.7 05jun91 Name changed to prevent confusion between
  1407.                                 my directory change program and
  1408.                                 Ledbetters DOS program.
  1409.         Version 6.8 18jun91 Removed beep from non-registered version.
  1410.  
  1411.         Syntax
  1412.         ______
  1413.  
  1414.  
  1415.         DOS or DOSbox of OS/2:
  1416.  
  1417.                 VCD [/rn] [d:][path]
  1418.  
  1419.         OS/2 protected mode:
  1420.                 
  1421.                 C [/rn] [d:][path]
  1422.                 
  1423.         Where : /r = Causes a complete rescan of the specified drive.  
  1424.  
  1425.                 /n = Do not write the VCD data file.
  1426.  
  1427.                 d: = Drive to scan.
  1428.  
  1429.                 path = partial path to change to. Only the portion 
  1430.                     after the last \ is used.   
  1431.  
  1432.         An invalid option will display the usage.
  1433.     
  1434.         / options can be combined or be specified separately before or
  1435.         after any of the filespecs.
  1436.         
  1437.                 /rn == /n/r == /r /n  
  1438.  
  1439.     ******************************************************************
  1440.     *                                                                *
  1441.     *   Note: Protected mode usage must use the command file C.CMD,  *
  1442.     *         using the executable in protected mode without the     *
  1443.     *         command file will look like it is changing to the      *
  1444.     *         directory but will not due to OS/2 restoring the       *
  1445.     *         environment when the program is finished running.      *
  1446.     *                                                                *
  1447.     *         In case someone tampers with this zip file and deletes *
  1448.     *         the c.cmd file from it, the cmd file should look       *
  1449.     *         as follows:                                            *
  1450.     *                                                                *
  1451.     *           @echo off                                            *
  1452.     *           if "%TMP%" == "" (md c:\tmp & set tmp=c:\tmp)        *
  1453.     *           vcd %1 %2 > %TMP%\vcdx.cmd                           * 
  1454.     *           if errorlevel 1 goto end                             * 
  1455.     *           call %TMP%\vcdx.cmd                                  * 
  1456.     *           :end                                                 * 
  1457.     *           del %TMP%\vcdx.cmd                                   *
  1458.     *                                                                *
  1459.     *                                                                * 
  1460.     ******************************************************************
  1461.  
  1462.         Operation
  1463.         _________
  1464.  
  1465.  
  1466.         VCD will rescan the specified or implied disk in the
  1467.         following instances:
  1468.  
  1469.                 - The VCD database does not exist or
  1470.                 - The /r (Rescan) option is specified or
  1471.                 - The current directory of the specified disk is not
  1472.                   in the VCD database.
  1473.  
  1474.         VCD will not save the database when used on drives A: or B:
  1475.         or if the /n (nosave) option is used.
  1476.  
  1477.         The database file is written to the root directory of the
  1478.         specified or implied drive using the name "VCD_data".  If the 
  1479.         drive is write protected (as some network drives are), VCD
  1480.         will attempt to save the database on drive C: using the name
  1481.         "VCD_x.dat" where x is the drive letter.
  1482.  
  1483.         VCD is designed to keep the database for each drive on the
  1484.         root directory of that drive.  Scanning never crosses drives. 
  1485.         I chose to do this to support removable hard drives, such as
  1486.         the Tandon Personal DataPacs.  If I were to scan all drives
  1487.         and keep the database on drive c: (as someone's DOS imitation
  1488.         does), it would not find a directory on a drive that has been 
  1489.         ejected and replaced by another.  Keeping the database on each 
  1490.         drive also allows for faster searches for the desired directory.
  1491.  
  1492.  
  1493.         If [path] is specified on the command line, VCD will do the 
  1494.         following:
  1495.  
  1496.                 - VCD scans the entire tree for a match to [path]. 
  1497.                 - If there is only one match, 
  1498.                   then VCD will change to that directory.
  1499.                 - If there are no matches, 
  1500.                   then VCD will remain in the current directory.
  1501.                 - If there are multiple matches, VCD will first check
  1502.                   for one exact match.  If there is one exact match,
  1503.                   VCD change to that directory.  Otherwise, VCD will 
  1504.                   popup a box containing the choices.  Move the 
  1505.                   highlight to the one you want to reach and press 
  1506.                   <enter> to select it, VCD will change to that
  1507.                   directory.
  1508.  
  1509.  
  1510.         Command line EXAMPLES: (Protected mode: Use C instead of VCD)
  1511.         
  1512.         To change to your INCLUDE directory on the current drive and
  1513.         rebuild the VCD data file:
  1514.  
  1515.                 VCD include /r           or   VCD /r include
  1516.  
  1517.         To change to the \bin directory on drive c:
  1518.  
  1519.                 VCD c:bin
  1520.  
  1521.  
  1522.         If the [path] option is not specified, VCD will start up in
  1523.         full screen mode.
  1524.  
  1525.         VCD will display a graphical tree display of the directory
  1526.         structure.
  1527.  
  1528.         Once the display is up, you can use the following keys to move
  1529.         around the display:
  1530.  
  1531.  
  1532.         <up>   or <left>  - moves highlight up or scrolls screen down
  1533.  
  1534.         <down> or <right> - moves highlight down or scrolls screen up
  1535.  
  1536.         <pgup>  - - - - - - moves the screen up one page
  1537.  
  1538.         <pgdn>  - - - - - - moves the screen down one page
  1539.  
  1540.         <home>  - - - - - - moves to the root directory "\"
  1541.         
  1542.         <end> - - - - - - - moves to the end of the display
  1543.  
  1544.         <enter> - - - - - - ends the program and goes to the
  1545.                                 highlighted directory.
  1546.  
  1547.         <ALPHA-NUMERIC> - - Speed searches for directory match.
  1548.  
  1549.         <esc> - - - - - - - ends the program without changing
  1550.                                 directories.
  1551.  
  1552.         <ctrl><enter> - - - Speed search for next directory match.  
  1553.  
  1554.         <F2>  - - - - - - - ReScan the current drive.
  1555.      
  1556.         <F3>  - - - - - - - Change to a different drive.
  1557.  
  1558.  
  1559.         _____________________________________________________________
  1560.                                                                      
  1561.  
  1562.                               END OF FILE
  1563.        
  1564.         _____________________________________________________________
  1565.  
  1566.