home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 224_01 / utilix.hlp < prev    next >
Text File  |  1987-01-07  |  4KB  |  98 lines
  1.                        UTILIX DOCUMENTATION - VERSION 2.0
  2.  
  3.     UTILIX is a collection of UNIX commands for the IBM PC and compatibles
  4.     running DOS 2.0 or higher.  The UTILIX commands are:
  5.     cat     concatenate and print files
  6.     cecho     echo arguments
  7.     chmod   change file attributes
  8.     cmp     compare two files
  9.     comm     select or reject lines common to two sorted files
  10.     ctime     time a command
  11.     expr    evaluate simple expression (long integer)
  12.     find     find files or directories
  13.     grep     search a file for a pattern (regular expressions)
  14.     head     print the first few lines of a file
  15.     help    display the online help files for the UTILIX commands
  16.     hoc     an interactive language for floating point arithmetic
  17.     ls     list contents of directory
  18.     od     octal, decimal, hex, ascii, or floating point dump
  19.     pr     print file in format suitable for a printer
  20.     rev     reverse lines of a file
  21.     rm     remove (unlink) files
  22.     sort     sort files
  23.     strings    search a file for character strings
  24.     tail     print the last few lines of a file
  25.     tee     output the input to several files
  26.     test     test condition of files or strings
  27.     tr     translate characters
  28.     uniq     report repeated lines in a file
  29.     wc     line, word and character count
  30.     
  31.     UTILIX  can be distributed freely if:
  32.     (1) the fee is only for the cost of the disk and shipping charges,
  33.     (2) the files are distributed as a complete set, and
  34.     (3) the distributed files are the original, unmodified version.
  35.     Users interested in obtaining any future updates of UTILIX can register 
  36.     by sending $10 and their mailing address to :
  37.     
  38.     Tom Woods
  39.     5813 Clearspring Rd.
  40.     Baltimore, MD  21212
  41.     
  42.     Any registered users who report an undiscovered bug in any of the UTILIX 
  43.     commands to the above address will receive a free update of UTILIX.  The 
  44.     source code for UTILIX is also available.  The source code is written for 
  45.     the CWARE DeSmet C compiler (Version 2.51).  To receive the source code, 
  46.     send $50 to Tom Woods at the above address.  The source code is not 
  47.     considered shareware and can not be distributed freely.
  48.  
  49. REFERENCES USED IN DEVELOPING UTILIX
  50.     Bourne, S.R., "The UNIX System". London: Addison-Wesley Publ. Co., 1983.
  51.     Kernighan, B.W. and Pike, B., "The UNIX Programming Environment". Englewood
  52.     Cliffs: Prentice-Hall, Inc., 1984.
  53.     Kernighan, B.W. and Plauger, P.J., "Software Tools". New York: Yourdon, 
  54.     Inc., 1976.
  55.     Kernighan, B.W. and Ritchie, D.M., "The C Programming Language", Englewood
  56.     Cliffs: Prentice-Hall, Inc., 1978.
  57.  
  58.  
  59.  
  60.                   EXPANSIONS OF THE COMMAND LINE PARAMETERS
  61.   
  62.     The UTILIX commands decode the command line for quoted strings 
  63.     (" and '), filenames with wildcards (* and ?), and parameter 
  64.     substitutions ($).
  65.     
  66.     The command line is decoded as follows:
  67.     
  68.     Parameter substitution is done for names preceded by the '$' character.
  69.     The parameters are any environment string such as PATH.  Parameter 
  70.     substitution can be embedded in a string by enclosing the name in 
  71.     parenthesis ({ }).  The '$' character can be quoted by the '\' character
  72.     to pass the '$' character without parameter substitution.  If the parameter
  73.     can not be found in the environment strings, a zero length string is 
  74.     returned.  Examples with the UTILIX command cecho:
  75.     
  76.     cecho $PATH            Echo the PATH string
  77.     cecho ${PATH}here        Concatenate the PATH string to "here"
  78.     cecho \$20.5            Quote the '$' for no substitutions
  79.     
  80.     The MS DOS wildcards, * and ?, can be used in names on the command line
  81.     which will expand the name into a list of files.  Examples:
  82.     
  83.     cecho *.exe            Echo all *.exe files
  84.     cecho \dos\c??            Echo c?? files in the \dos directory
  85.     cecho \*.bat            Echo *.bat files in the root directory
  86.     
  87.     Strings can also be quoted on the command line.  The single quote (') will
  88.     eliminate any parameter substitution.  The double quote (") will still 
  89.     allow parameter substitution and is useful to group several words into a 
  90.     single string.  The quotes can also be quoted with the '\' character.  
  91.     Examples:
  92.     
  93.     cecho "The path is $PATH"    Echo and substitute the PATH
  94.     cecho '$PATH'            Echo without substituting PATH
  95.     cecho '*.exe'            Echo without filename expansion
  96.     cecho "This is a sentence."    Echo a group of words as single string
  97.     cecho "enclosed by \" "         Echo with a double quote output
  98.