Return to gset.1 CVS log

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

Annotation of 43BSD/contrib/icon/man/cat1/gset.1, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: 
        !             4: GSET(1)               Icon Program Library                GSET(1)
        !             5: 
        !             6: 
        !             7: 
        !             8: NNNNAAAAMMMMEEEE
        !             9:      gset - perform set operations on UNIX file specifications
        !            10: 
        !            11: SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
        !            12:      ggggsssseeeetttt argument
        !            13: 
        !            14: DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
        !            15:      The UNIX shell provides for the specification of filenames
        !            16:      using ``wildcards''.  Each wildcard specification may be
        !            17:      thought of as defining a set of names (that is, those that
        !            18:      match the specification).  _G_s_e_t allows the user to apply the
        !            19:      set operations of intersection, union, and difference to
        !            20:      these filename sets. The resultant list may then be used as
        !            21:      an argument to other shell commands.
        !            22: 
        !            23:      _G_s_e_t's argument is an expression composed of legal UNIX file
        !            24:      specifications, parenthesis, and the following set opera-
        !            25:      tors:
        !            26: 
        !            27:           &&   intersection
        !            28:           ++++++++   union
        !            29:           --------   difference
        !            30: 
        !            31:      Because characters that have special meaning to the shell
        !            32:      occur frequently in the arguments used for _g_s_e_t, it is
        !            33:      advisable to quote the arguments consistently.
        !            34: 
        !            35:      The use of _g_s_e_t is illustrated by the following examples:
        !            36: 
        !            37:           gset 'g*--*.icn'
        !            38: 
        !            39:      produces the list (set) of filenames for files beginning
        !            40:      with gggg, excluding those ending with ....iiiiccccnnnn.
        !            41: 
        !            42:      Similarly,
        !            43: 
        !            44:           gset '*'
        !            45: 
        !            46:      produces all files in the current directory excluding the ....
        !            47:      and ........ files.
        !            48: 
        !            49:           gset '((*--*.icn)++c*)'
        !            50: 
        !            51:      and
        !            52: 
        !            53:           gset '(*--*.icn)++c*'
        !            54: 
        !            55:      produces the complement of all filenames ending with ....iiiiccccnnnn in
        !            56:      addition to all filenames beginning with cccc.
        !            57: 
        !            58:           gset '(((c? && c*)))'
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: Version 5.9    The University of Arizona - 8/16/84              1
        !            64: 
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: 
        !            70: GSET(1)               Icon Program Library                GSET(1)
        !            71: 
        !            72: 
        !            73: 
        !            74:      is a redundant, but legal, specification for all two-
        !            75:      character filenames that begin with cccc, while
        !            76: 
        !            77:           gset '.*'
        !            78: 
        !            79:      produces the set of filenames for all hidden files, exclud-
        !            80:      ing the .... and ........  files.
        !            81: 
        !            82: LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
        !            83:      Multiple command line arguments, formed by omitting the
        !            84:      quotes around the file set expression, are permitted.  Their
        !            85:      use is limited, however, since parentheses do not get past
        !            86:      the shell's command-line expansion.
        !            87: 
        !            88:      Almost any legal file specification will work when enclosed
        !            89:      in quotes except that the simple grammar that is used cannot
        !            90:      handle blanks adjacent to parentheses.
        !            91: 
        !            92:      File names that begin or end in ``questionable'' characters
        !            93:      such as ****, ????, ++++, ----, and &&&&, probably will not work.
        !            94: 
        !            95:      A file specification that, when interpreted by the shell,
        !            96:      produces no matching filename will be placed (unchanged) in
        !            97:      the result.
        !            98: 
        !            99: SSSSEEEEEEEE AAAALLLLSSSSOOOO
        !           100:      gcomp(1), fset(1)
        !           101: 
        !           102: AAAAUUUUTTTTHHHHOOOORRRR
        !           103:      Thomas R. Hicks
        !           104: 
        !           105: 
        !           106: 
        !           107: 
        !           108: 
        !           109: 
        !           110: 
        !           111: 
        !           112: 
        !           113: 
        !           114: 
        !           115: 
        !           116: 
        !           117: 
        !           118: 
        !           119: 
        !           120: 
        !           121: 
        !           122: 
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: Version 5.9    The University of Arizona - 8/16/84              2
        !           130: 
        !           131: 
        !           132: 

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