home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / cug / softt-11.lbr / JOIN.DOC < prev    next >
Encoding:
Text File  |  1984-07-05  |  768 b   |  25 lines

  1. .he 'JOIN'03/20/80'JOIN'
  2. NAME
  3. .sp
  4. join - replace newlines with an arbitrary string
  5. .sp 2
  6. SYNOPSIS
  7. .sp
  8. join [ <delimiter> ] [ -l<nlines> ]
  9. .sp 2
  10. DESCRIPTION
  11. .sp
  12. 'Join' reads its first standard input, replaces all newlines
  13. with the <delimiter> string, and writes the result on its first
  14. standard output.  The <delimiter> argument may be specified as
  15. any arbitrary string.  If it is omitted, a single blank is assumed.
  16. If the '-l<nlines>' construct is specified, a maximum of <nlines>
  17. input lines will be joined into each output line.
  18. .sp 2
  19. EXAMPLES
  20. .sp
  21. .nf
  22. files .r | join -l10 | change % "ar -u arch " | sh
  23. file1> join "|" >file2
  24. .fi
  25.