Return to fset.1 CVS log

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

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

1.1     ! root        1: 
        !             2: 
        !             3: 
        !             4: FSET(1)               Icon Program Library                FSET(1)
        !             5: 
        !             6: 
        !             7: 
        !             8: NNNNAAAAMMMMEEEE
        !             9:      fset - perform set operations on UNIX file specifications
        !            10: 
        !            11: SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
        !            12:      ffffsssseeeetttt 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).  _F_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:      _F_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 _f_s_e_t, it is
        !            33:      advisable to quote the arguments consistently.
        !            34: 
        !            35:      The use of _f_s_e_t is illustrated by the following examples:
        !            36: 
        !            37:           fset '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:           fset '*'
        !            45: 
        !            46:      produces all files in the current directory excluding the ....
        !            47:      and ........ files.
        !            48: 
        !            49:           fset '((*--*.icn)++c*)'
        !            50: 
        !            51:      and
        !            52: 
        !            53:           fset '(*--*.icn)++c*'
        !            54: 
        !            55:      produces the complement of all filenames ending with ....iiiiccccnnnn in
        !            56:      addition to all filenames beginning with cccc.
        !            57: 
        !            58:           fset '(((c? && c*)))'
        !            59: 
        !            60: 
        !            61: 
        !            62: 
        !            63: Version 5.9    The University of Arizona - 8/15/84              1
        !            64: 
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: 
        !            70: FSET(1)               Icon Program Library                FSET(1)
        !            71: 
        !            72: 
        !            73: 
        !            74:      is a redundant, but legal, specification for all two-
        !            75:      character filenames that begin with cccc, while
        !            76: 
        !            77:           fset '.*'
        !            78: 
        !            79:      produces the set of filenames for all hidden files, exclud-
        !            80:      ing the .... and ........  files.
        !            81: 
        !            82: RRRREEEEQQQQUUUUIIIIRRRREEEEMMMMEEEENNNNTTTTSSSS
        !            83:      _F_s_e_t requires the sets extension to Icon. _G_s_e_t performs the
        !            84:      same functions as _F_s_e_t(_1), but does not require the sets
        !            85:      extension.
        !            86: 
        !            87: LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
        !            88:      Multiple command line arguments, formed by omitting the
        !            89:      quotes around the file set expression, are permitted.  Their
        !            90:      use is limited, however, since parentheses do not get past
        !            91:      the shell's command-line expansion.
        !            92: 
        !            93:      Almost any legal file specification will work when enclosed
        !            94:      in quotes except that the simple grammar that is used cannot
        !            95:      handle blanks adjacent to parentheses.
        !            96: 
        !            97:      File names that begin or end in ``questionable'' characters
        !            98:      such as ****, ????, ++++, ----, and &&&&, probably will not work.
        !            99: 
        !           100:      A file specification that, when interpreted by the shell,
        !           101:      produces no matching filename will be placed (unchanged) in
        !           102:      the result.
        !           103: 
        !           104: SSSSEEEEEEEE AAAALLLLSSSSOOOO
        !           105:      gcomp(1), gset(1)
        !           106: 
        !           107:      Griswold, Ralph E., Robert K. McConeghy, and William H.
        !           108:      Mitchell.  _E_x_t_e_n_s_i_o_n_s _t_o _V_e_r_s_i_o_n _5 _o_f _t_h_e _I_c_o_n _P_r_o_g_r_a_m_m_i_n_g
        !           109:      _L_a_n_g_u_a_g_e, TR 84-10a, Department of Computer Science, The
        !           110:      University of Arizona, 1984.
        !           111: 
        !           112: AAAAUUUUTTTTHHHHOOOORRRR
        !           113:      Thomas R. Hicks
        !           114: 
        !           115: 
        !           116: 
        !           117: 
        !           118: 
        !           119: 
        !           120: 
        !           121: 
        !           122: 
        !           123: 
        !           124: 
        !           125: 
        !           126: 
        !           127: 
        !           128: 
        !           129: Version 5.9    The University of Arizona - 8/15/84              2
        !           130: 
        !           131: 
        !           132: 

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