1native2ascii(1) General Commands Manual native2ascii(1)
2
6 native2ascii - Native-to-ASCII Converter
7 Converts a file with characters in any supported character encoding to
9 one with ASCII and/or Unicode escapes, or visa versa.
10
12 native2ascii [options] [inputfile [outputfile]]
13
16 native2ascii converts files that are encoded to any character encoding
17 that is supported by the Java runtime environment to files encoded in
18 ASCII, using Unicode escapes ("\uxxxx" notation) for all characters
19 that are not part of the ASCII character set. This process is required
20 for properties files containing characters not in ISO-8859-1 character
21 sets. The tool can also perform the reverse conversion.
22 If outputfile is omitted, standard output is used for output. If, in
24 addition, inputfile is omitted, standard input is used for input.
25
27 -reverse
28 Perform the reverse operation: Convert a file encoded in
29 ISO-8859-1 with Unicode escapes to a file in any character encod‐
30 ing supported by the Java runtime environment.
31 -encoding encoding_name
33 Specifies the name of the character encoding to be used by the
34 conversion procedure. If this option is not present, the default
35 character encoding (as determined by the
36 java.nio.charset.Charset.defaultCharset method) is used. The
37 encoding_name string must be the name of a character encoding
38 that is supported by the Java runtime environment - see the Sup‐
39 ported Encodings @
40 http://docs.oracle.com/javase/7/docs/technotes/guides/intl/encod‐
41 ing.doc.html document.
42 -Joption
44 Pass option to the Java virtual machine, where option is one of
45 the options described on the reference page for the java(1). For
46 example, -J-Xms48m sets the startup memory to 48 megabytes.
47 16 Mar 2012 native2ascii(1)