Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
TRANSLIT(1L)		    Schily's USER COMMANDS		  TRANSLIT(1L)

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	occur-
       rences 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.

Joerg Schilling			  2022/08/21			  TRANSLIT(1L)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=translit&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help