~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/tr.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH TR "1" "October 2012" "GNU coreutils 8.20" "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
 
use the complement of 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 tr bugs to bug\-coreutils@gnu.org
124
 
.br
125
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
126
 
.br
127
 
General help using GNU software: <http://www.gnu.org/gethelp/>
128
 
.br
129
 
Report tr translation bugs to <http://translationproject.org/team/>
130
 
.SH COPYRIGHT
131
 
Copyright \(co 2012 Free Software Foundation, Inc.
132
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
133
 
.br
134
 
This is free software: you are free to change and redistribute it.
135
 
There is NO WARRANTY, to the extent permitted by law.
136
 
.SH "SEE ALSO"
137
 
The full documentation for
138
 
.B tr
139
 
is maintained as a Texinfo manual.  If the
140
 
.B info
141
 
and
142
 
.B tr
143
 
programs are properly installed at your site, the command
144
 
.IP
145
 
.B info coreutils \(aqtr invocation\(aq
146
 
.PP
147
 
should give you access to the complete manual.