home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help19.lbr / CONCAT.HZP / CONCAT.HLP
Encoding:
Text File  |  1993-06-12  |  2.6 KB  |  53 lines
  1. ;
  2.                                  CONCAT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (23)   90D5  0.4        Gene Pizzetta 11/89      Z3COM3
  6.  
  7.   1- Syntax                                                                   
  8.  
  9.  
  10.  
  11.    CONCAT concatenates  two or  more  source  files into  a  destination file, 
  12. similar to PIP.   Unlike PIP, however,  CONCAT allows both named directory and
  13. drive/user specifications,  which allows elaborate  concatenations  with input
  14. files pulled from various drives and user areas.   For ZCPR3 only.
  15. :1
  16.   Syntax   CONCAT {dir:}outfile={dir:}infile{,{dir:}infile{, ...}} {/option}
  17.  
  18.    Any file without a DU or DIR specification is assumed to  be on the current 
  19. drive/user.   The default is text file mode, checking for  a CP/M  end-of-file 
  20. character (^Z).   The only option  at present  is 'O',  which  puts  CONCAT in 
  21. object file mode so ^Z's are ignored.
  22.  
  23.    CONCAT requires an output file and at  least one input file.   Actually, it 
  24. can be used as  a simple file-copy utility,  but that's not its purpose.   The 
  25. same filename may be given  repeatedly in the input file list.   An equal sign 
  26. separates the output  file from  the input files.   Commas or spaces, or both,
  27. separate multiple input files.
  28.  
  29.    While the equal sign is required, it may be separated from the filenames by
  30. one or more spaces.  The same applies to commas, if they are used; i.e, 
  31.      concat newfile.txt=file1.txt,file2.txt,file3.txt,file4,txt
  32. works the same as
  33.      concat newfile.txt = file1.txt, file2.txt ,file3.txt , file4.txt
  34. which works the same as
  35.      concat newfile.txt = file1.txt file2.txt file3.txt, file4.txt
  36.  
  37.    A filename cannot begin with  a slash unless it  is preceded by a DU or DIR 
  38. specification; otherwise, CONCAT will think it has found an option list.
  39.  
  40.    If another file has the same name as the output file, it will be renamed to
  41. filetype BAK.   CONCAT initially creates the  output file  with  a filetype of 
  42. $$$.   Any existing BAK is  erased,  the new BAK file created,  and the output 
  43. file renamed to the correct filetype after the copy is successfully completed.
  44.  
  45.    If an error occurs, such as an input file not found,  the incomplete output 
  46. file is erased.
  47.  
  48.    An invalid option (anything other than "O") will be ignored.
  49.  
  50.    The quiet flag is  obeyed:  if they quiet flag is set,  only error messages
  51. are displayed.
  52.  
  53.    CONCAT is completely re-entrant for use with the GO command.