summaryrefslogtreecommitdiff
path: root/man/tr.1
blob: 8cd224c46f0e521ee4d0915a454c8a15b97ffc6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH TR "1" "March 2007" "GNU coreutils 6.9" "User Commands"
.SH NAME
tr \- translate or delete characters
.SH SYNOPSIS
.B tr
[\fIOPTION\fR]... \fISET1 \fR[\fISET2\fR]
.SH DESCRIPTION
.\" Add any additional description here
.PP
Translate, squeeze, and/or delete characters from standard input,
writing to standard output.
.TP
\fB\-c\fR, \fB\-C\fR, \fB\-\-complement\fR
first complement SET1
.TP
\fB\-d\fR, \fB\-\-delete\fR
delete characters in SET1, do not translate
.TP
\fB\-s\fR, \fB\-\-squeeze\-repeats\fR
replace each input sequence of a repeated character
that is listed in SET1 with a single occurrence
of that character
.TP
\fB\-t\fR, \fB\-\-truncate\-set1\fR
first truncate SET1 to length of SET2
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
SETs are specified as strings of characters.  Most represent themselves.
Interpreted sequences are:
.TP
\eNNN
character with octal value NNN (1 to 3 octal digits)
.TP
\e\e
backslash
.TP
\ea
audible BEL
.TP
\eb
backspace
.TP
\ef
form feed
.TP
\en
new line
.TP
\er
return
.TP
\et
horizontal tab
.TP
\ev
vertical tab
.TP
CHAR1\-CHAR2
all characters from CHAR1 to CHAR2 in ascending order
.TP
[CHAR*]
in SET2, copies of CHAR until length of SET1
.TP
[CHAR*REPEAT]
REPEAT copies of CHAR, REPEAT octal if starting with 0
.TP
[:alnum:]
all letters and digits
.TP
[:alpha:]
all letters
.TP
[:blank:]
all horizontal whitespace
.TP
[:cntrl:]
all control characters
.TP
[:digit:]
all digits
.TP
[:graph:]
all printable characters, not including space
.TP
[:lower:]
all lower case letters
.TP
[:print:]
all printable characters, including space
.TP
[:punct:]
all punctuation characters
.TP
[:space:]
all horizontal or vertical whitespace
.TP
[:upper:]
all upper case letters
.TP
[:xdigit:]
all hexadecimal digits
.TP
[=CHAR=]
all characters which are equivalent to CHAR
.PP
Translation occurs if \fB\-d\fR is not given and both SET1 and SET2 appear.
\fB\-t\fR may be used only when translating.  SET2 is extended to length of
SET1 by repeating its last character as necessary.  Excess characters
of SET2 are ignored.  Only [:lower:] and [:upper:] are guaranteed to
expand in ascending order; used in SET2 while translating, they may
only be used in pairs to specify case conversion.  \fB\-s\fR uses SET1 if not
translating nor deleting; else squeezing uses SET2 and occurs after
translation or deletion.
.SH AUTHOR
Written by Jim Meyering.
.SH "REPORTING BUGS"
Report bugs to <bug\-coreutils@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software.  You may redistribute copies of it under the terms of
the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B tr
is maintained as a Texinfo manual.  If the
.B info
and
.B tr
programs are properly installed at your site, the command
.IP
.B info tr
.PP
should give you access to the complete manual.