Return to paste CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/paste, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: paste                        Command                        paste
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Merge lines of files
                      9: 
                     10: ppaassttee [-ss] [-dd _l_i_s_t] _f_i_l_e ...
                     11: 
                     12: ppaassttee merges  corresponding lines from multiple  input files.  By
                     13: default, ppaassttee  uses the <ttaabb> character  to delineate texts from
                     14: different files.   ppaassttee writes the  the merged text  to standard
                     15: output; thus, ppaassttee can be used at the head of a shell pipeline.
                     16: 
                     17: If ppaassttee reads EOF from any  of the input files while other files
                     18: still contain data, it  substitutes blank lines as input from the
                     19: file that has ended.
                     20: 
                     21: ***** Options *****
                     22: 
                     23: ppaassttee recognizes the following command-line options:
                     24: 
                     25: -dd _l_i_s_t
                     26:     Use  the characters  in _l_i_s_t to  separate the  output fields.
                     27:     The  characters  in  _l_i_s_t  are  taken  in sequence  and  used
                     28:     circularly, i.e.,  taken in  order until  the end of  _l_i_s_t is
                     29:     reached,  then  returning to  the  first  character in  _l_i_s_t.
                     30:     Normally,  ppaassttee uses  the <ttaabb>  character to  delineate the
                     31:     output  fields.   The   following  character  sequences  have
                     32:     special meaning when encountered in _l_i_s_t:
                     33: 
                     34:     \\      Output a single backslash character
                     35:     \tt      Output a <ttaabb> character
                     36:     \nn      Output a <nneewwlliinnee> character
                     37:     \00      Output a null string (i.e., no separator between output fields)
                     38: 
                     39: 
                     40: -ss  Output successive lines from each input _f_i_l_e across the page,
                     41:     with  each input  line  separated from  the next  by a  <ttaabb>
                     42:     character.  After all input lines from a given file have been
                     43:     concatenated,  terminate  the output  line  with a  <nneewwlliinnee>
                     44:     character and repeat the process on the next input file.
                     45: 
                     46: ***** Example *****
                     47: 
                     48: The  following two  files will be  used for  subsequent examples.
                     49: FFiillee11 contains:
                     50: 
                     51: 
                     52:      File1_Line1
                     53:      File1_Line2
                     54:      File1_Line3
                     55:      File1_Line4
                     56: 
                     57: 
                     58: FFiillee22 contains:
                     59: 
                     60: 
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: paste                        Command                        paste
                     70: 
                     71: 
                     72: 
                     73:      File2_Line1
                     74:      File2_Line2
                     75:      File2_Line3
                     76:      File2_Line4
                     77: 
                     78: 
                     79: The command
                     80: 
                     81: 
                     82:      paste File1 File2
                     83: 
                     84: 
                     85: generates the following output:
                     86: 
                     87: 
                     88:      File1_Line1  File2_Line1
                     89:      File1_Line2  File2_Line2
                     90:      File1_Line3  File2_Line3
                     91:      File1_Line4  File2_Line4
                     92: 
                     93: 
                     94: Adding the option -ss yields the output:
                     95: 
                     96: 
                     97:      File1_Line1  File1_Line2 File1_Line3  File1_Line4
                     98:      File2_Line1  File2_Line2 File2_Line3  File2_Line4
                     99: 
                    100: 
                    101: ***** See Also *****
                    102: 
                    103: aawwkk, ccoommmmaannddss, ccuutt, sseedd
                    104: 
                    105: ***** Notes *****
                    106: 
                    107: ppaassttee is  copyright (c) 1989 by The Regents  of the University of
                    108: California.  All rights reserved.
                    109: 
                    110: ppaassttee is  distributed as a service to  COHERENT customers, as is.
                    111: It is not supported by Mark Williams Company.  _C_a_v_e_a_t _u_t_i_l_i_t_o_r.
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.