contrib/gcc-4.0/gcc/doc/jv-convert.1

   1 .\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sh \" Subsection heading
   6 .br
   7 .if t .Sp
   8 .ne 5
   9 .PP
  10 \fB\\$1\fR
  11 .PP
  12 ..
  13 .de Sp \" Vertical space (when we can't use .PP)
  14 .if t .sp .5v
  15 .if n .sp
  16 ..
  17 .de Vb \" Begin verbatim text
  18 .ft CW
  19 .nf
  20 .ne \\$1
  21 ..
  22 .de Ve \" End verbatim text
  23 .ft R
  24 .fi
  25 ..
  26 .\" Set up some character translations and predefined strings.  \*(-- will
  27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  28 .\" double quote, and \*(R" will give a right double quote.  | will give a
  29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  32 .tr \(*W-|\(bv\*(Tr
  33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  34 .ie n \{\
  35 .    ds -- \(*W-
  36 .    ds PI pi
  37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  39 .    ds L" ""
  40 .    ds R" ""
  41 .    ds C` ""
  42 .    ds C' ""
  43 'br\}
  44 .el\{\
  45 .    ds -- \|\(em\|
  46 .    ds PI \(*p
  47 .    ds L" ``
  48 .    ds R" ''
  49 'br\}
  50 .\"
  51 .\" If the F register is turned on, we'll generate index entries on stderr for
  52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  54 .\" output yourself in some meaningful fashion.
  55 .if \nF \{\
  56 .    de IX
  57 .    tm Index:\\$1\t\\n%\t"\\$2"
  58 ..
  59 .    nr % 0
  60 .    rr F
  61 .\}
  62 .\"
  63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  64 .\" way too many mistakes in technical documents.
  65 .hy 0
  66 .if n .na
  67 .\"
  68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  70 .    \" fudge factors for nroff and troff
  71 .if n \{\
  72 .    ds #H 0
  73 .    ds #V .8m
  74 .    ds #F .3m
  75 .    ds #[ \f1
  76 .    ds #] \fP
  77 .\}
  78 .if t \{\
  79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  80 .    ds #V .6m
  81 .    ds #F 0
  82 .    ds #[ \&
  83 .    ds #] \&
  84 .\}
  85 .    \" simple accents for nroff and troff
  86 .if n \{\
  87 .    ds ' \&
  88 .    ds ` \&
  89 .    ds ^ \&
  90 .    ds , \&
  91 .    ds ~ ~
  92 .    ds /
  93 .\}
  94 .if t \{\
  95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 101 .\}
 102 .    \" troff and (daisy-wheel) nroff accents
 103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 110 .ds ae a\h'-(\w'a'u*4/10)'e
 111 .ds Ae A\h'-(\w'A'u*4/10)'E
 112 .    \" corrections for vroff
 113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 115 .    \" for low resolution devices (crt and lpr)
 116 .if \n(.H>23 .if \n(.V>19 \
 117 \{\
 118 .    ds : e
 119 .    ds 8 ss
 120 .    ds o a
 121 .    ds d- d\h'-1'\(ga
 122 .    ds D- D\h'-1'\(hy
 123 .    ds th \o'bp'
 124 .    ds Th \o'LP'
 125 .    ds ae ae
 126 .    ds Ae AE
 127 .\}
 128 .rm #[ #] #H #V #F C
 129 .\" ========================================================================
 130 .\"
 131 .IX Title "JV-CONVERT 1"
 132 .TH JV-CONVERT 1 "2005-04-21" "gcc-4.0.0" "GNU"
 133 .SH "NAME"
 134 jv\-convert \- Convert file from one encoding to another
 135 .SH "SYNOPSIS"
 136 .IX Header "SYNOPSIS"
 137 \&\fBjv-convert\fR [\fB\s-1OPTION\s0\fR] ... [\fI\s-1INPUTFILE\s0\fR [\fI\s-1OUTPUTFILE\s0\fR]]
 138 .SH "DESCRIPTION"
 139 .IX Header "DESCRIPTION"
 140 \&\fBjv-convert\fR is a utility included with \f(CW\*(C`libgcj\*(C'\fR which
 141 converts a file from one encoding to another.  It is similar to the Unix
 142 \&\fBiconv\fR utility.
 143 .PP
 144 The encodings supported by \fBjv-convert\fR are platform\-dependent.
 145 Currently there is no way to get a list of all supported encodings.
 146 .SH "OPTIONS"
 147 .IX Header "OPTIONS"
 148 .IP "\fB\-\-encoding\fR \fIname\fR" 4
 149 .IX Item "--encoding name"
 150 .PD 0
 151 .IP "\fB\-\-from\fR \fIname\fR" 4
 152 .IX Item "--from name"
 153 .PD
 154 Use \fIname\fR as the input encoding.  The default is the current
 155 locale's encoding.
 156 .IP "\fB\-\-to\fR \fIname\fR" 4
 157 .IX Item "--to name"
 158 Use \fIname\fR as the output encoding.  The default is the
 159 \&\f(CW\*(C`JavaSrc\*(C'\fR encoding; this is \s-1ASCII\s0 with \fB\eu\fR escapes for
 160 non-ASCII characters.
 161 .IP "\fB\-i\fR \fIfile\fR" 4
 162 .IX Item "-i file"
 163 Read from \fIfile\fR.  The default is to read from standard input.
 164 .IP "\fB\-o\fR \fIfile\fR" 4
 165 .IX Item "-o file"
 166 Write to \fIfile\fR.  The default is to write to standard output.
 167 .IP "\fB\-\-reverse\fR" 4
 168 .IX Item "--reverse"
 169 Swap the input and output encodings.
 170 .IP "\fB\-\-help\fR" 4
 171 .IX Item "--help"
 172 Print a help message, then exit.
 173 .IP "\fB\-\-version\fR" 4
 174 .IX Item "--version"
 175 Print version information, then exit.
 176 .SH "SEE ALSO"
 177 .IX Header "SEE ALSO"
 178 .SH "COPYRIGHT"
 179 .IX Header "COPYRIGHT"
 180 Copyright (c) 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
 181 .PP
 182 Permission is granted to copy, distribute and/or modify this document
 183 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2 or
 184 any later version published by the Free Software Foundation; with the
 185 Invariant Sections being ``\s-1GNU\s0 General Public License'', the Front-Cover
 186 texts being (a) (see below), and with the Back-Cover Texts being (b)
 187 (see below).  A copy of the license is included in the
 188 man page \fIgfdl\fR\|(7).
 189 .PP
 190 (a) The \s-1FSF\s0's Front-Cover Text is:
 191 .PP
 192 .Vb 1
 193 \&     A GNU Manual
 194 .Ve
 195 .PP
 196 (b) The \s-1FSF\s0's Back-Cover Text is:
 197 .PP
 198 .Vb 3
 199 \&     You have freedom to copy and modify this GNU Manual, like GNU
 200 \&     software.  Copies published by the Free Software Foundation raise
 201 \&     funds for GNU development.
 202 .Ve