manual/GNU_textutils/original/man1/tr.1

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