home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / ZSUS002.LBR / CONCAT07.LBR / CONCAT07.DZC / CONCAT07.DOC
Text File  |  1989-12-25  |  6KB  |  143 lines
  1.  
  2.                              CONCAT
  3.                            Version 0.7
  4.  
  5.                           Gene Pizzetta
  6.                         December 17, 1989
  7.  
  8.  
  9. CONCAT concatenates two or more source files into a destination 
  10. file, similar to PIP.  Unlike PIP, however, CONCAT accepts both 
  11. named directory (DIR) and drive/user (DU) specifications, which 
  12. allows elaborate concatenations with input files pulled from 
  13. various drives and user areas.  CONCAT runs under ZCPR3 only.
  14.  
  15. USAGE:
  16.  
  17.      CONCAT {dir:}outfile = {dir:}infile {{dir:}infile {...}} {/options}
  18.  
  19. Any file without a DU or DIR specification is assumed to be on 
  20. the current drive/user.
  21.  
  22. OPTIONS:
  23.  
  24.      A    Append mode.  Appends sources files to end of target
  25.           file, which must exist.  This mode by-passes some of
  26.           CONCAT's safety features (see below).
  27.  
  28.      O    Object file mode (CONCAT ignores ^Z characters).  The
  29.           default is text file mode, checking for ^Z (the CP/M
  30.           end-of-file character).  Object file mode is provided
  31.           because some hard-disk backup programs can split large
  32.           files across two or more floppy disks.
  33.  
  34.      Q    Toggle quiet mode.  Normally CONCAT prints the names of
  35.           the output file on the screen, and then the name of
  36.           each source file as it is read.  If a configuration
  37.           byte at 111h is set to a non-zero value, CONCAT will
  38.           default to quiet operation, printing only error
  39.           messages.  The Q option toggles operation to the non-
  40.           default mode.  Regardless of the state of the
  41.           configuration byte, CONCAT defaults to quiet mode if
  42.           the ZCPR3 quiet flag is set.  In that case the Q
  43.           option will likewise toggle to the non-default
  44.           (verbose) mode.
  45.  
  46. CONCAT requires an output file and at least one source (input) 
  47. file.  Actually, it can be used as a simple file-copy utility, 
  48. but that's not its purpose.  The same filename may be given 
  49. repeatedly in the source file list.  An equal sign (=) separates 
  50. the output filename from the source filenames.  Commas or spaces, 
  51. or both, separate multiple source filenames.
  52.  
  53. While the equal sign is required, it may be separated from the 
  54. filenames by one or more spaces.  The same applies to commas, if 
  55. they are used.  For example,
  56.      concat newfile.txt=file1.txt,file2.txt,file3.txt,file4,txt
  57. works the same as
  58.      concat newfile.txt=file1.txt file2.txt file3.txt file4.txt
  59. which works the same as
  60.      concat newfile.txt = file1.txt, file2.txt ,file3.txt , file4.txt
  61. which works the same as
  62.      concat newfile.txt = file1.txt file2.txt file3.txt, file4.txt
  63.  
  64. A filename cannot begin with a slash unless it is preceded by a 
  65. DU or DIR specification; otherwise, CONCAT will think it has 
  66. found an option list.
  67.  
  68. If another file has the same name as the output file, it will be 
  69. renamed to filetype BAK.  CONCAT initially creates the output 
  70. file with a filetype of $$$.  After the copy is successfully 
  71. completed, any existing BAK is erased, the new BAK file is 
  72. created, and the output file is renamed to the correct filetype.
  73.  
  74. CONCAT is re-entrant for use with the GO command, although that 
  75. type of operation has not been extensively tested.
  76.  
  77. APPEND MODE:  In append mode (option A) CONCAT by-passes several 
  78. safety features, so use it with caution.  For instance, no 
  79. temporary file or BAK file is created.  The target (output) file 
  80. must already exist, but it can be zero-length.  On error, the 
  81. output file is closed after appending any text that was read 
  82. before the error occurred.  The output file is not erased.
  83.  
  84. It's a good idea to make sure you have sufficient disk space 
  85. before using append because your original source file will be 
  86. irrevocably changed if CONCAT runs out of space before it is 
  87. finished.
  88.  
  89. Do not attempt to append a file to itself.  You're not likely to 
  90. be happy with the results.  Use concatenation mode instead.
  91.  
  92. If you would like to be able to append without using the A 
  93. option, set up an alias as follows:
  94.      APPEND    CONCAT $* /A
  95.  
  96. ERROR CODES:  If an error occurs, such as a source file not 
  97. found, the incomplete output file is erased and the ZCPR3 program 
  98. error flag is set.  The error flag values are set as follows:
  99.       8 = ambiguous or missing filename (output or source)
  100.      10 = source or target file not found or not given
  101.      11 = disk or directory full (write error)
  102.       4 = all other errors
  103.  
  104. An invalid option does not produce an error; it is simply ignored.
  105.  
  106. HISTORY:
  107.  
  108. Version 0.7 -- December 17, 1989 -- Gene Pizzetta
  109.      Added A (append) option, which by-passes several of CONCAT's
  110.      safety features.  Also, a few more optimizations.
  111.  
  112. Version 0.6 -- December 3, 1989 -- Gene Pizzetta
  113.      Minor changes in setting error flag.  Corrected serious
  114.      error in detecting top of memory, found by Howard Goldstein,
  115.      who also suggested several changes to make the code more
  116.      efficient.  Thanks, Howard.
  117.  
  118. Version 0.5 -- November 25, 1989 -- Gene Pizzetta
  119.      Added Q (quiet) option and error flag support.  Fixed parser
  120.      bug that allowed a null output filename.  Now closes output
  121.      file on error before erasing it, a bug discovered by Howard
  122.      Goldstein.
  123.  
  124. Version 0.4 -- November 12, 1989 -- Gene Pizzetta
  125.      Added large output buffer.  Corrected error in parsing
  126.      filespec in current user.  Relaxed command line syntax:
  127.      commas no longer required.  Now obeys quiet flag.
  128.  
  129. Version 0.3 -- September 19, 1989 -- Gene Pizzetta
  130.      First preliminary release.
  131.  
  132. If you have any suggestions for enhancements, I'm anxious to hear 
  133. them.  Most importantly, please report any bugs or other problems.
  134.  
  135. To report bugs or make suggestions:
  136.                          Gene Pizzetta
  137.                          481 Revere Street
  138.                          Revere, MA 02151
  139.  
  140.                          Newton Centre Z-Node:  (617) 965-7259
  141.                          Lilliput Z-Node:  (312) 649-1730
  142.                          Voice:  (617) 284-0891
  143.