tr(1)                   (BSD Compatibility Package)                   tr(1)


   NAME
         tr - translate characters

   SYNOPSIS
         /usr/ucb/tr [ -cds ] [ string1 [ string2 ] ]

   DESCRIPTION
         tr copies the standard input to the standard output with substitution
         or deletion of selected characters.  The arguments string1 and
         string2 are considered sets of characters.  Any input character found
         in string1 is mapped into the character in the corresponding position
         within string2.  When string2 is short, it is padded to the length of
         string1 by duplicating its last character.

         In either string the notation:
               a-b

         denotes a range of characters from a to b in increasing ASCII order.
         The character \, followed by 1, 2 or 3 octal digits stands for the
         character whose ASCII code is given by those digits.  As with the
         shell, the escape character \, followed by any other character,
         escapes any special meaning for that character.

   OPTIONS
         Any combination of the options -c, -d, or -s may be used:

         -c    Complement the set of characters in string1 with respect to the
               universe of characters whose ASCII codes are 01 through 0377
               octal.

         -d    Delete all input characters in string1.

         -s    Squeeze all strings of repeated output characters that are in
               string2 to single characters.

   EXAMPLE
         The following example creates a list of all the words in filename1
         one per line in filename2, where a word is taken to be a maximal
         string of alphabetics.  The second string is quoted to protect `\'
         from the shell.  012 is the ASCII code for NEWLINE.

               tr -cs A-Za-z '\012' <filename1>filename2

   SEE ALSO
         ed(1) in the User's Reference Manual.
         ascii(5) in the System Administrator's Reference Manual.

   NOTES
         Will not handle ASCII NUL in string1 or string2.  tr always deletes
         NUL from input.



   7/91                                                                 Page 1