annotate src/linux/doc/man/native2ascii.1 @ 7280:a4f32e60635c

properly disable doclint now that it is integrated into langtools
author mduigou
date Tue, 05 Feb 2013 09:31:37 -0800
parents d58354a69011
children
rev   line source
bpatel@4186 1 ." Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
duke@0 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@0 3 ."
duke@0 4 ." This code is free software; you can redistribute it and/or modify it
duke@0 5 ." under the terms of the GNU General Public License version 2 only, as
duke@0 6 ." published by the Free Software Foundation.
duke@0 7 ."
duke@0 8 ." This code is distributed in the hope that it will be useful, but WITHOUT
duke@0 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@0 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@0 11 ." version 2 for more details (a copy is included in the LICENSE file that
duke@0 12 ." accompanied this code).
duke@0 13 ."
duke@0 14 ." You should have received a copy of the GNU General Public License version
duke@0 15 ." 2 along with this work; if not, write to the Free Software Foundation,
duke@0 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@0 17 ."
ohair@2362 18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@2362 19 ." or visit www.oracle.com if you need additional information or have any
ohair@2362 20 ." questions.
duke@0 21 ."
bpatel@4186 22 .TH native2ascii 1 "10 May 2011"
tbell@1178 23
duke@0 24 .LP
tbell@1178 25 .SH "Name"
duke@0 26 native2ascii \- Native\-to\-ASCII Converter
duke@0 27 .LP
duke@0 28 .LP
bpatel@4186 29 Converts a file with characters in any supported character encoding to one with ASCII and/or Unicode escapes, or visa versa.
duke@0 30 .LP
duke@0 31 .SH "SYNOPSIS"
duke@0 32 .LP
duke@0 33 .nf
duke@0 34 \f3
duke@0 35 .fl
duke@0 36 \fP\f4native2ascii\fP\f2 [options] [inputfile [outputfile]]\fP
duke@0 37 .fl
duke@0 38 .fi
duke@0 39
duke@0 40 .LP
duke@0 41 .SH "DESCRIPTION"
duke@0 42 .LP
duke@0 43 .LP
bpatel@4186 44 \f2native2ascii\fP converts files that are encoded to any character encoding that is supported by the Java runtime environment to files encoded in ASCII, using Unicode escapes ("\\uxxxx" notation) for all characters that are not part of the ASCII character set. This process is required for properties files containing characters not in ISO\-8859\-1 character sets. The tool can also perform the reverse conversion.
duke@0 45 .LP
duke@0 46 .LP
duke@0 47 If \f2outputfile\fP is omitted, standard output is used for output. If, in addition, \f2inputfile\fP is omitted, standard input is used for input.
duke@0 48 .LP
duke@0 49 .SH "OPTIONS"
duke@0 50 .LP
tbell@1178 51 .RS 3
duke@0 52 .TP 3
duke@0 53 \-reverse
bpatel@4186 54 Perform the reverse operation: Convert a file encoded in ISO\-8859\-1 with Unicode escapes to a file in any character encoding supported by the Java runtime environment.
duke@0 55 .br
duke@0 56 .br
duke@0 57 .TP 3
duke@0 58 \-encoding encoding_name
bpatel@4186 59 Specifies the name of the character encoding to be used by the conversion procedure. If this option is not present, the default character encoding (as determined by the \f2java.nio.charset.Charset.defaultCharset\fP method) is used. The \f2encoding_name\fP string must be the name of a character encoding that is supported by the Java runtime environment \- see the
duke@0 60 .na
duke@0 61 \f4Supported Encodings\fP @
duke@0 62 .fi
bpatel@4186 63 http://download.oracle.com/javase/7/docs/technotes/guides/intl/encoding.doc.html document.
bpatel@4186 64 .br
bpatel@4186 65 .br
duke@0 66 .TP 3
duke@0 67 \-Joption
tbell@1178 68 Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
tbell@1178 69 .RE
tbell@1178 70
duke@0 71 .LP
duke@0 72