home *** CD-ROM | disk | FTP | other *** search
/ Big Blue Disk 51 / bbd51.zip / CATT.TXT < prev    next >
Text File  |  1990-11-14  |  4KB  |  101 lines
  1. |A╔═══════╦══════════════════════════════════════════════════════════════╦═══════╗
  2. |A║ ^0Tools |A║                             ^1CATT |A                            ║^0 Tools|A ║ 
  3. |A╚═══════╩══════════════════════════════════════════════════════════════╩═══════╝
  4. ^Cby
  5. ^CGeorge Leritte
  6.  
  7.    CATT is a handy utility that combines the function of TYPE with the file 
  8.  handling capabilities of the COPY command.  It will read a file (or files in 
  9.  sequence) and display it (them) on the standard output (i.e., the screen).  
  10.  CATT's output may be redirected using DOS's redirection and piping commands. 
  11.  
  12.  ^1 Editors note:  CATT is a DOS command line utility.  When running most
  13.       ^1 utilities from within the Big Blue Disk menu, only a HELP screen
  14.       ^1 explaining the command is displayed.  Use the command outside BBD as 
  15.       ^1 you would standard DOS commands with one exception:  the catt.exe
  16.       ^1 file must be in your current "PATH" at the time of execution.
  17.  
  18.  
  19.    Command syntax:
  20.   
  21.                   CATT [options] file1 file2 ...
  22.  
  23.                                 where file1 file2 ... are filenames.
  24.  
  25.   Options:
  26.  
  27.        -h   provides a brief description of the options.
  28.  
  29.        -s   makes CATT silent about the file name it's displaying and any non-
  30.             existent files it is asked to display.
  31.  
  32.        -v   makes Visible normal non-printing characters (those with ascii 
  33.             values under 32 that are normally printer control characters).
  34.  
  35.        -t   prints tabs as ^^I when specified with the -v option.
  36.  
  37.        -e   prints '$' at the end of each line when specified the -v option.
  38.  
  39.        -p   prints a page break at the end of each file.
  40.  
  41.     Specify multiple options as "-s -v -t -e" or "-svte".  ("-s-v-t-e" will be 
  42.  interpreted as "-s" ONLY.) 
  43.  
  44.     File1, file2, etc., are filenames or filename specifiers separated by 
  45.  spaces.  You can use wildcards like "*.txt" or "*.doc" or pathnames like 
  46.  "\wordproc\business\*.doc".  Multiple names may be specified at one time like 
  47.  this: "*.txt *.doc manage.lst". 
  48.  
  49.  
  50.  ^1EXAMPLES^0
  51.  
  52.  At the DOS prompt A> type:
  53.  
  54.     ^1catt *.txt >prn^0       ...print all files with .txt extension
  55.                                         on the disk in drive A:
  56.  
  57.     ^1catt *.txt^0            ...display all files with .txt extension
  58.                                         on the disk in drive A:
  59.  
  60.     ^1catt -s *.txt^0         ...display all files with .txt extension
  61.                                         on the disk in drive A: but OMIT
  62.                                         the "filename" identifier from the
  63.                                         output
  64.  
  65.     ^1catt *.txt >c:\junk\text^0    ...copy all files with .txt 
  66.                                            extension on the disk in drive A:
  67.                                            to a single NEW file named "text" 
  68.                                            in an existing subdirectory "junk"
  69.                                            on the C: drive
  70.  
  71.     ^1catt *.txt >>c:\junk\text^0    ...copy (append) all files with .txt 
  72.                                            extension on the disk in drive A:
  73.                                            to the end of an existing file 
  74.                                            named "text" in an existing 
  75.                                            subdirectory "junk" on the C: drive 
  76.  
  77.  
  78.  ^1PAUSING        
  79.  
  80.     While the files are being displayed, press the <SPACE> bar to pause the 
  81.  display.   Be warned:  the <SPACE> bar will pause printing or disk writing
  82.  if the CATT output is "redirected" using ">" or ">>."   If your system appears 
  83.  to be locked up, it may be the <SPACE> bar was pressed accidentally; press the 
  84.  <SPACE> bar again.  (You should be able to tell if this occurs:  if you are 
  85.  redirecting to the printer, your printer would have stopped after emptying its 
  86.  buffer; if you are redirecting to a file, your disk drive would have stopped.) 
  87.  
  88.  
  89.  ^1CANCELLING
  90.  
  91.      To cancel the remainder of the command after it has begun processing,
  92.  press the <CTRL> key and the <BREAK> key simultaneously, often directed
  93.  as <CTRL><BREAK> or CTL-Break.
  94.  
  95.  
  96.  ^1OUTSIDE BBD
  97.      To run this program outside the ^1Big Blue Disk^0 menu, type: ^1CATT^0.
  98.  
  99.  DISK FILES THIS PROGRAM USES:
  100. ^FCATT.EXE
  101.