nkf.1

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