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

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.