X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=nkf.1;h=3a595c8429b05572a76d602bd3a1a5a08d5f2ff9;hb=6775d370b141b30816b6ac93e9818f1e495856f0;hp=89ad5f6f33b948cccbb7b98232e40b4ac1a1a672;hpb=49e636e3d9fdbf86c62dd89a17a36c76e1a1d565;p=nkf%2Fnkf.git

diff --git a/nkf.1 b/nkf.1
index 89ad5f6..3a595c8 100644
--- a/nkf.1
+++ b/nkf.1
@@ -1,15 +1,7 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.37
+.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
 .de Sp \" Vertical space (when we can't use .PP)
 .if t .sp .5v
 .if n .sp
@@ -25,11 +17,11 @@
 ..
 .\" Set up some character translations and predefined strings.  \*(-- will
 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
-.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
-.\" expand to `' in nroff, nothing in troff, for use with C<>.
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
@@ -46,25 +38,33 @@
 .    ds PI \(*p
 .    ds L" ``
 .    ds R" ''
+.    ds C`
+.    ds C'
 'br\}
 .\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
 .\" entries marked with X<> in POD.  Of course, you'll have to process the
 .\" output yourself in some meaningful fashion.
-.if \nF \{\
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.if !\nF .nr F 0
+.if \nF>0 \{\
 .    de IX
 .    tm Index:\\$1\t\\n%\t"\\$2"
 ..
-.    nr % 0
-.    rr F
+.    if !\nF==2 \{\
+.        nr % 0
+.        nr F 2
+.    \}
 .\}
 .\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 .    \" fudge factors for nroff and troff
@@ -129,7 +129,11 @@
 .\" ========================================================================
 .\"
 .IX Title "nkf 1"
-.TH nkf 1 "2010-04-19" "nkf 2.1.1" " "
+.TH nkf 1 "2018-12-15" "nkf 2.1.5" " "
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
 .SH "NAME"
 nkf \- Network Kanji Filter
 .SH "SYNOPSIS"
@@ -139,16 +143,24 @@ nkf \fB[\-butjnesliohrTVvwWJESZxXFfmMBOcdILg]\fR \fB[\fR\fIfile ...\fR\fB]\fR
 .IX Header "DESCRIPTION"
 \&\fBNkf\fR is a yet another kanji code converter among networks, hosts and terminals.
 It converts input kanji code to designated kanji code
-such as \s-1ISO\-2022\-JP\s0, Shift_JIS, \s-1EUC\-JP\s0, \s-1UTF\-8\s0, \s-1UTF\-16\s0 or \s-1UTF\-32\s0.
+such as \s-1ISO\-2022\-JP,\s0 Shift_JIS, EUC-JP, \s-1UTF\-8, UTF\-16\s0 or \s-1UTF\-32.\s0
 .PP
 One of the most unique faculty of \fBnkf\fR is the guess of the input kanji encodings.
-It currently recognizes \s-1ISO\-2022\-JP\s0, Shift_JIS, \s-1EUC\-JP\s0, \s-1UTF\-8\s0, \s-1UTF\-16\s0 and \s-1UTF\-32\s0.
+It currently recognizes \s-1ISO\-2022\-JP,\s0 Shift_JIS, EUC-JP, \s-1UTF\-8, UTF\-16\s0 and \s-1UTF\-32.\s0
 So users needn't set the input kanji code explicitly.
 .PP
 By default, X0201 kana is converted into X0208 kana.
-For X0201 kana, \s-1SO/SI\s0, \s-1SSO\s0 and \s-1ESC\-\s0(\-I methods are supported.
+For X0201 kana, \s-1SO/SI, SSO\s0 and \s-1ESC\-\s0(\-I methods are supported.
 For automatic code detection, nkf assumes no X0201 kana in Shift_JIS.
 To accept X0201 in Shift_JIS, use \fB\-X\fR, \fB\-x\fR or \fB\-S\fR.
+.PP
+multiple options are specified as separate strings, such as
+.PP
+.Vb 1
+\&  print nkf(\*(Aq\-\-ic=UTF8\-MAC\*(Aq, \*(Aq\-w\*(Aq, $string), "\en";
+.Ve
+.PP
+except the last arguments.
 .SH "OPTIONS"
 .IX Header "OPTIONS"
 .IP "\fB\-J \-S \-E \-W \-W16 \-W32 \-j \-s \-e \-w \-w16 \-w32\fR" 4
@@ -161,26 +173,26 @@ cf. \-\-ic and \-\-oc.
 \&\s-1ISO\-2022\-JP\s0 (\s-1JIS\s0 code).
 .IP "\fB\-S\fR" 4
 .IX Item "-S"
-Shift_JIS and \s-1JIS\s0 X 0201 kana.
+Shift_JIS and \s-1JIS X 0201\s0 kana.
 EUC-JP is recognized as X0201 kana. Without \fB\-x\fR flag,
-\&\s-1JIS\s0 X 0201 Katakana (a.k.a.halfwidth kana) is converted into \s-1JIS\s0 X 0208.
+\&\s-1JIS X 0201\s0 Katakana (a.k.a.halfwidth kana) is converted into \s-1JIS X 0208.\s0
 If you use Windows, see Windows\-31J (\s-1CP932\s0).
 .IP "\fB\-E\fR" 4
 .IX Item "-E"
-\&\s-1EUC\-JP\s0.
+EUC-JP.
 .IP "\fB\-W\fR" 4
 .IX Item "-W"
-\&\s-1UTF\-8N\s0.
+\&\s-1UTF\-8N.\s0
 .IP "\fB\-W16[\s-1BL\s0][0]\fR" 4
 .IX Item "-W16[BL][0]"
-\&\s-1UTF\-16\s0.
-B or L gives whether Big Endian or Little Endian.
-0 gives whther put \s-1BOM\s0 or not.
+\&\s-1UTF\-16.
+B\s0 or L gives whether Big Endian or Little Endian.
+0 gives whether put \s-1BOM\s0 or not.
 .IP "\fB\-W32[\s-1BL\s0][0]\fR" 4
 .IX Item "-W32[BL][0]"
-\&\s-1UTF\-32\s0.
-B or L gives whether Big Endian or Little Endian.
-0 gives whther put \s-1BOM\s0 or not.
+\&\s-1UTF\-32.
+B\s0 or L gives whether Big Endian or Little Endian.
+0 gives whether put \s-1BOM\s0 or not.
 .RE
 .RS 4
 .RE
@@ -192,20 +204,20 @@ Output is buffered (\s-1DEFAULT\s0), Output is unbuffered.
 No conversion.
 .IP "\fB\-i[@B]\fR" 4
 .IX Item "-i[@B]"
-Specify the escape sequence for \s-1JIS\s0 X 0208.
+Specify the escape sequence for \s-1JIS X 0208.\s0
 .RS 4
 .IP "\fB\-i@\fR" 4
 .IX Item "-i@"
-Use \s-1ESC\s0 ( @. (\s-1JIS\s0 X 0208\-1978)
+Use \s-1ESC\s0 ( @. (\s-1JIS X 0208\-1978\s0)
 .IP "\fB\-iB\fR" 4
 .IX Item "-iB"
-Use \s-1ESC\s0 ( B. (\s-1JIS\s0 X 0208\-1983/1990 \s-1DEFAULT\s0)
+Use \s-1ESC\s0 ( B. (\s-1JIS X 0208\-1983/1990 DEFAULT\s0)
 .RE
 .RS 4
 .RE
 .IP "\fB\-o[\s-1BJ\s0]\fR" 4
 .IX Item "-o[BJ]"
-Specify the escape sequence for \s-1US\-ASCII/JIS\s0 X 0201 Roman. (\s-1DEFAULT\s0 B)
+Specify the escape sequence for \s-1US\-ASCII/JIS X 0201\s0 Roman. (\s-1DEFAULT B\s0)
 .IP "\fB\-r\fR" 4
 .IX Item "-r"
 {de/en}crypt \s-1ROT13/47\s0
@@ -228,10 +240,7 @@ Katakana to Hiragana and Hiragana to Katakana conversion.
 .RE
 .IP "\fB\-T\fR" 4
 .IX Item "-T"
-Text mode output (\s-1MS\-DOS\s0)
-.IP "\fB\-l\fR" 4
-.IX Item "-l"
-\&\s-1ISO8859\-1\s0 (Latin\-1) support
+Text mode output (MS-DOS)
 .IP "\fB\-f[\f(BIm\fB [\- \f(BIn\fB]]\fR" 4
 .IX Item "-f[m [- n]]"
 Folding on \fIm\fR length with \fIn\fR margin in a line.
@@ -241,11 +250,11 @@ Without this option, fold length is 60 and fold margin is 10.
 New line preserving line folding.
 .IP "\fB\-Z[0\-3]\fR" 4
 .IX Item "-Z[0-3]"
-Convert X0208 alphabet (Fullwidth Alphabets) to \s-1ASCII\s0.
+Convert X0208 alphabet (Fullwidth Alphabets) to \s-1ASCII.\s0
 .RS 4
 .IP "\fB\-Z \-Z0\fR" 4
 .IX Item "-Z -Z0"
-Convert X0208 alphabet to \s-1ASCII\s0.
+Convert X0208 alphabet to \s-1ASCII.\s0
 .IP "\fB\-Z1\fR" 4
 .IX Item "-Z1"
 Convert X0208 kankaku to single \s-1ASCII\s0 space.
@@ -254,7 +263,7 @@ Convert X0208 kankaku to single \s-1ASCII\s0 space.
 Convert X0208 kankaku to double \s-1ASCII\s0 spaces.
 .IP "\fB\-Z3\fR" 4
 .IX Item "-Z3"
-Replacing fullwidth >, <, ", & into '&gt;', '&lt;', '&quot;', '&amp;' as in \s-1HTML\s0.
+Replacing fullwidth >, <, ", & into '&gt;', '&lt;', '&quot;', '&amp;' as in \s-1HTML.\s0
 .RE
 .RS 4
 .RE
@@ -265,15 +274,15 @@ With \fB\-x\fR, try to preserve X0208 kana and do not convert X0201 kana to X020
 In \s-1JIS\s0 output, \s-1ESC\-\s0(\-I is used. In \s-1EUC\s0 output, \s-1SS2\s0 is used.
 .IP "\fB\-B[0\-2]\fR" 4
 .IX Item "-B[0-2]"
-Assume broken JIS-Kanji input, which lost \s-1ESC\s0.
+Assume broken JIS-Kanji input, which lost \s-1ESC.\s0
 Useful when your site is using old B\-News Nihongo patch.
 .RS 4
 .IP "\fB\-B1\fR" 4
 .IX Item "-B1"
-allows any chars after \s-1ESC\-\s0( or \s-1ESC\-$\s0.
+allows any chars after \s-1ESC\-\s0( or \s-1ESC\-$.\s0
 .IP "\fB\-B2\fR" 4
 .IX Item "-B2"
-force \s-1ASCII\s0 after \s-1NL\s0.
+force \s-1ASCII\s0 after \s-1NL.\s0
 .RE
 .RS 4
 .RE
@@ -283,13 +292,13 @@ Replacing non iso\-2022\-jp char into a geta character
 (substitute character in Japanese).
 .IP "\fB\-m[\s-1BQN0\s0]\fR" 4
 .IX Item "-m[BQN0]"
-\&\s-1MIME\s0 \s-1ISO\-2022\-JP/ISO8859\-1\s0 decode. (\s-1DEFAULT\s0)
+\&\s-1MIME ISO\-2022\-JP/ISO8859\-1\s0 decode. (\s-1DEFAULT\s0)
 To see \s-1ISO8859\-1\s0 (Latin\-1) \-l is necessary.
 .RS 4
 .IP "\fB\-mB\fR" 4
 .IX Item "-mB"
 Decode \s-1MIME\s0 base64 encoded stream. Remove header or other part before
-conversion. 
+conversion.
 .IP "\fB\-mQ\fR" 4
 .IX Item "-mQ"
 Decode \s-1MIME\s0 quoted stream. '_' in quoted stream is converted to space.
@@ -319,7 +328,7 @@ Perform quoted encoding.
 .RE
 .IP "\fB\-l\fR" 4
 .IX Item "-l"
-Input and output code is \s-1ISO8859\-1\s0 (Latin\-1) and \s-1ISO\-2022\-JP\s0.
+Input and output code is \s-1ISO8859\-1\s0 (Latin\-1) and \s-1ISO\-2022\-JP.\s0
 \&\fB\-s\fR, \fB\-e\fR and \fB\-x\fR are not compatible with this option.
 .IP "\fB\-L[uwm] \-d \-c\fR" 4
 .IX Item "-L[uwm] -d -c"
@@ -355,10 +364,10 @@ Set the input or output codeset.
 .RS 4
 .IP "\s-1ISO\-2022\-JP\s0" 4
 .IX Item "ISO-2022-JP"
-a.k.a. \s-1RFC1468\s0, 7bit \s-1JIS\s0, \s-1JUNET\s0
-.IP "EUC-JP (eucJP\-nkf)" 4
+a.k.a. \s-1RFC1468,\s0 7bit \s-1JIS, JUNET\s0
+.IP "EUC-JP (eucJP-nkf)" 4
 .IX Item "EUC-JP (eucJP-nkf)"
-a.k.a. \s-1AT&T\s0 \s-1JIS\s0, Japanese \s-1EUC\s0, \s-1UJIS\s0
+a.k.a. \s-1AT&T JIS,\s0 Japanese \s-1EUC, UJIS\s0
 .IP "eucJP-ascii" 4
 .IX Item "eucJP-ascii"
 .PD 0
@@ -367,10 +376,10 @@ a.k.a. \s-1AT&T\s0 \s-1JIS\s0, Japanese \s-1EUC\s0, \s-1UJIS\s0
 .IP "\s-1CP51932\s0" 4
 .IX Item "CP51932"
 .PD
-Microsoft Version of \s-1EUC\-JP\s0.
+Microsoft Version of EUC-JP.
 .IP "Shift_JIS" 4
 .IX Item "Shift_JIS"
-a.k.a. \s-1SJIS\s0, MS_Kanji
+a.k.a. \s-1SJIS,\s0 MS_Kanji
 .IP "Windows\-31J" 4
 .IX Item "Windows-31J"
 a.k.a. \s-1CP932\s0
@@ -439,7 +448,7 @@ When Unicode to Unicode conversion,
 with this and \-x option, nkf can be used as \s-1UTF\s0 converter.
 (In other words, without this and \-x option, nkf doesn't save some characters)
 .Sp
-When nkf converts strings that related to path, you should use this opion.
+When nkf converts strings that related to path, you should use this option.
 .IP "\fB\-\-cap\-input\fR" 4
 .IX Item "--cap-input"
 Decode hex encoded characters.
@@ -450,7 +459,7 @@ Unescape percent escaped characters.
 .IX Item "--numchar-input"
 Decode character reference, such as \*(L"&#....;\*(R".
 .IP "\fB\-\-in\-place[=\fR\fI\s-1SUFFIX\s0\fR\fB]\fR  \fB\-\-overwrite[=\fR\fI\s-1SUFFIX\s0\fR\fB]\fR" 4
-.IX Item "--in-place[=SUFFIX]  --overwrite[=SUFFIX]"
+.IX Item "--in-place[=SUFFIX] --overwrite[=SUFFIX]"
 Overwrite \fBoriginal\fR listed files by filtered result.
 .Sp
 \&\fBNote\fR \-\-overwrite preserves timestamps of original files.
@@ -468,6 +477,6 @@ Print nkf's version.
 Ignore rest of \-option.
 .SH "AUTHOR"
 .IX Header "AUTHOR"
-Copyright (c) 1987, Fujitsu \s-1LTD\s0. (Itaru \s-1ICHIKAWA\s0).
+Copyright (c) 1987, Fujitsu \s-1LTD.\s0 (Itaru \s-1ICHIKAWA\s0).
 .PP
-Copyright (c) 1996\-2010, The nkf Project.
+Copyright (c) 1996\-2018, The nkf Project.