~ubuntu-branches/ubuntu/hardy/9base/hardy

« back to all changes in this revision

Viewing changes to tr/tr.1

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann
  • Date: 2006-01-25 15:33:00 UTC
  • Revision ID: james.westby@ubuntu.com-20060125153300-6hh4p9wx8iqqply5
Tags: upstream-2
ImportĀ upstreamĀ versionĀ 2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
 
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
.IR sed (1)