1 .TH TR 1
2 .SH NAME
3 tr \- translate characters
4 .SH SYNOPSIS
5 .B tr
6 [
7 .B -cds
8 ]
9 [
10 .I string1
11 [
12 .I string2
13 ]
14 ]
15 .SH DESCRIPTION
16 .I Tr
17 copies the standard input to the standard output with
18 substitution or deletion of selected characters (runes).
19 Input characters found in
20 .I string1
21 are mapped into the corresponding characters of
22 .IR string2 .
23 When
24 .I string2
25 is short it is padded to the length of
26 .I string1
27 by duplicating its last character.
28 Any combination of the options
29 .B -cds
30 may be used:
31 .TP
32 .B -c
33 Complement
34 .IR string1 :
35 replace it with a lexicographically ordered
36 list of all other characters.
37 .TP
38 .B -d
39 Delete from input all characters in
40 .IR string1 .
41 .TP
42 .B -s
43 Squeeze repeated output characters that occur in
44 .I string2
45 to single characters.
46 .PP
47 In either string a noninitial sequence
48 .BI - x\f1,
49 where 
50 .I x
51 is any character (possibly quoted), stands for
52 a range of characters:
53 a possibly empty sequence of codes running from
54 the successor of the previous code up through
55 the code for
56 .IR x .
57 The character
58 .L \e
59 followed by 1, 2 or 3 octal digits stands for the
60 character whose
61 16-bit
62 value is given by those digits.
63 The character sequence
64 .L \ex
65 followed by 1, 2, 3, or 4 hexadecimal digits stands
66 for the character whose
67 16-bit value is given by those digits.
68 A 
69 .L \e
70 followed by any other character stands
71 for that character.
72 .SH EXAMPLES
73 Replace all upper-case
74 .SM ASCII
75 letters by lower-case.
76 .IP
77 .EX
78 tr A-Z a-z <mixed >lower
79 .EE
80 .PP
81 Create a list of all
82 the words in
83 .L file1
84 one per line in
85 .LR file2 ,
86 where a word is taken to be a maximal string of alphabetics.
87 .I String2
88 is given as a quoted newline.
89 .IP
90 .EX
91 tr -cs A-Za-z '
92 \&' <file1 >file2
93 .EE
94 .SH SOURCE
95 .B \*9/src/cmd/tr.c
96 .SH "SEE ALSO"
97 .MR sed (1)