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