tlit (1) --- transliterate characters                    02/22/82


            _U_s_a_g_e

                 tlit <from set> [ <to set> { <string> } ]


            _D_e_s_c_r_i_p_t_i_o_n

                 'Tlit'   is   the  character  transliteration  program  from
                 _S_o_f_t_w_a_r_e _T_o_o_l_s.  Character strings are read from the command
                 line  arguments,  or  from  standard  input,  transliterated
                 according  to  instructions  provided  in  the  command line
                 arguments, and the results written to standard output.   The
                 <from  set>  and  <to set> arguments are sets of characters,
                 with some special shorthand notation.  Each set may have any
                 number of the following components:

                      <character>
                           The character specified becomes part  of  the
                           set.

                      <letter>-<letter>
                           The   letters   specified,  and  all  letters
                           between them alphabetically, become  part  of
                           the  set.  (Note that letters of a given case
                           are contiguous; A-Z means all upper case let-
                           ters.)

                      <digit>-<digit>
                           The digits specified, and all digits  between
                           them  in  numerical order, become part of the
                           set.

                      @n,@t
                           A NEWLINE (if the first form is  used)  or  a
                           TAB (if the second form is used) becomes part
                           of the set.

                 In  addition,  if the <from set> is preceded by a tilde (~),
                 the complement of the set  is  used.   For  example,  "~A-Z"
                 means all characters except upper case letters.

                 For  each character read that is a member of the <from set>,
                 the corresponding member of the <to set> is substituted.  If
                 the <to set> is shorter than the <from set>, each string  of
                 contiguous characters that are in the <from set> but have no
                 corresponding  element  in  the  <to  set>  is replaced by a
                 single occurrence of the last member of the  <to  set>.   If
                 the <to set> is empty or only a single argument is supplied,
                 such character strings are deleted.

                 When  strings are read from the argument list, each separate
                 argument is treated as a NEWLINE-terminated  string.   Thus,
                 lacking specific transliteration of NEWLINE characters, each
                 separate argument string will result in one line of output.




            tlit (1)                      - 1 -                      tlit (1)




            tlit (1) --- transliterate characters                    02/22/82


            _E_x_a_m_p_l_e_s

                 file> tlit a-z A-Z >uc_file
                 file> tlit A-Z a-z | tlit ~a-z @n >words
                 tlit a-z A-Z "output one line"
                 tlit a-z A-Z output three lines


            _M_e_s_s_a_g_e_s

                 "Usage:  tlit ..."  if no arguments are supplied.
                 "<from>  set too large" if <from set> cannot be contained in
                      the internal buffer.
                 "<to> set too large" if <to set> cannot be contained in  the
                      internal buffer.


            _S_e_e _A_l_s_o

                 change (1), ed (1), _S_o_f_t_w_a_r_e _T_o_o_l_s






































            tlit (1)                      - 2 -                      tlit (1)