Return to fset.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / icon / man / man1

Annotation of 43BSD/contrib/icon/man/man1/fset.1, revision 1.1

1.1     ! root        1: .so tmac.ilib
        !             2: .TH FSET 1 "The University of Arizona \- 8/15/84"
        !             3: .SH NAME
        !             4: fset \- perform set operations on UNIX file specifications
        !             5: .SH SYNOPSIS
        !             6: \*Mfset\fP argument
        !             7: .SH DESCRIPTION
        !             8: The UNIX shell provides for the specification of filenames using ``wildcards''.
        !             9: Each wildcard specification may be thought of as defining a set of names
        !            10: (that is, those that match the specification).
        !            11: \fIFset\fR allows the user to apply the set operations of intersection,
        !            12: union, and difference to these filename sets. The resultant list may then
        !            13: be used as an argument to other shell commands.
        !            14: .PP
        !            15: \fIFset\fR's argument is an expression composed of legal UNIX
        !            16: file specifications, parenthesis, and the following set operators:
        !            17: .DS
        !            18: .ta .5i
        !            19: &&     \fRintersection\*M
        !            20: ++     \fRunion\*M
        !            21: \-\-   \fRdifference\fR
        !            22: .DE
        !            23: Because characters that
        !            24: have special meaning to the shell occur frequently in the arguments used
        !            25: for \fIfset\fR, it is advisable to quote the arguments consistently.
        !            26: .PP
        !            27: The use of \fIfset\fR is illustrated by the following examples:
        !            28: .DS
        !            29: fset 'g*\-\-*.icn'
        !            30: .DE
        !            31: produces the list (set) of filenames for files beginning with \*Mg\fR,
        !            32: excluding those ending with \*M.icn\fR.
        !            33: .PP
        !            34: Similarly,
        !            35: .DS
        !            36: fset '*'
        !            37: .DE
        !            38: produces all files in the current directory excluding the \*M.\fR and \*M..\fR files.
        !            39: .DS
        !            40: fset '((*\-\-*.icn)++c*)'
        !            41: .DE
        !            42: and
        !            43: .DS
        !            44: fset '(*\-\-*.icn)++c*'
        !            45: .DE
        !            46: produces the complement of all filenames ending with \*M.icn\fR in addition to
        !            47: all filenames beginning with \*Mc\fR.
        !            48: .DS
        !            49: fset '(((c? && c*)))'
        !            50: .DE
        !            51: is a redundant, but legal, specification for all two-character filenames
        !            52: that begin with \*Mc\fR, while
        !            53: .DS
        !            54: fset '.*'
        !            55: .DE
        !            56: produces the set of filenames for all hidden files, excluding the \*M.\fR and \*M..\fR
        !            57: files.
        !            58: .SH REQUIREMENTS
        !            59: \fIFset\fR requires the sets extension to Icon. \fIGset\fR performs
        !            60: the same functions as \fIFset(1)\fR, but does not require the sets
        !            61: extension.
        !            62: .SH LIMITATIONS
        !            63: Multiple command line arguments, formed by omitting the quotes around the
        !            64: file set expression, are permitted.
        !            65: Their use is limited, however, since parentheses do not get past
        !            66: the shell's command-line expansion.
        !            67: .PP
        !            68: Almost any legal file specification will work when enclosed in quotes
        !            69: except that the simple grammar that is used cannot handle blanks
        !            70: adjacent to parentheses.
        !            71: .PP
        !            72: File names that begin or end in ``questionable'' characters
        !            73: such as \*M*\fR, \*M?\fR, \*M+\fR, \*M\-\fR, and \*M&\fR, probably will not work.
        !            74: .PP
        !            75: A file specification that, when interpreted by the shell,
        !            76: produces no matching filename will be placed (unchanged) in the result.
        !            77: .SH SEE ALSO
        !            78: gcomp(1),
        !            79: gset(1)
        !            80: .PP
        !            81: .Ex
        !            82: .SH AUTHOR
        !            83: Thomas R. Hicks

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