home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d7xx / d747 / aush.lha / AUSH / ExtraCmds.lha / englishdocs / paste.doc < prev    next >
Text File  |  1992-09-04  |  2KB  |  58 lines
  1. NAME
  2.     paste - merge same lines of several files or subsequent lines of
  3.         one file
  4.  
  5. SYNOPSIS
  6.     paste [ -dlist ] file...
  7.     paste -s [ -dlist ] file...
  8.  
  9. DESCRIPTION
  10.     In the first form, paste concatenates corresponding lines of the
  11.     given input files. It treats each file as a column or columns of a
  12.     table and pastes them together horizontally (parallel merging).
  13.     In the second form above, paste the function of an older command
  14.     with the same name by combining subsequent lines of the input files
  15.     (serial merging).
  16.     In all cases, lines are glued together with a tab, or with characters
  17.     from an optionally specified list.  Output is send to the standard
  18.     output.
  19.  
  20.     The meanings of the options are:
  21.  
  22.     -d    Without this option, the new-line characters of each but the
  23.         last file (or last line in case of the -s option) are replaced
  24.         by a tab character.  This option allows replacing the tab
  25.         character by one or more alternate characters (see below).
  26.  
  27.     list    One or more characters immediately following -d replace the
  28.         default tab as the line concatenation character.  The list
  29.         is used circularly, i.e., when exhausted, it is reused.
  30.         The list may contain the special escape sequences:
  31.             \n    new-line
  32.             \t    tab
  33.             \\    backslash
  34.  
  35.     -s    Merge subsequent lines rather than one from each input file.
  36.         Use tab for concatenation, unless a list is specified with
  37.         -d option.
  38.  
  39.     -    May be used in place of any file name, to read a line from
  40.         the standard input.
  41.  
  42. RETURN CODES
  43.     0 if all went well
  44.     1 in case of bad argument (fatal)
  45.     2 if at least one file couldn't be opened (non fatal)
  46.     3 if some memory couldn't be allocated (fatal)
  47.  
  48. CHANGES FROM UNIX
  49.     output lines length not limited
  50.     \0 in list not supported
  51.     -s option works even with only one file name
  52.     result of paste with -s option is not the same (but is more logic
  53.     to my mind)
  54.  
  55. AUTHOR
  56.     Denis GOUNELLE
  57.     Last modified 04-Sep-92
  58.