nkf.1

   1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 'br\}
  42 .\"
  43 .\" Escape single quotes in literal strings from groff's Unicode transform.
  44 .ie \n(.g .ds Aq \(aq
  45 .el       .ds Aq '
  46 .\"
  47 .\" If the F register is turned on, we'll generate index entries on stderr for
  48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  50 .\" output yourself in some meaningful fashion.
  51 .ie \nF \{\
  52 .    de IX
  53 .    tm Index:\\$1\t\\n%\t"\\$2"
  54 ..
  55 .    nr % 0
  56 .    rr F
  57 .\}
  58 .el \{\
  59 .    de IX
  60 ..
  61 .\}
  62 .\"
  63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  64 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  65 .    \" fudge factors for nroff and troff
  66 .if n \{\
  67 .    ds #H 0
  68 .    ds #V .8m
  69 .    ds #F .3m
  70 .    ds #[ \f1
  71 .    ds #] \fP
  72 .\}
  73 .if t \{\
  74 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  75 .    ds #V .6m
  76 .    ds #F 0
  77 .    ds #[ \&
  78 .    ds #] \&
  79 .\}
  80 .    \" simple accents for nroff and troff
  81 .if n \{\
  82 .    ds ' \&
  83 .    ds ` \&
  84 .    ds ^ \&
  85 .    ds , \&
  86 .    ds ~ ~
  87 .    ds /
  88 .\}
  89 .if t \{\
  90 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  91 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  92 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  93 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  94 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  95 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  96 .\}
  97 .    \" troff and (daisy-wheel) nroff accents
  98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 105 .ds ae a\h'-(\w'a'u*4/10)'e
 106 .ds Ae A\h'-(\w'A'u*4/10)'E
 107 .    \" corrections for vroff
 108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 110 .    \" for low resolution devices (crt and lpr)
 111 .if \n(.H>23 .if \n(.V>19 \
 112 \{\
 113 .    ds : e
 114 .    ds 8 ss
 115 .    ds o a
 116 .    ds d- d\h'-1'\(ga
 117 .    ds D- D\h'-1'\(hy
 118 .    ds th \o'bp'
 119 .    ds Th \o'LP'
 120 .    ds ae ae
 121 .    ds Ae AE
 122 .\}
 123 .rm #[ #] #H #V #F C
 124 .\" ========================================================================
 125 .\"
 126 .IX Title "nkf 1"
 127 .TH nkf 1 "2013-11-22" "nkf 2.1.3" " "
 128 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 129 .\" way too many mistakes in technical documents.
 130 .if n .ad l
 131 .nh
 132 .SH "NAME"
 133 nkf \- Network Kanji Filter
 134 .SH "SYNOPSIS"
 135 .IX Header "SYNOPSIS"
 136 nkf \fB[\-butjnesliohrTVvwWJESZxXFfmMBOcdILg]\fR \fB[\fR\fIfile ...\fR\fB]\fR
 137 .SH "DESCRIPTION"
 138 .IX Header "DESCRIPTION"
 139 \&\fBNkf\fR is a yet another kanji code converter among networks, hosts and terminals.
 140 It converts input kanji code to designated kanji code
 141 such as \s-1ISO\-2022\-JP\s0, Shift_JIS, EUC-JP, \s-1UTF\-8\s0, \s-1UTF\-16\s0 or \s-1UTF\-32\s0.
 142 .PP
 143 One of the most unique faculty of \fBnkf\fR is the guess of the input kanji encodings.
 144 It currently recognizes \s-1ISO\-2022\-JP\s0, Shift_JIS, EUC-JP, \s-1UTF\-8\s0, \s-1UTF\-16\s0 and \s-1UTF\-32\s0.
 145 So users needn't set the input kanji code explicitly.
 146 .PP
 147 By default, X0201 kana is converted into X0208 kana.
 148 For X0201 kana, \s-1SO/SI\s0, \s-1SSO\s0 and \s-1ESC\-\s0(\-I methods are supported.
 149 For automatic code detection, nkf assumes no X0201 kana in Shift_JIS.
 150 To accept X0201 in Shift_JIS, use \fB\-X\fR, \fB\-x\fR or \fB\-S\fR.
 151 .SH "OPTIONS"
 152 .IX Header "OPTIONS"
 153 .IP "\fB\-J \-S \-E \-W \-W16 \-W32 \-j \-s \-e \-w \-w16 \-w32\fR" 4
 154 .IX Item "-J -S -E -W -W16 -W32 -j -s -e -w -w16 -w32"
 155 Specify input and output encodings. Upper case is input.
 156 cf. \-\-ic and \-\-oc.
 157 .RS 4
 158 .IP "\fB\-J\fR" 4
 159 .IX Item "-J"
 160 \&\s-1ISO\-2022\-JP\s0 (\s-1JIS\s0 code).
 161 .IP "\fB\-S\fR" 4
 162 .IX Item "-S"
 163 Shift_JIS and \s-1JIS\s0 X 0201 kana.
 164 EUC-JP is recognized as X0201 kana. Without \fB\-x\fR flag,
 165 \&\s-1JIS\s0 X 0201 Katakana (a.k.a.halfwidth kana) is converted into \s-1JIS\s0 X 0208.
 166 If you use Windows, see Windows\-31J (\s-1CP932\s0).
 167 .IP "\fB\-E\fR" 4
 168 .IX Item "-E"
 169 EUC-JP.
 170 .IP "\fB\-W\fR" 4
 171 .IX Item "-W"
 172 \&\s-1UTF\-8N\s0.
 173 .IP "\fB\-W16[\s-1BL\s0][0]\fR" 4
 174 .IX Item "-W16[BL][0]"
 175 \&\s-1UTF\-16\s0.
 176 B or L gives whether Big Endian or Little Endian.
 177 0 gives whther put \s-1BOM\s0 or not.
 178 .IP "\fB\-W32[\s-1BL\s0][0]\fR" 4
 179 .IX Item "-W32[BL][0]"
 180 \&\s-1UTF\-32\s0.
 181 B or L gives whether Big Endian or Little Endian.
 182 0 gives whther put \s-1BOM\s0 or not.
 183 .RE
 184 .RS 4
 185 .RE
 186 .IP "\fB\-b \-u\fR" 4
 187 .IX Item "-b -u"
 188 Output is buffered (\s-1DEFAULT\s0), Output is unbuffered.
 189 .IP "\fB\-t\fR" 4
 190 .IX Item "-t"
 191 No conversion.
 192 .IP "\fB\-i[@B]\fR" 4
 193 .IX Item "-i[@B]"
 194 Specify the escape sequence for \s-1JIS\s0 X 0208.
 195 .RS 4
 196 .IP "\fB\-i@\fR" 4
 197 .IX Item "-i@"
 198 Use \s-1ESC\s0 ( @. (\s-1JIS\s0 X 0208\-1978)
 199 .IP "\fB\-iB\fR" 4
 200 .IX Item "-iB"
 201 Use \s-1ESC\s0 ( B. (\s-1JIS\s0 X 0208\-1983/1990 \s-1DEFAULT\s0)
 202 .RE
 203 .RS 4
 204 .RE
 205 .IP "\fB\-o[\s-1BJ\s0]\fR" 4
 206 .IX Item "-o[BJ]"
 207 Specify the escape sequence for \s-1US\-ASCII/JIS\s0 X 0201 Roman. (\s-1DEFAULT\s0 B)
 208 .IP "\fB\-r\fR" 4
 209 .IX Item "-r"
 210 {de/en}crypt \s-1ROT13/47\s0
 211 .IP "\fB\-h[123] \-\-hiragana \-\-katakana \-\-katakana\-hiragana\fR" 4
 212 .IX Item "-h[123] --hiragana --katakana --katakana-hiragana"
 213 .RS 4
 214 .PD 0
 215 .IP "\fB\-h1 \-\-hiragana\fR" 4
 216 .IX Item "-h1 --hiragana"
 217 .PD
 218 Katakana to Hiragana conversion.
 219 .IP "\fB\-h2 \-\-katakana\fR" 4
 220 .IX Item "-h2 --katakana"
 221 Hiragana to Katakana conversion.
 222 .IP "\fB\-h3 \-\-katakana\-hiragana\fR" 4
 223 .IX Item "-h3 --katakana-hiragana"
 224 Katakana to Hiragana and Hiragana to Katakana conversion.
 225 .RE
 226 .RS 4
 227 .RE
 228 .IP "\fB\-T\fR" 4
 229 .IX Item "-T"
 230 Text mode output (MS-DOS)
 231 .IP "\fB\-f[\f(BIm\fB [\- \f(BIn\fB]]\fR" 4
 232 .IX Item "-f[m [- n]]"
 233 Folding on \fIm\fR length with \fIn\fR margin in a line.
 234 Without this option, fold length is 60 and fold margin is 10.
 235 .IP "\fB\-F\fR" 4
 236 .IX Item "-F"
 237 New line preserving line folding.
 238 .IP "\fB\-Z[0\-3]\fR" 4
 239 .IX Item "-Z[0-3]"
 240 Convert X0208 alphabet (Fullwidth Alphabets) to \s-1ASCII\s0.
 241 .RS 4
 242 .IP "\fB\-Z \-Z0\fR" 4
 243 .IX Item "-Z -Z0"
 244 Convert X0208 alphabet to \s-1ASCII\s0.
 245 .IP "\fB\-Z1\fR" 4
 246 .IX Item "-Z1"
 247 Convert X0208 kankaku to single \s-1ASCII\s0 space.
 248 .IP "\fB\-Z2\fR" 4
 249 .IX Item "-Z2"
 250 Convert X0208 kankaku to double \s-1ASCII\s0 spaces.
 251 .IP "\fB\-Z3\fR" 4
 252 .IX Item "-Z3"
 253 Replacing fullwidth >, <, ", & into '&gt;', '&lt;', '&quot;', '&amp;' as in \s-1HTML\s0.
 254 .RE
 255 .RS 4
 256 .RE
 257 .IP "\fB\-X \-x\fR" 4
 258 .IX Item "-X -x"
 259 With \fB\-X\fR or without this option, X0201 is converted into X0208 Kana.
 260 With \fB\-x\fR, try to preserve X0208 kana and do not convert X0201 kana to X0208.
 261 In \s-1JIS\s0 output, \s-1ESC\-\s0(\-I is used. In \s-1EUC\s0 output, \s-1SS2\s0 is used.
 262 .IP "\fB\-B[0\-2]\fR" 4
 263 .IX Item "-B[0-2]"
 264 Assume broken JIS-Kanji input, which lost \s-1ESC\s0.
 265 Useful when your site is using old B\-News Nihongo patch.
 266 .RS 4
 267 .IP "\fB\-B1\fR" 4
 268 .IX Item "-B1"
 269 allows any chars after \s-1ESC\-\s0( or \s-1ESC\-$\s0.
 270 .IP "\fB\-B2\fR" 4
 271 .IX Item "-B2"
 272 force \s-1ASCII\s0 after \s-1NL\s0.
 273 .RE
 274 .RS 4
 275 .RE
 276 .IP "\fB\-I\fR" 4
 277 .IX Item "-I"
 278 Replacing non iso\-2022\-jp char into a geta character
 279 (substitute character in Japanese).
 280 .IP "\fB\-m[\s-1BQN0\s0]\fR" 4
 281 .IX Item "-m[BQN0]"
 282 \&\s-1MIME\s0 \s-1ISO\-2022\-JP/ISO8859\-1\s0 decode. (\s-1DEFAULT\s0)
 283 To see \s-1ISO8859\-1\s0 (Latin\-1) \-l is necessary.
 284 .RS 4
 285 .IP "\fB\-mB\fR" 4
 286 .IX Item "-mB"
 287 Decode \s-1MIME\s0 base64 encoded stream. Remove header or other part before
 288 conversion.
 289 .IP "\fB\-mQ\fR" 4
 290 .IX Item "-mQ"
 291 Decode \s-1MIME\s0 quoted stream. '_' in quoted stream is converted to space.
 292 .IP "\fB\-mN\fR" 4
 293 .IX Item "-mN"
 294 Non-strict decoding.
 295 It allows line break in the middle of the base64 encoding.
 296 .IP "\fB\-m0\fR" 4
 297 .IX Item "-m0"
 298 No \s-1MIME\s0 decode.
 299 .RE
 300 .RS 4
 301 .RE
 302 .IP "\fB\-M\fR" 4
 303 .IX Item "-M"
 304 \&\s-1MIME\s0 encode. Header style. All \s-1ASCII\s0 code and control characters are intact.
 305 .RS 4
 306 .IP "\fB\-MB\fR" 4
 307 .IX Item "-MB"
 308 \&\s-1MIME\s0 encode Base64 stream.
 309 Kanji conversion is performed before encoding, so this cannot be used as a picture encoder.
 310 .IP "\fB\-MQ\fR" 4
 311 .IX Item "-MQ"
 312 Perform quoted encoding.
 313 .RE
 314 .RS 4
 315 .RE
 316 .IP "\fB\-l\fR" 4
 317 .IX Item "-l"
 318 Input and output code is \s-1ISO8859\-1\s0 (Latin\-1) and \s-1ISO\-2022\-JP\s0.
 319 \&\fB\-s\fR, \fB\-e\fR and \fB\-x\fR are not compatible with this option.
 320 .IP "\fB\-L[uwm] \-d \-c\fR" 4
 321 .IX Item "-L[uwm] -d -c"
 322 Convert line breaks.
 323 .RS 4
 324 .IP "\fB\-Lu \-d\fR" 4
 325 .IX Item "-Lu -d"
 326 unix (\s-1LF\s0)
 327 .IP "\fB\-Lw \-c\fR" 4
 328 .IX Item "-Lw -c"
 329 windows (\s-1CRLF\s0)
 330 .IP "\fB\-Lm\fR" 4
 331 .IX Item "-Lm"
 332 mac (\s-1CR\s0)
 333 .Sp
 334 Without this option, nkf doesn't convert line breaks.
 335 .RE
 336 .RS 4
 337 .RE
 338 .IP "\fB\-\-fj \-\-unix \-\-mac \-\-msdos \-\-windows\fR" 4
 339 .IX Item "--fj --unix --mac --msdos --windows"
 340 Convert for these systems.
 341 .IP "\fB\-\-jis \-\-euc \-\-sjis \-\-mime \-\-base64\fR" 4
 342 .IX Item "--jis --euc --sjis --mime --base64"
 343 Convert to named code.
 344 .IP "\fB\-\-jis\-input \-\-euc\-input \-\-sjis\-input \-\-mime\-input \-\-base64\-input\fR" 4
 345 .IX Item "--jis-input --euc-input --sjis-input --mime-input --base64-input"
 346 Assume input system
 347 .IP "\fB\-\-ic=\f(BIinput codeset\fB \-\-oc=\f(BIoutput codeset\fB\fR" 4
 348 .IX Item "--ic=input codeset --oc=output codeset"
 349 Set the input or output codeset.
 350 \&\s-1NKF\s0 supports following codesets and those codeset names are case insensitive.
 351 .RS 4
 352 .IP "\s-1ISO\-2022\-JP\s0" 4
 353 .IX Item "ISO-2022-JP"
 354 a.k.a. \s-1RFC1468\s0, 7bit \s-1JIS\s0, \s-1JUNET\s0
 355 .IP "EUC-JP (eucJP-nkf)" 4
 356 .IX Item "EUC-JP (eucJP-nkf)"
 357 a.k.a. \s-1AT&T\s0 \s-1JIS\s0, Japanese \s-1EUC\s0, \s-1UJIS\s0
 358 .IP "eucJP-ascii" 4
 359 .IX Item "eucJP-ascii"
 360 .PD 0
 361 .IP "eucJP-ms" 4
 362 .IX Item "eucJP-ms"
 363 .IP "\s-1CP51932\s0" 4
 364 .IX Item "CP51932"
 365 .PD
 366 Microsoft Version of EUC-JP.
 367 .IP "Shift_JIS" 4
 368 .IX Item "Shift_JIS"
 369 a.k.a. \s-1SJIS\s0, MS_Kanji
 370 .IP "Windows\-31J" 4
 371 .IX Item "Windows-31J"
 372 a.k.a. \s-1CP932\s0
 373 .IP "\s-1UTF\-8\s0" 4
 374 .IX Item "UTF-8"
 375 same as \s-1UTF\-8N\s0
 376 .IP "\s-1UTF\-8N\s0" 4
 377 .IX Item "UTF-8N"
 378 \&\s-1UTF\-8\s0 without \s-1BOM\s0
 379 .IP "\s-1UTF\-8\-BOM\s0" 4
 380 .IX Item "UTF-8-BOM"
 381 \&\s-1UTF\-8\s0 with \s-1BOM\s0
 382 .IP "\s-1UTF8\-MAC\s0 (input only)" 4
 383 .IX Item "UTF8-MAC (input only)"
 384 decomposed \s-1UTF\-8\s0
 385 .IP "\s-1UTF\-16\s0" 4
 386 .IX Item "UTF-16"
 387 same as \s-1UTF\-16BE\s0
 388 .IP "\s-1UTF\-16BE\s0" 4
 389 .IX Item "UTF-16BE"
 390 \&\s-1UTF\-16\s0 Big Endian without \s-1BOM\s0
 391 .IP "\s-1UTF\-16BE\-BOM\s0" 4
 392 .IX Item "UTF-16BE-BOM"
 393 \&\s-1UTF\-16\s0 Big Endian with \s-1BOM\s0
 394 .IP "\s-1UTF\-16LE\s0" 4
 395 .IX Item "UTF-16LE"
 396 \&\s-1UTF\-16\s0 Little Endian without \s-1BOM\s0
 397 .IP "\s-1UTF\-16LE\-BOM\s0" 4
 398 .IX Item "UTF-16LE-BOM"
 399 \&\s-1UTF\-16\s0 Little Endian with \s-1BOM\s0
 400 .IP "\s-1UTF\-32\s0" 4
 401 .IX Item "UTF-32"
 402 same as \s-1UTF\-32BE\s0
 403 .IP "\s-1UTF\-32BE\s0" 4
 404 .IX Item "UTF-32BE"
 405 \&\s-1UTF\-32\s0 Big Endian without \s-1BOM\s0
 406 .IP "\s-1UTF\-32BE\-BOM\s0" 4
 407 .IX Item "UTF-32BE-BOM"
 408 \&\s-1UTF\-32\s0 Big Endian with \s-1BOM\s0
 409 .IP "\s-1UTF\-32LE\s0" 4
 410 .IX Item "UTF-32LE"
 411 \&\s-1UTF\-32\s0 Little Endian without \s-1BOM\s0
 412 .IP "\s-1UTF\-32LE\-BOM\s0" 4
 413 .IX Item "UTF-32LE-BOM"
 414 \&\s-1UTF\-32\s0 Little Endian with \s-1BOM\s0
 415 .RE
 416 .RS 4
 417 .RE
 418 .IP "\fB\-\-fb\-{skip, html, xml, perl, java, subchar}\fR" 4
 419 .IX Item "--fb-{skip, html, xml, perl, java, subchar}"
 420 Specify the way that nkf handles unassigned characters.
 421 Without this option, \-\-fb\-skip is assumed.
 422 .IP "\fB\-\-prefix=\f(BIescape character\fB\f(BItarget character\fB..\fR" 4
 423 .IX Item "--prefix=escape charactertarget character.."
 424 When nkf converts to Shift_JIS,
 425 nkf adds a specified escape character to specified 2nd byte of Shift_JIS characters.
 426 1st byte of argument is the escape character and following bytes are target characters.
 427 .IP "\fB\-\-no\-cp932ext\fR" 4
 428 .IX Item "--no-cp932ext"
 429 Handle the characters extended in \s-1CP932\s0 as unassigned characters.
 430 .IP "\fB\-\-no\-best\-fit\-chars\fR" 4
 431 .IX Item "--no-best-fit-chars"
 432 When Unicode to Encoded byte conversion,
 433 don't convert characters which is not round trip safe.
 434 When Unicode to Unicode conversion,
 435 with this and \-x option, nkf can be used as \s-1UTF\s0 converter.
 436 (In other words, without this and \-x option, nkf doesn't save some characters)
 437 .Sp
 438 When nkf converts strings that related to path, you should use this opion.
 439 .IP "\fB\-\-cap\-input\fR" 4
 440 .IX Item "--cap-input"
 441 Decode hex encoded characters.
 442 .IP "\fB\-\-url\-input\fR" 4
 443 .IX Item "--url-input"
 444 Unescape percent escaped characters.
 445 .IP "\fB\-\-numchar\-input\fR" 4
 446 .IX Item "--numchar-input"
 447 Decode character reference, such as \*(L"&#....;\*(R".
 448 .IP "\fB\-\-in\-place[=\fR\fI\s-1SUFFIX\s0\fR\fB]\fR  \fB\-\-overwrite[=\fR\fI\s-1SUFFIX\s0\fR\fB]\fR" 4
 449 .IX Item "--in-place[=SUFFIX]  --overwrite[=SUFFIX]"
 450 Overwrite \fBoriginal\fR listed files by filtered result.
 451 .Sp
 452 \&\fBNote\fR \-\-overwrite preserves timestamps of original files.
 453 .IP "\fB\-\-guess=[12]\fR" 4
 454 .IX Item "--guess=[12]"
 455 Print guessed encoding and newline. (2 is default, 1 is only encoding)
 456 .IP "\fB\-\-help\fR" 4
 457 .IX Item "--help"
 458 Print nkf's help.
 459 .IP "\fB\-\-version\fR" 4
 460 .IX Item "--version"
 461 Print nkf's version.
 462 .IP "\fB\-\-\fR" 4
 463 .IX Item "--"
 464 Ignore rest of \-option.
 465 .SH "AUTHOR"
 466 .IX Header "AUTHOR"
 467 Copyright (c) 1987, Fujitsu \s-1LTD\s0. (Itaru \s-1ICHIKAWA\s0).
 468 .PP
 469 Copyright (c) 1996\-2013, The nkf Project.