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 speci-
     fied 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 re-
     lated 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+15.1.quarterly>

home | help