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