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