home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / dos_util / qutils30.zip / QUTILS30.DOC < prev    next >
Text File  |  1993-09-19  |  14KB  |  320 lines
  1. Quick Utils 3.0
  2. (C) Copyright 1993 by Henning Vahlenkamp
  3.  
  4.  
  5. 1) Disclaimer:
  6. While every effort has been made to make this package bug-free, the author
  7. (me) assumes no responsibility for any incidental or consequential damage
  8. resulting from the use/misuse of this package in whole or in part.  There are
  9. also no implied or expressed warranties regarding this package in whole or in
  10. part.
  11.  
  12.  
  13. 2) Status:
  14. Quick Utils 3.0 is shareware.  If you find it useful in whole or in part,
  15. please send $10 US by check or money order (Cash is risky.) to the following
  16. address:
  17.  
  18.          Henning Vahlenkamp
  19.          216 Spring Hill Road
  20.          Matawan, NJ 07747
  21.  
  22. If you send a 3.5" disk along with the registration fee, you'll receive the
  23. next version of Quick Utils at no extra cost and future notification
  24. concerning any additional upgrades.  The next version (probably called Quick
  25. Utils 3.1) will include a password security program among other improvements.
  26.  
  27. This package may be freely redistributed provided that it is neither sold nor
  28. modified in any way.
  29.  
  30.  
  31. 3) What is it?:
  32. Quick Utils is a group of 12 small, tightly written and optimized utilities
  33. that perform various useful functions (see below).  They work with any PC.  I
  34. couldn't find any programs that quickly and easily perform these tasks to my
  35. liking, so I decided to write my own.
  36.  
  37. Eight new commands have been added since version 2.0 - CAT, DTSET, FINDER,
  38. INFO, MOVE, RENDIR, SPIN, and SPLIT.  CONTEXT, CRYPT, EVAL, and TEXTAN have
  39. all been improved too.  Plus, a bug in the square root function of EVAL
  40. (unnecessary variable decrement resulting in unpredictable results) has
  41. been corrected.  The function of the tiny BIOSDATE command has been
  42. incorporated into INFO.
  43.  
  44.  
  45. 4) Documentation:
  46. With the exception of INFO, typing any of the commands without parameters, as
  47. well as with incorrect parameters, will display a copyright message/usage
  48. guide for that command.  The parameters shown in the guide contain symbols
  49. whose meanings are as follows:
  50.  
  51.   <parameter>             a required parameter
  52.   [parameter]             an optional parameter
  53.   parameter1|parameter2   use only one of the two parameters
  54.   parameter1+parameter2   use one or both of the parameters
  55.  
  56. In this section, each command's message/usage guide is shown followed by a
  57. more detailed discussion of that command.
  58.  
  59. A)********************************************************************
  60. »Cat 3.0« ∞ the file displayer
  61. (c) Copyright 1993 by Henning Vahlenkamp
  62.  
  63. Usage: CAT <switch> [path]<filename>
  64.  switches: /p {printable chars     ■ASCII#10,13,32->255}
  65.          : /s {standard printables ■ASCII#10,13,32->127}
  66.          : /h {hexadecimal}
  67.  
  68. CAT works like TYPE, but allows filtering of the file to be displayed.  For
  69. example, you can filter out unprintable (control) characters and the
  70. nonstandard IBM graphics characters.  CAT is especially useful for displaying
  71. all the text in binary files.  Plus, CAT can display files in hexadecimal
  72. format.  Each line of the hex dump begins with the offset of the first of the
  73. 16 bytes on the line, followed by the bytes (two hex digits each), followed by
  74. an ASCII representation of the bytes; unprintable characters are replaced by
  75. periods.
  76.  
  77. B)********************************************************************
  78. »ConText 3.0« ∞ the textfile converter
  79. (c) Copyright 1993 by Henning Vahlenkamp
  80.  
  81. Usage: CONTEXT <switch> [path]<sourcefile> [path]<targetfile>
  82.  switches: /up {UNIX|Amiga->PC}       | /pm {PC->Mac}
  83.          : /um {UNIX|Amiga->Mac}      | /mu {Mac->UNIX|Amiga}
  84.          : /pu {PC->UNIX|Amiga}       | /mp {Mac->PC}
  85.          : /ul {uppercase->lowercase} | /lu {lowercase->uppercase}
  86.          : /s  {strip ASCII #s>127}   | /c  {strip all control chars}
  87.          : /e  {strip all line endings}
  88.  note    : source & target must be different files or paths
  89.  
  90. CONTEXT is a conversion program which converts text files among UNIX/
  91. Amiga, PC, and Macintosh platforms in any direction.  This is necessary
  92. since each platform uses different end-of-line markers.
  93.  
  94. platform       marker(s)
  95. ----------     ---------
  96. UNIX/Amiga     lf
  97. PC             cr,lf
  98. Macintosh      cr
  99.  
  100. (lf=line feed, ASCII#10; cr=carriage return, ASCII#13)
  101.  
  102. In addition, CONTEXT can convert all the letters in a file between upper and
  103. lower case, remove nonstandard ASCII characters (128..255), remove all control
  104. characters (except for line endings), and remove all the line endings. Giving
  105. it anything other than an ASCII text file will produce meaningless results.
  106.  
  107. C)********************************************************************
  108. »Crypt 3.0« ∞ the file en/decrypter
  109. (c) Copyright 1993 by Henning Vahlenkamp
  110.  
  111. Usage: CRYPT <switch> <password> [path]<sourcefile> [path]<targetfile>
  112.  switches: /e {encrypt} | /d {decrypt}
  113.  password: any # of characters, no spaces
  114.  note    : source & target must be different files or paths
  115.  
  116. CRYPT protects files from prying eyes by scrambling their contents
  117. according to a password you supply.  It also decrypts encrypted files if
  118. you supply the same password you used to encrypt.  Don't forget your
  119. password, since files can't be restored otherwise.  In addition to
  120. documents, CRYPT is useful for executables, as encrypted files can't be run
  121. successfully.  CRYPT attaches a tiny message to the beginning of encrypted
  122. files so you can easily recognize them.  Just type a file you're uncertain
  123. about and look for "Crypt3.0!"  This version uses a different (much better)
  124. en/decryption algorithm than Crypt2.0, so files encrypted with 2.0 can't be
  125. decrypted with 3.0 and vice versa.  I'll keep the same algorithm in future
  126. versions to prevent any further incompatibilities.
  127.  
  128. D)********************************************************************
  129. »DTSet 3.0« ∞ the file date/time modifier
  130. (c) Copyright 1993 by Henning Vahlenkamp
  131.  
  132. Usage: DTSET [path]<filename> <[date]+[time]>
  133.  date: MM-DD-YY {MM 1..12, DD 1..31, YY 80..99
  134.  time: HH:NN    {HH 0..23, NN 0..59}
  135.  
  136. Inspired by the AmigaDOS SetDate command, DTSET permits you to change the
  137. date and/or time of one or more files.  Using it is very simple; just follow
  138. the above template (MM=month,DD=day,YY=year,HH=hour,NN=minute).  Remember to
  139. specify the time with the 24-hour clock (e.g. 3:00PM is 15:00).  Error
  140. checking is limited, so if you enter numbers outside the acceptable ranges,
  141. the resulting dates and/or times will be unpredictable.
  142.  
  143. E)********************************************************************
  144. »Eval 3.0« ∞ the command line calculator
  145. (C) 1993 by Henning Vahlenkamp
  146.  
  147. Usage: EVAL <expression|?>
  148.  supported symbols: + - * / ^ ( ) r
  149.  note             : r returns square root, i.e. r(4) is 2
  150.                   : ^ returns powers, i.e. 3^2 is 9
  151.                   : ? activates interactive mode
  152.  
  153. EVAL performs quick calculations when you don't have a calculator handy.
  154. Simply give it an expression consisting of any combination of additions,
  155. subtractions, multiplications and divisions.  It also supports square
  156. roots, exponentiation to integer powers, and parentheses nesting
  157. subexpressions.  Standard arithmetic conventions apply, meaning operators
  158. separated by operands, multiplication takes precedence over addition, etc.
  159. For example,
  160.             (3+(4-5)*6/7+r(4)+3.8^2)
  161. yields an answer of 18.58285714300
  162. If you type a ? instead of an expression, EVAL starts in interactive mode,
  163. so you can do many calculations without rerunning the program each time.
  164. Pressing Enter by itself at the expression prompt quits EVAL.  By the way,
  165. EVAL is accurate to 11 decimal places regardless of whether you have a math
  166. coprocessor.
  167.  
  168. F)********************************************************************
  169. »Finder 3.0« ∞ the file finder
  170. (c) Copyright 1993 by Henning Vahlenkamp
  171.  
  172. Usage: FINDER [switch] [path]<filename>
  173.  switch: /n {no searching lower directories}
  174.  note  : searching starts downward from path (or current dir)
  175.  
  176. FINDER is a file finding utility.  Give it a file specification, and it will
  177. search the specified (or current) directory plus all lower subdirectories for
  178. all matches.  You can also choose to search the one directory only.
  179. Matches are displayed in a format similar to that of DIR, except FINDER also
  180. shows all attributes (even hidden files) and each file's path.
  181.  
  182. attributes:                            rhsvda
  183.  r=read only   ─┐                      ──┬───
  184.  h=hidden       │                        │
  185.  s=system file  │     letter in one of these positions means bit is set
  186.  v=volume label │     dash   "   "  "    "       "       "    "  "  clear
  187.  d=directory    │
  188.  a=archive     ─┘
  189.  
  190. G)********************************************************************
  191. »Info 3.0« ∞ the information displayer
  192. (c) Copyright 1993 Henning Vahlenkamp
  193.  
  194. Usage: INFO [drive]
  195.  drive: A: .. Z:
  196.  
  197. INFO without any parameters reports some general information about your
  198. system.  For example:
  199.  
  200. DOS version        : 3.31
  201. ROM BIOS date      : 12/01/88
  202. ctrl-break flag    : FALSE (off)
  203. verify flag        : FALSE (off)
  204. free memory        : 288960 bytes
  205.  largest block     : 288960 bytes
  206. date               : Tuesday  June 8, 1993
  207. time               : 3:0:0.0pm
  208. environment strings:
  209. --------------------
  210. COMSPEC=C:\DOS\COMMAND.COM
  211. PATH=C:\;C:\DOS;C:\NORTON;C:\PROWRITE;C:\TURBO
  212. PROMPT=TIME = $T$H$H$H$H$H$H$_DATE = $D$_$P$G$
  213.  
  214. Giving INFO a drive letter makes it print a lot of disk-related information.
  215. For example, INFO C: would print:
  216.  
  217. Information for drive->c: unit->2 type->fixed disk
  218. ---------------------------------------------------
  219. total bytes         : 42844160         bytes per sector     : 512
  220. bytes used          : 22683648 (53%)   bytes per cluster    : 2048
  221. bytes free          : 20160512 (47%)   sectors per cluster  : 4
  222. sectors             : 83680            sectors per FAT      : 82
  223. clusters            : 20920            sectors per track    : 40
  224. cylinders(tracks)   : 523              reserved sectors     : 1
  225. FATs                : 2                hidden sectors       : 40
  226. max root dir entries: 512              media descriptor byte: 248
  227. disk sides          : 4                disk id              : IBM  3.3
  228.  
  229. sector: 0 boot record
  230.         1-164 FAT
  231.         165-196 root dir
  232.         197-83639 data
  233.  
  234. You can view the message/usage guide by giving INFO a question mark as a
  235. parameter.  Explanations of all the things reported by INFO are beyond the
  236. scope of this documentation.
  237.  
  238. H)********************************************************************
  239. »Move 3.0« ∞ the file mover
  240. (c) Copyright 1993 by Henning Vahlenkamp
  241.  
  242. Usage: uses COPY command syntax
  243.  
  244. MOVE simply copies files from a source to a destination and deletes the
  245. source.  It's the equivalent of using a DEL after a COPY - only more
  246. convenient.  MOVE works just like COPY.
  247.  
  248. I)********************************************************************
  249. »RenDir 3.0« ∞ the directory renamer
  250. (c) Copyright 1993 Henning Vahlenkamp
  251.  
  252. Usage: RENDIR [path]<oldname> <newname>
  253.  
  254. RENDIR performs another simple function - renaming subdirectories.  It works
  255. just like REN, accepting subdirectories as well as files.
  256.  
  257. J)********************************************************************
  258. »Spin 3.0« ∞ the disk spinner
  259. (c) Copyright 1993 by Henning Vahlenkamp
  260.  
  261. Usage: SPIN <drive> <time>
  262.  drive: A: .. Z:
  263.  time : /3 {30 sec.} | /6 {60 sec.}
  264.  note : spin times are approximate
  265.  
  266. SPIN makes it easy to clean the read/write heads of a floppy drive by spinning
  267. a (user-supplied) cleaning disk in the drive.  You can choose either a short
  268. spin (30 sec.) or a long one (60 sec.).  SPIN automatically detects invalid
  269. drives and fixed disks, aborting in both cases.
  270.  
  271. K)********************************************************************
  272. »Split 3.0« ∞ the file splitter
  273. (c) Copyright 1993 by Henning Vahlenkamp
  274.  
  275. Usage: SPLIT <# parts> [path]<sourcefile> [[path]targetfile]
  276.  # parts: 2..255
  277.  note   : source extension cannot be in 1..255
  278.         :  resulting file extension is part #
  279.         : rejoin files w. COPY /B ...
  280.  
  281. I wrote SPLIT in order to transfer files too large to fit on a single floppy
  282. disk from one computer to another.  You may find it equally useful.  This
  283. utility cuts up any file into a user-specified number of parts.  The resulting
  284. files' extensions are the numbers of the parts.  There's no need for an
  285. UNSPLIT command since parts can be rejoined with COPY.  Just remember to
  286. rejoin them in the correct order (xxxxxxxx.1 followed by xxxxxxxx.2 etc.).
  287.  
  288. L)********************************************************************
  289. »TextAn 3.0« ∞ the textfile analyzer
  290. (c) Copyright 1993 by Henning Vahlenkamp
  291.  
  292. Usage: TEXTAN [path]<filename>
  293.  
  294. TEXTAN analyzes text files, calculating a lot of statistics about them.
  295. Here's a sample analysis of this file (QUTILS30.DOC):
  296.  
  297. Analyzing...done
  298. ------------------------------------------------------------
  299. file size          :14337      paragraphs             :322
  300.  nonprintable chars:645        lines                  :322
  301.  printable chars   :13692      pages (66 lines each)  :5
  302.   alphanumerics    :9244       avg word length        :4.57
  303.     letters        :8832       avg words/sentence     :14.25
  304.     digits         :412        avg words/paragraph    :6.28
  305.   symbols          :4448       avg words/page         :404.60
  306. words              :2023       avg sentences/paragraph:0.44
  307. sentences          :142        avg sentences/page     :28.40
  308.  exclamatory(!)    :2          avg paragraphs/page    :64.40
  309.  interrogative(?)  :5
  310.  declarative(.)    :135
  311.  
  312. Giving it anything other than an ASCII text file will produce meaningless
  313. results.
  314.  
  315.  
  316. Note: CAT, CONTEXT, CRYPT, SPLIT, and TEXTAN can process files of any size,
  317. since they all have reusable input/output buffers.  DTSET, FINDER, and MOVE
  318. are the only commands supporting DOS wild cards.
  319.  
  320. That's all for now.  I hope you find Quick Utils as useful as I do.