NAME

translit - translates characters

SYNOPSIS

translit [ options ] from_string to_string [file1 ... filen]

DESCRIPTION

Translit performs a character substitution, changing the characters specified in the from_string to the corresponding characters in the to_string. Since the mapping is done one to one, the from_string must be equal to or larger than the to_string. If the from_string is larger, the end of the from set is mapped to the last character of the to set.

The files are not modified, all output is written to standard out. If no files are specified, translit reads from standard input.

OPTIONS

-help

Prints a short summary of the translit options and exists.

-version

Prints the translit version number string and exists.

-c

Complement the set of values specified by from_string.

-d

Delete all occurrences of input characters that are specified in from_string.

-s

Replace instances of repeated characters that are specified in from_string with a single character. If the -d option has also been specified, the character set is taken from to_string.

OPERANDS

The following notations of characters are supported:

c       Any single byte character not described below
\ddd    Represents octal notations of characters
\\      Represents the backslash
\a      Represents the audible bell
\b      Represents the backspace character
\f      Represents the formfeed character
\n      Represents the newline character
\r      Represents the carriage return character
\t      Represents the tab character
\v      Represents the vertical tab character

NOTES

When the to_string is smaller than the from_string, multiple occurrences of the folded characters are not generated. Translating all letters, white space and punctuation, to X's, for example, will cause only a single X to appear on the output stream.

If the to_string is empty, all occurrences of input characters that are specified in from_string are deleted and produce no output.

You can use reverse ranges,

translit [a-z] [z-a]

will change every a to z and every z to a and so forth.

If an ordinary digit in the octal range is following an octal sequence, the octal sequence must use three octal digits.

If from_string or to_string start with the unescaped character '^', the related set is complemented.

BUGS

None currently known.

Mail bugs and suggestions to schilytools@mlists.in-berlin.de or open a ticket at https://codeberg.org/schilytools/schilytools/issues.

The mailing list archive may be found at:

https://mlists.in-berlin.de/mailman/listinfo/schilytools-mlists.in-berlin.de.

AUTHORS

Joerg Schilling and the schilytools project authors.

SOURCE DOWNLOAD

The source code for translit is included in the schilytools project and may be retrieved from the schilytools project at Codeberg at

https://codeberg.org/schilytools/schilytools.

The download directory is

https://codeberg.org/schilytools/schilytools/releases.