

            kwic (1) --- produce key-word-in-context index           02/22/82


            _U_s_a_g_e

                 kwic [ -d [ <discard list> ] ]


            _D_e_s_c_r_i_p_t_i_o_n

                 'Kwic'  is  the  key-word-in-context  program  from _S_o_f_t_w_a_r_e
                 _T_o_o_l_s.  It is a filter, taking lines of text from its  stan-
                 dard  input, rotating them so that each word in the sentence
                 appears at the beginning of a line, and marking the original
                 position of the NEWLINE with a "fold character" (currently a
                 grave accent with zero parity bit).

                 If the "-d" option is used, 'kwic' will read a  sorted  list
                 of  words, either from the file specified by <discard list>,
                 or from standard input two if the file name is omitted.   If
                 the  first  word in a rotated line is found in the list, the
                 line will not be  written  out.   The  discard  file  should
                 contain one word per line, in lower case.  (Before searching
                 the list, 'kwic' converts the search key to lower case.)

                 The  output from 'kwic' is typically sorted with 'sort' then
                 "un-rotated" with 'unrot' to produce the finished  key-word-
                 in-context index.


            _E_x_a_m_p_l_e_s

                 text> kwic | sort | unrot >index
                 headers> kwic -d discard_list >headers.k
                 headers> discard_list> kwic -d >headers.k


            _M_e_s_s_a_g_e_s

                 "<file>:  cannot open" if discard list cannot be read.
                 "<word>:  discard list too long" if there are too many words
                      in the discard list.


            _S_e_e _A_l_s_o

                 sort (1), unrot (1), _S_o_f_t_w_a_r_e _T_o_o_l_s














            kwic (1)                      - 1 -                      kwic (1)


