home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help18.lbr / CONCAT.HZP / CONCAT.HLP
Encoding:
Text File  |  1993-06-12  |  2.0 KB  |  46 lines
  1. ;
  2.                                  CONCAT.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                3k (22)   0C4B  0.3        Gene Pizzetta 9/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.  For ZCPR3 only.
  13. :1
  14.  
  15.   Syntax   CONCAT {dir:}outfile={dir:}infile{,{dir:}infile{, ...}} {/option}
  16.  
  17.    Any file without a DU or DIR specification is assumed to  be on the current 
  18. drive/user.   The default is text file mode, checking for  a CP/M  end-of-file 
  19. character (^Z).   The only option  at present  is 'O',  which  puts  CONCAT in 
  20. object file mode so ^Z's are ignored.
  21.  
  22.    CONCAT requires an output file and at  least one input file.   Actually, it 
  23. can be used as  a simple file-copy utility,  but that's not its purpose.   The 
  24. same filename may be given  repeatedly in the input file list.   An equal sign 
  25. separates  the output  file from  the  input files.   Commas separate multiple 
  26. input files.
  27.  
  28.    While the equal sign and commas  are required,  they  may be separated from 
  29. the filenames by one or more spaces.  For example,
  30.      concat newfile.txt=file1.txt,file2.txt,file3.txt,file4,txt
  31. works the same as
  32.      concat newfile.txt = file1.txt, file2.txt ,file3.txt , file4.txt
  33.  
  34.  
  35.    A filename cannot begin with  a slash unless it  is preceded by a DU or DIR 
  36. specification.
  37.  
  38.    If an error occurs, such as an input file not found,  the incomplete output 
  39. file is erased.  If another file has the same name as the output file, it will
  40. be renamed to filetype BAK.   CONCAT initially creates the output file  with a 
  41. filetype of $$$.   Any existing BAK is  erased,  the new BAK file created, and 
  42. the output file renamed to the correct filetype after the copy is successfully
  43. completed.
  44.  
  45.    An invalid option (anything other than "O") will be ignored.
  46.