Return to cut.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / cut

Annotation of 43BSDReno/usr.bin/cut/cut.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)cut.1      5.3 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .Dt CUT 1
        !            22: .Os BSD 4.4
        !            23: .Sh NAME
        !            24: .Nm cut
        !            25: .Nd select portions of each line of a file
        !            26: .Sh SYNOPSIS
        !            27: .Nm cut
        !            28: .Ar list
        !            29: .Ar
        !            30: .br
        !            31: .Nm cut
        !            32: .Ar list
        !            33: .Op Fl s
        !            34: .Op Fl d Ar string
        !            35: .Ar
        !            36: .Sh DESCRIPTION
        !            37: The
        !            38: .Nm cut
        !            39: utility selects portions of each line (as specified by
        !            40: .Ar list  )
        !            41: from each
        !            42: .Ar file
        !            43: (or the standard input by default), and writes them to the
        !            44: standard output.
        !            45: The items specified by
        !            46: .Ar list
        !            47: can be in terms of column position or in terms of fields delimited
        !            48: by a special character. Column numbering starts from 1.
        !            49: .Pp
        !            50: .Ar List
        !            51: is a comma or whitespace separated set of increasing numbers and/or
        !            52: number ranges.
        !            53: Number ranges consist of a number, a dash
        !            54: .Li (``\-'') ,
        !            55: and a second number
        !            56: and select the fields or columns from the first number to the second,
        !            57: inclusive.
        !            58: Numbers or number ranges may be preceded by a dash, which selects all
        !            59: fields or columns from 1 to the first number.
        !            60: Numbers or number ranges may be followed by a dash, which selects all
        !            61: fields or columns from the last number to the end of the line.
        !            62: Numbers and number ranges may be repeated, overlapping, and in any order.
        !            63: It is not an error to select fields or columns not present in the
        !            64: input line.
        !            65: .Pp
        !            66: The options are as follows:
        !            67: .Tw Fl
        !            68: .Tp Cx Fl c
        !            69: .Cx \&\ \&
        !            70: .Ar list
        !            71: .Cx
        !            72: The
        !            73: .Ar list
        !            74: specifies character positions.
        !            75: .Tp Cx Fl f
        !            76: .Cx \&\ \&
        !            77: .Ar list
        !            78: .Cx
        !            79: The
        !            80: .Ar list
        !            81: specifies fields, delimited in the input by a single tab character.
        !            82: Output fields are separated by a single tab character.
        !            83: .Tp Cx Fl d
        !            84: .Cx \&\ \&
        !            85: .Ar char
        !            86: .Cx
        !            87: Use
        !            88: .Ar char
        !            89: as the field delimiter character instead of the tab character.
        !            90: .Tp Fl s
        !            91: Suppresses lines with no field delimiter characters.
        !            92: Unless specified, lines with no delimiters are passed through unmodified.
        !            93: .Tp
        !            94: .Pp
        !            95: .Nm Cut
        !            96: exits 0 on success, 1 if an error occurred.
        !            97: .Sh SEE ALSO
        !            98: .Xr paste 1
        !            99: .Sh STANDARDS
        !           100: The
        !           101: .Nm cut
        !           102: function is expected to be POSIX 1003.2 compatible.

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