Return to paste.lex CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / cutpaste

Annotation of coherent/d/usr/bin/cutpaste/paste.lex, revision 1.1

1.1     ! root        1: .\" ENVIRONMENTS:  COHERENT3
        !             2: .TH paste "" "" Command
        !             3: .PC "Merge lines of files"
        !             4: \fBpaste [ \-s ] [ \-d \fIlist\fB ] \fIfile ...\fR
        !             5: .PP
        !             6: .B paste
        !             7: merges corresponding lines from multiple input files.
        !             8: By default,
        !             9: .B paste
        !            10: uses the
        !            11: .B <tab>
        !            12: character to separate text from the files.
        !            13: After merging lines from the input files,
        !            14: .B paste
        !            15: writes the resulting output to standard output,
        !            16: thus allowing
        !            17: .B paste
        !            18: to be used in a shell pipeline.
        !            19: .PP
        !            20: If end-of-file is reached on any of the input files
        !            21: while other files still contain data,
        !            22: blank lines will be substituted as input.
        !            23: .SH Options
        !            24: .B paste
        !            25: accepts the following options from the command line.
        !            26: .RS
        !            27: .IP "\fB-d \fIlist\fR" 0.4i
        !            28: .br
        !            29: Use the characters found in
        !            30: .I list
        !            31: to separate the output fields.
        !            32: The characters in
        !            33: .I list
        !            34: are taken in sequence and used circularly,
        !            35: i.e. taken in order until the end of
        !            36: .I list
        !            37: is reached, with a wrap-around back to the beginning of
        !            38: .IR list .
        !            39: Normally,
        !            40: .B paste
        !            41: uses the
        !            42: .B <tab>
        !            43: character to separate the output fields.
        !            44: The following character sequences have special meaning when encountered in
        !            45: .IR list :
        !            46: .sp
        !            47: \fB\e\e\fR     output a single backslash character.
        !            48: .br
        !            49: \fB\et\fR      output a
        !            50: .B <tab>
        !            51: character.
        !            52: .br
        !            53: \fB\en\fR      output a
        !            54: .B <newline>
        !            55: character.
        !            56: .br
        !            57: \fB\e0\fR      output a null string (i.e., no separator between output fields).
        !            58: .sp
        !            59: .IP \fB-s\fR
        !            60: Output successive lines from each input
        !            61: .I file
        !            62: across the page,
        !            63: with each input line separated from the next by a
        !            64: .B <tab>
        !            65: character.
        !            66: After all input lines from a given file have been concatenated,
        !            67: terminate the output line with a
        !            68: .B <newline>
        !            69: character and repeat the process on the next input file.
        !            70: .RE
        !            71: .SH Example
        !            72: The following two files will be used for subsequent examples.
        !            73: .B File1
        !            74: contains:
        !            75: .ID
        !            76: .ta 0.5i
        !            77:        File1_Line1
        !            78:        File1_Line2
        !            79:        File1_Line3
        !            80:        File1_Line4
        !            81: .IE
        !            82: .B File2
        !            83: contains:
        !            84: .ID
        !            85: .ta 0.5i
        !            86:        File2_Line1
        !            87:        File2_Line2
        !            88:        File2_Line3
        !            89:        File2_Line4
        !            90: .IE
        !            91: Given the command:
        !            92: .ID
        !            93: .ta 0.5i
        !            94:        paste File1 File2
        !            95: .IE
        !            96: the resulting output would be:
        !            97: .ID
        !            98: .ta 0.5i 1.75i
        !            99:        File1_Line1     File2_Line1
        !           100:        File1_Line2     File2_Line2
        !           101:        File1_Line3     File2_Line3
        !           102:        File1_Line4     File2_Line4
        !           103: .IE
        !           104: Adding the option
        !           105: .B \-s
        !           106: yields the output:
        !           107: .ID
        !           108: .ta 0.5i 1.75i 3.0i 4.25i
        !           109:        File1_Line1     File1_Line2     File1_Line3     File1_Line4
        !           110:        File2_Line1     File2_Line2     File2_Line3     File2_Line4
        !           111: .IE
        !           112: .SH "See Also"
        !           113: .B
        !           114: commands,
        !           115: cut
        !           116: .R
        !           117: .SH Author
        !           118: .B paste
        !           119: is copyright \f(MW!\fR 1989
        !           120: by The Regents of the University of California.
        !           121: All rights reserved.
        !           122: .PP
        !           123: .B paste
        !           124: is distributed as a service to COHERENT customers, as is.
        !           125: It is not supported by Mark Williams Company.
        !           126: .I "Caveat utilitor."

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