home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / sysutl / b6pack.arc / 6PACK.DOC next >
Text File  |  1986-01-21  |  7KB  |  188 lines
  1.  
  2.             The Boston Six-Pack
  3.  
  4.     The Boston Six-Pack is a collection of small programs that 
  5. are offered under the "Shareware" concept. Each program performs a 
  6. simple task, like reporting the size of a group of files, or changing
  7. their attributes. Several of the programs are modeled after utilities
  8. of the Unix operating system. I have tried to keep the interfaces clean 
  9. and consistent. As far as I know the programs are bug free.
  10.  
  11.     If you find one or more of these programs useful, I'm asking 
  12. that you send me the price of a six-pack ( $5.00 ). Send your check for 
  13. five dollars to:
  14.  
  15.         Specialized Software
  16.         P.O. Box 508
  17.         Jamaica Plain, MA 02130
  18.  
  19.     You may, of course, copy and share these programs, provided
  20. only that you include this documentation with each copy that you
  21. distribute.
  22.  
  23.                 Dave Burns
  24.  
  25.  
  26. WORDS
  27.  
  28. Purpose : Reports in alphabetic order all words found in a file, 
  29.           with the number of times the word was encountered.
  30.  
  31. Format  : WORDS [/S][d:][path]filename
  32.  
  33. Remarks : The default action of WORDS is to ignore case; all 
  34.           words are converted to lower case for comparison. If 
  35.           the parameter /S is included on the command line, WORDS 
  36.           will be case sensitive. Two words that differ only in 
  37.           capitalization will be considered ( and counted ) 
  38.           separately.
  39.  
  40.     -----------------------------------------------------
  41.  
  42.  
  43. WC
  44.  
  45. Purpose : Count bytes, words, and lines in a text file.
  46.  
  47. Format  : WC [d:[path]]filename ...
  48.  
  49. Remarks : If you invoke WC with wildcards in the filename or 
  50.           names, the bytes, words, and lines in all files that 
  51.           match the specification will be summed and reported 
  52.           both individually and in the aggregate.
  53.  
  54.           If you put more than one filespec on the command line, 
  55.           WC will report subtotals for each filespec as well as 
  56.           the totals for all files specified.
  57.  
  58. SIZE
  59.  
  60. Purpose : Reports the byte size and actual disk space usage of a 
  61.           file or files.
  62.  
  63. Format  : SIZE [d:[path]]filespec [[d:[path]]filespec...]
  64.  
  65. Remarks : The amount of space it takes to store a file is 
  66.           determined by three factors : the number of bytes in 
  67.           the file, the size of a DOS sector ( which is always 
  68.           512 bytes ), and the number of sectors in a DOS 
  69.           allocation cluster for the drive and medium in use. 
  70.           Every file, no matter how small, uses up at least one 
  71.           allocation cluster. A double-sided floppy disk, for 
  72.           example, has a cluster size of two sectors or 1024 
  73.           bytes. The IBM PC-XT under DOS 2.0 or 2.1 uses a 
  74.           cluster size of 8 sectors ( 4096 bytes ).
  75.  
  76.           When you list a directory, DOS reports the size of each 
  77.           file. This size, however, represents only the number of 
  78.           bytes actually in the file. The actual disk space used 
  79.           to store the file may be much more.
  80.  
  81.           SIZE reports the actual disk space used by a file or 
  82.           files, as well as the byte size of the file(s). It may 
  83.           be invoked with an ambiguous filespec ( wildcards ) 
  84.           and/or with a list of filespecs. SIZE will then report 
  85.           sums and subtotals for the filespec(s) specified.
  86.  
  87. Example : SIZE ACCT.DOC
  88.           SIZE \USR\SRC\*.C \USR\SRC\*.H
  89.  
  90. FATTR
  91.  
  92. Purpose : Allows you to change the attribute of any file.
  93.           You can mark any file as hidden, system, or read-only; 
  94.           or you may remove a file's hidden, system, or read-only 
  95.           attributes.
  96.  
  97. Format  : FATTR [+|-switches] [[d:[path]]filename ...]
  98.  
  99. Remarks : FATTR changes the current attribute of a file or files 
  100.           by adding or subtracting the attributes you specify. If 
  101.           you specify no attributes to change, FATTR displays the 
  102.           current attributes of the file or files you specify.
  103.  
  104.           Files may be specified with or without drive and path 
  105.           specifiers. More than one file specification may be 
  106.           placed on the command line.
  107.  
  108.           Attributes are specified by typing '+' to add a new 
  109.           attribute or '-' to remove an existing one, and a 
  110.           letter or letters to specify the attribute. 
  111.  
  112.           These are the attributes you may specify :
  113.  
  114.            R - Read-only
  115.            H - Hidden file. File will not show up in a directory.
  116.            S - System file. File will not show up in a directory.
  117.            A - Archive bit. If this is set on, the DOS command 
  118.                BACKUP will consider the file to have been updated 
  119.                since the last backup.
  120.  
  121.           Attributes may be combined by specifying more than one 
  122.           after the plus or minus sign. For example, to make the 
  123.           file LAWYERS.DAT both read-only and hidden, use the 
  124.           command
  125.  
  126.                     FATTR +RH LAWYERS.DAT
  127.  
  128.           To "unhide" the above file, but leave it read-only, 
  129.           type
  130.  
  131.                     FATTR -H LAWYERS.DAT
  132.  
  133.           The attribute(s) you want to add or remove must be the 
  134.           first parameter on the command line. You cannot add and 
  135.           remove attributes with the same command.
  136.  
  137.           Attempting to add an attribute that a file already has 
  138.           or remove one that it does not have will result in no 
  139.           effect.
  140.  
  141.           If you invoke FATTR with no parameters, it will display 
  142.           the list of attributes you may change.
  143.  
  144. SPACE
  145.  
  146. Purpose : Reports free space on a drive or drives. SPACE is 
  147.           faster and more convenient than doing a directory or 
  148.           CHKDSK.
  149.  
  150. Format  : SPACE [d [d...]]
  151.  
  152. Remarks : If SPACE is invoked with no parameters, it reports free 
  153.           space on the current default drive. Drives may be 
  154.           specified with a single letter, or with a letter and 
  155.           colon.
  156.  
  157. Example : SPACE 
  158.           SPACE A C D
  159.           SPACE B: C:
  160.  
  161.     -----------------------------------------------------
  162.  
  163. WHEN
  164.  
  165. Purpose : Reports the current system date and time. 
  166.  
  167. Format  : WHEN
  168.  
  169. Remarks : The output of WHEN may be redirected into a file. This 
  170.           may be useful in timing events or benchmarking 
  171.           applications.
  172.  
  173.     -----------------------------------------------------
  174.  
  175. TOUCH
  176.  
  177. Purpose : Update a file's date/time stamps to reflect the current 
  178.           system date and time. No other changes are made to the 
  179.           file or its directory entry.
  180.  
  181. Format  : TOUCH [d:[path]]filename [[d:[path]filename]...]
  182.  
  183. Remarks : If a program has several modules, or a manuscript has 
  184.           several parts, TOUCH may be used to give all the parts 
  185.           the same date and time. This makes it easier to 
  186.           identify the parts if necessary ( for example, for 
  187.           version control ).
  188.