4.3BSD/usr/contrib/icon/man/cat1/i-trfil.1

I-TRFIL(1)            Icon Program Library             I-TRFIL(1)



NNNNAAAAMMMMEEEE
     i-trfil - Icon trace filter

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     iiii----ttttrrrrffffiiiillll [options]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _I-_t_r_f_i_l filters standard input using user-designated strings
     as keys.

     The following options may appear more than once and in any
     order:

     ++++_s_t_r_i_n_gConsider only lines containing _s_t_r_i_n_g; otherwise all
            lines are considered.

     ^^^^_s_t_r_i_n_gRemove lines containing _s_t_r_i_n_g from consideration
            (except those containing a string specified by the !!!!
            option).

     !!!!_s_t_r_i_n_gRetain lines containing _s_t_r_i_n_g.

     ----cccc_n    Print _n context lines before (if _n is negative) or
            after (if _n is positive). Nonsequential context lines
            are separated by a blank line. The default is 0.

LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
     Trace output from Icon programs goes to standard error out-
     put, which cannot be piped directly into _i-_t_r_f_i_l. This prob-
     lem can be circumvented by combining output streams. In
     _s_h(_1), this can be accomplished by

          prog 2>&1 | i-trfil ...

     while in _c_s_h(_1), it can be accomplished by

          prog |& i-trfil ...


BBBBUUUUGGGG
     If the environment variable TTTTRRRRAAAACCCCEEEE is set to a nonzero value
     when _i-_t_r_f_i_l is running, one line of tracing is produced
     from _i-_t_r_f_i_l in addition to any other tracing.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     sh(1), csh(1)

AAAAUUUUTTTTHHHHOOOORRRR
     Allan J. Anderson






Version 5.9    The University of Arizona - 5/16/83              1