diff options
author | Takuji Tanaka <KXD02663@nifty.ne.jp> | 2016-12-21 13:47:36 +0000 |
---|---|---|
committer | Takuji Tanaka <KXD02663@nifty.ne.jp> | 2016-12-21 13:47:36 +0000 |
commit | 735d542570d760d595cc89a5293dbee3e008f4c0 (patch) | |
tree | c5000d5965dec9fff2c3ef7e3345fd583846d84a /Build/source/texk | |
parent | ffa0a2fcd408c72486a1574f94f0ee704ea47e83 (diff) |
texk/mendexk: Update manuals mendex-doc (19dec16)
git-svn-id: svn://tug.org/texlive/trunk@42761 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk')
-rw-r--r-- | Build/source/texk/mendexk/COPYRIGHT.ja | 32 | ||||
-rw-r--r-- | Build/source/texk/mendexk/COPYRIGHT.jis | 32 | ||||
-rw-r--r-- | Build/source/texk/mendexk/ChangeLog | 9 | ||||
-rw-r--r-- | Build/source/texk/mendexk/ChangeLog.ja | 105 | ||||
-rw-r--r-- | Build/source/texk/mendexk/ChangeLog.jis | 105 | ||||
-rw-r--r-- | Build/source/texk/mendexk/Makefile.am | 6 | ||||
-rw-r--r-- | Build/source/texk/mendexk/mendex.1 | 446 | ||||
-rw-r--r-- | Build/source/texk/mendexk/mendex.1.ja | 502 | ||||
-rw-r--r-- | Build/source/texk/mendexk/mendex.doc | 17 |
9 files changed, 925 insertions, 329 deletions
diff --git a/Build/source/texk/mendexk/COPYRIGHT.ja b/Build/source/texk/mendexk/COPYRIGHT.ja new file mode 100644 index 00000000000..3aec46c7ffe --- /dev/null +++ b/Build/source/texk/mendexk/COPYRIGHT.ja @@ -0,0 +1,32 @@ +(注) 以下は、英文の契約条項を日本語に翻訳したものである。日本語訳と英 +語表記の間に齟齬があった場合には、契約条件は英語表記による契約条項に従 +う。 + +【著作権表示】 +Copyright (C) 1995 ASCII Corporation. +All rights reserved. + +【契約条件】 +改変の有無にかかわらず、本ソフトウェアのソースコード及びバイナリーコー +ド形式による再頒布及び使用は、次の契約条件の下に許諾される。 +1. ソースコードの再頒布に際しては、上記の【著作権表示】、この【契約条 + 件】及び次の【免責条項】の表記を、引き続き維持して明記しなければな + らない。 +2. バイナリー形式による再頒布に際しては、上記の【著作権表示】、この + 【契約条件】及び次の【免責条項】を、再頒布に際し提供する説明書及び + その他の関連資料に改めて明記しなければならない。 +3. 特別な事前の書面による許諾がない限り、本ソフトウェアから派生した製 + 品を推奨又は宣伝するために、著作権者名は使用してはならない。 + +【免責条項】 +本ソフトウェアは、著作権者により、「現状有姿のまま(そのままの形で)」 +提供されるものであり、商品性又は特定目的への適合性に関する黙示的保証な +ど、明示又は黙示の保証を問わず、いかなる保証をも行うものではない。 +いかなる理由によっても、また、契約責任、厳格責任又は(過失によるものを +含む)不法行為責任を問わずどのような責任の理論によっても、著作権者は、 +いかなる場合も、本ソフトウェアを使用することにより発生する、あらゆる直 +接損害、間接損害、偶発損害、特別損害、懲罰的損害あるいは派生的損害(代 +替製品・代替サービスの調達、使用利益、データ又は収益に関する損失、営業 +中断による損失など)について何らの責任も負わない。これは、本ソフトウェ +アを使用することにより、これらの損害が発生する可能性について、あらかじ +め示唆されていた場合であっても同様である。 diff --git a/Build/source/texk/mendexk/COPYRIGHT.jis b/Build/source/texk/mendexk/COPYRIGHT.jis deleted file mode 100644 index 7f56280dae8..00000000000 --- a/Build/source/texk/mendexk/COPYRIGHT.jis +++ /dev/null @@ -1,32 +0,0 @@ -($BCm(B) $B0J2<$O!"1QJ8$N7@Ls>r9`$rF|K\8l$KK]Lu$7$?$b$N$G$"$k!#F|K\8lLu$H1Q(B -$B8lI=5-$N4V$Ksrsw$,$"$C$?>l9g$K$O!"7@Ls>r7o$O1Q8lI=5-$K$h$k7@Ls>r9`$K=>(B -$B$&!#(B - -$B!ZCx:n8"I=<(![(B -Copyright (C) 1995 ASCII Corporation. -All rights reserved. - -$B!Z7@Ls>r7o![(B -$B2~JQ$NM-L5$K$+$+$o$i$:!"K\%=%U%H%&%'%"$N%=!<%9%3!<%I5Z$S%P%$%J%j!<%3!<(B -$B%I7A<0$K$h$k:FHRI[5Z$S;HMQ$O!"<!$N7@Ls>r7o$N2<$K5vBz$5$l$k!#(B -1. $B%=!<%9%3!<%I$N:FHRI[$K:]$7$F$O!">e5-$N!ZCx:n8"I=<(![!"$3$N!Z7@Ls>r(B - $B7o![5Z$S<!$N!ZLH@U>r9`![$NI=5-$r!"0z$-B3$-0];}$7$FL@5-$7$J$1$l$P$J(B - $B$i$J$$!#(B -2. $B%P%$%J%j!<7A<0$K$h$k:FHRI[$K:]$7$F$O!">e5-$N!ZCx:n8"I=<(![!"$3$N(B - $B!Z7@Ls>r7o![5Z$S<!$N!ZLH@U>r9`![$r!":FHRI[$K:]$7Ds6!$9$k@bL@=q5Z$S(B - $B$=$NB>$N4XO";qNA$K2~$a$FL@5-$7$J$1$l$P$J$i$J$$!#(B -3. $BFCJL$J;vA0$N=qLL$K$h$k5vBz$,$J$$8B$j!"K\%=%U%H%&%'%"$+$iGI@8$7$?@=(B - $BIJ$r?d>)Kt$O@kEA$9$k$?$a$K!"Cx:n8"<TL>$O;HMQ$7$F$O$J$i$J$$!#(B - -$B!ZLH@U>r9`![(B -$BK\%=%U%H%&%'%"$O!"Cx:n8"<T$K$h$j!"!V8=>uM-;Q$N$^$^!J$=$N$^$^$N7A$G!K!W(B -$BDs6!$5$l$k$b$N$G$"$j!">&IJ@-Kt$OFCDjL\E*$X$NE,9g@-$K4X$9$kL[<(E*J]>Z$J(B -$B$I!"L@<(Kt$OL[<($NJ]>Z$rLd$o$:!"$$$+$J$kJ]>Z$r$b9T$&$b$N$G$O$J$$!#(B -$B$$$+$J$kM}M3$K$h$C$F$b!"$^$?!"7@Ls@UG$!"873J@UG$Kt$O!J2a<:$K$h$k$b$N$r(B -$B4^$`!KITK!9T0Y@UG$$rLd$o$:$I$N$h$&$J@UG$$NM}O@$K$h$C$F$b!"Cx:n8"<T$O!"(B -$B$$$+$J$k>l9g$b!"K\%=%U%H%&%'%"$r;HMQ$9$k$3$H$K$h$jH/@8$9$k!"$"$i$f$kD>(B -$B@\B;32!"4V@\B;32!"6vH/B;32!"FCJLB;32!"D(H3E*B;32$"$k$$$OGI@8E*B;32!JBe(B -$BBX@=IJ!&BeBX%5!<%S%9$ND4C#!";HMQMx1W!"%G!<%?Kt$O<}1W$K4X$9$kB;<:!"1D6H(B -$BCfCG$K$h$kB;<:$J$I!K$K$D$$$F2?$i$N@UG$$bIi$o$J$$!#$3$l$O!"K\%=%U%H%&%'(B -$B%"$r;HMQ$9$k$3$H$K$h$j!"$3$l$i$NB;32$,H/@8$9$k2DG=@-$K$D$$$F!"$"$i$+$8(B -$B$a<(:6$5$l$F$$$?>l9g$G$"$C$F$bF1MM$G$"$k!#(B diff --git a/Build/source/texk/mendexk/ChangeLog b/Build/source/texk/mendexk/ChangeLog index fee188493b1..40577d504f0 100644 --- a/Build/source/texk/mendexk/ChangeLog +++ b/Build/source/texk/mendexk/ChangeLog @@ -1,3 +1,12 @@ +2016-12-21 TANAKA Takuji <ttk@t-lab.opal.ne.jp> + + * mendex.1, mendex.doc, mendex.1.ja: Sync with upstream. + Now they are maintained at + https://github.com/texjporg/mendex-doc + * COPYRIGHT.ja, ChangeLog.ja: Rename from *.jis and convert + encoding to UTF-8 + * Makefile.am: Add those files to EXTRA_DIST. + 2016-12-15 Akira Kakuto <kakuto@fuk.kindai.ac.jp> * main.c: Remove email address "ptex-staff@ml.asciimw.jp" as in upmendex. diff --git a/Build/source/texk/mendexk/ChangeLog.ja b/Build/source/texk/mendexk/ChangeLog.ja new file mode 100644 index 00000000000..ed4ff177005 --- /dev/null +++ b/Build/source/texk/mendexk/ChangeLog.ja @@ -0,0 +1,105 @@ +mendex 変更履歴 + +2.3c->2.3e +・同じ索引語が64個までしか処理できなかった制限をなくした。また、EUCのコンパイラ + でSJIS対応のバイナリを作れるように修正。 + +2.3e->2.3f +・preamble,postambleが複数行にわたるとおかしくなるバグを修正。また、索引項目中 + の"\"の処理がおかしかった箇所を修正。 + +2.3f->2.3g +・同じ索引項目の上限が128個であったのを2147483648個(int型の上限)まで拡張。 +・*.indファイル生成用の文字列領域を拡張。 + +2.3g->2.3h +・全索引項目数が4096個までになっていたのでこの制限をなくした。 +・ページ範囲の処理にバグがあったので修正。 + +2.3h->2.4a +・ページのソート処理にバグがあったので修正。 +・ページ範囲の処理にまだ問題があったので修正。 +・kpathsea-3.0へ対応(kpathsea-2.6, kpathseaなしでも可)。 +・makeindexに合わせるために環境変数名を変更。 + INDEXSTYLE -> INDEXDEFAULTSTYLE + INDEXSTYLES -> INDEXSTYLE + MENDEX_DICTIONARY -> INDEXDEFAULTDICTIONARY + INDEXDICTS -> INDEXDICTIONARY + +2.4a->2.4b +・ページ範囲の始めと終わりが同じ場合には範囲表現をしないように修正。 +・ページ番号にコマンドを付ける場合の動作についてmakeindexとの互換性を向上。 + +2.4b->2.4c +・「ぬ」の後の音引きの変換に失敗するバグを修正。 + +2.4c->2.4d +・ページ番号のソート処理にバグがあったので修正。 + +2.4d->2.4e +・主索引項目の下に2つ以上の副索引項目がある場合に、副索引間のコマンド文字列が + おかしい場合があったので修正。 + +2.4e->2.4f +・主索引項目の下に2つ以上の副索引項目がある場合に、副索引間のコマンド文字列が + おかしい場合があったので修正。 +・Shift-JIS処理時に、ページ番号に付加するコマンドに2バイト文字が使用された場合に + 動作がおかしくなるので修正。 + +2.4f->2.5 +・-s オプション使用時にスタイルパラメータ escape の値がおかしくなっていたので + 修正。 +・makeindexに合わせるため、以下ように仕様を変更。 + 1. -c オプション時の動作を修正。makeindex では索引語の前後の空きを削除するが、 + mendex では空きが残っていたので、削除するようにした。 + 2. makeindex で使用されているスタイルパラメータのうち、mendexでサポートされて + いなかったものを追加サポート。 + delim_t + suffix_2p + suffix_3p + suffix_mp + heading_flag + heading_prefix + symhead_positive + symhead_negative + ただし、以下の makeindex 用パラメータは無視される。 + numhead_positive + numhead_negative + 3. escape の仕様を変更。arg_open, arg_close をエスケープ可能にした。このため、 + escape が1つだけの項目は受け付けられなくなった。 + 4. エントリ中で actual の後に項目が無い場合に、actual の前の文字列を項目とする + ように変更。 + 5. エントリ中で level の後に項目が無い場合、level を無視するように変更。 + +2.5->2.5a +・引数の入力ファイル名から拡張子(.idx)を省略した場合にエラーが発生するバグを + 修正。 + +2.5a->2.6 +・不正な索引行の読み込みを禁止するよう修正。 +・インストールにconfigureを使用するように変更。 +・漢字コードオプションを追加。 + +2.6->2.6a +・kana.h, ktable.h中の漢字コード記述をEUCに変更。 +・usageおよび読み込みエラー表示時の漢字コードを修正。 + +2.6a->2.6b +・読み展開時のエラー表示の漢字コードを修正。 +・非漢字部の範囲を厳密化。 + +2.6b->2.6c +・SJISモード時の出力の文字化けを修正。 +・出力メッセージ中のaccept、rejectの数値を修正。 +・teTeXのconfigureで指定されたコンパイラを使用するようにMakefile.inを修正。 + +2.6c->2.6d +・非GNU環境でのインストールのためにMakefile.inを修正。 +・ページ番号部に漢字がある場合の文字化けを修正(ただしページ番号としては処理 + されない)。 + +2.6d->2.6e +・行長制限を1024バイトから65536バイトへ変更。 + +2.6e->2.6f +・2階層以上の索引の親階層の読みが直前の索引と同じ場合、親階層が出力されない不具合を修正。 diff --git a/Build/source/texk/mendexk/ChangeLog.jis b/Build/source/texk/mendexk/ChangeLog.jis deleted file mode 100644 index e3218d5e158..00000000000 --- a/Build/source/texk/mendexk/ChangeLog.jis +++ /dev/null @@ -1,105 +0,0 @@ -mendex ѹ - -2.3c->2.3e -Ʊ줬64ĤޤǤǤʤä¤ʤޤEUCΥѥ - SJISбΥХʥ褦˽ - -2.3e->2.3f -preamble,postambleʣԤˤ錄ȤʤХޤ - "\"νäս - -2.3f->2.3g -Ʊܤξ¤128ĤǤäΤ2147483648(intξ)ޤdzĥ -*.indեѤʸΰĥ - -2.3g->2.3h -ܿ4096ĤޤǤˤʤäƤΤǤ¤ʤ -ڡϰϤν˥ХäΤǽ - -2.3h->2.4a -ڡΥȽ˥ХäΤǽ -ڡϰϤνˤޤ꤬äΤǽ -kpathsea-3.0б(kpathsea-2.6, kpathseaʤǤ) -makeindex˹碌뤿˴Ķѿ̾ѹ - INDEXSTYLE -> INDEXDEFAULTSTYLE - INDEXSTYLES -> INDEXSTYLE - MENDEX_DICTIONARY -> INDEXDEFAULTDICTIONARY - INDEXDICTS -> INDEXDICTIONARY - -2.4a->2.4b -ڡϰϤλϤȽ꤬Ʊˤϰɽʤ褦˽ -ڡֹ˥ޥɤդưˤĤmakeindexȤθߴ塣 - -2.4b->2.4c -̡֤פθβѴ˼ԤХ - -2.4c->2.4d -ڡֹΥȽ˥ХäΤǽ - -2.4d->2.4e -ܤβ2İʾܤˡ֤Υޥʸ - 礬äΤǽ - -2.4e->2.4f -ܤβ2İʾܤˡ֤Υޥʸ - 礬äΤǽ -Shift-JISˡڡֹղä륳ޥɤ2ХʸѤ줿 - ưʤΤǽ - -2.4f->2.5 --s ץѻ˥ѥ escape ͤʤäƤΤ - -makeindex˹碌뤿ᡢʲ褦˻ͤѹ - 1. -c ץưmakeindex ǤϺζ뤬 - mendex Ǥ϶ĤäƤΤǡ褦ˤ - 2. makeindex ǻѤƤ륹ѥΤmendexǥݡȤ - ʤäΤɲåݡȡ - delim_t - suffix_2p - suffix_3p - suffix_mp - heading_flag - heading_prefix - symhead_positive - symhead_negative - ʲ makeindex ѥѥ̵뤵롣 - numhead_positive - numhead_negative - 3. escape λͤѹarg_open, arg_close ײǽˤΤᡢ - escape 1Ĥιܤϼդʤʤä - 4. ȥ actual θ˹ܤ̵ˡactual ʸܤȤ - 褦ѹ - 5. ȥ level θ˹ܤ̵硢level ̵뤹褦ѹ - -2.5->2.5a -ϥե̾ĥ(.idx)ά˥顼ȯХ - - -2.5a->2.6 -ʺԤɤ߹ߤػߤ褦 -ȡconfigureѤ褦ѹ -ɥץɲá - -2.6->2.6a -kana.h, ktable.hδɵҤEUCѹ -usageɤ߹ߥ顼ɽδɤ - -2.6a->2.6b -ɤŸΥ顼ɽδɤ -ϰϤ̩ - -2.6b->2.6c -SJIS⡼ɻνϤʸ -ϥåacceptrejectοͤ -teTeXconfigureǻꤵ줿ѥѤ褦Makefile.in - -2.6c->2.6d -GNUĶǤΥȡΤMakefile.in -ڡֹ˴ʸ(ڡֹȤƤϽ - ʤ) - -2.6d->2.6e -Ť1024ХȤ65536ХȤѹ - -2.6e->2.6f -2ذʾκοƳؤɤߤľκƱ硢ƳؤϤʤԶ diff --git a/Build/source/texk/mendexk/Makefile.am b/Build/source/texk/mendexk/Makefile.am index bb1a454b9e5..06360c6edfa 100644 --- a/Build/source/texk/mendexk/Makefile.am +++ b/Build/source/texk/mendexk/Makefile.am @@ -39,14 +39,14 @@ dist_man1_MANS = mendex.1 EXTRA_DIST = \ COPYRIGHT \ - COPYRIGHT.jis \ - ChangeLog.jis + COPYRIGHT.ja \ + ChangeLog.ja ## Eventually delete these files ## EXTRA_DIST += \ indexsty \ - mendex.doc + mendex.doc mendex.1 mendex.1.ja ## Tests ## diff --git a/Build/source/texk/mendexk/mendex.1 b/Build/source/texk/mendexk/mendex.1 index 6ba8957f6eb..3e388c1ef92 100644 --- a/Build/source/texk/mendexk/mendex.1 +++ b/Build/source/texk/mendexk/mendex.1 @@ -1,416 +1,481 @@ -.if t .ds TX "T\h'-.15m'\v'.2v'E\v'-.2v'\h'-.12m'X -.if t .ds LX L\v'-.22m'a\v'.22m'T\h'-.1667m'\v'.22m'E\h'-.125m'\v'-.22m'X +.if t .ds TX T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X +.if t .ds LX L\\h'-0.36m'\\v'-0.15v'\\s-2A\\s+2\\h'-0.15m'\\v'0.15v'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X .TH MENDEX L -.SH 名称 -mendex \- 索引整形ツール -.SH 使用法 -\fBmendex\fR [-ilqrcgEJSU] [\fB-s\fI sty\fR] [\fB-d\fI dic\fR] [\fB-o\fI ind\fR] [\fB-d\fI dic\fR] [\fB-t\fI log\fR] [\fB-p\fI no\fR] [\fB-I\fI enc\fR] [\fB--\fR] [\fI idx0 idx1 idx2 ...\fR] -.SH 解説 +.SH NAME +mendex \- Japanese index processor +.SH SYNOPSIS +\fBmendex\fR [-ilqrcgfEJSU] [\fB-s\fI sty\fR] [\fB-d\fI dic\fR] [\fB-o\fI ind\fR] [\fB-t\fI log\fR] [\fB-p\fI no\fR] [\fB-I\fI enc\fR] [\fB--help\fR] [\fB--\fR] [\fI idx0 idx1 idx2 ...\fR] +.SH DESCRIPTION .PP -\fImendex\fR は文書の索引を作成するツールです。 LaTeX により抽出された索引リストファイル(\fI.idx\fR)を並べ替え、実際の索引のソースファイルの形に整形します。 \fImakeindex\fR と互換性があり、さらに「読み」の扱いの手間を減らすように特殊化されています。 +The program \fImendex\fR is a general purpose hierarchical index generator; +it accepts one or more input files (\fI.idx\fR; often produced by a text +formatter such as \*(LX), sorts the entries, and produces an output file +which can be formatted. It is almost compatible with \fImakeindex\fR, and +additional feature for handling readings of kanji words is also available. .RE -出力される索引の形式は、スタイルファイルに従って決定されます。また、辞書ファイルを与えることにより、索引中の熟語の読みが登録されます。 +The formats of the input and output files are specified in a style file. +The readings of kanji words can be specified in a dictionary file. .RE -索引の階層は3段階まで作成することができます。 -.SH オプション +The index can have up to three levels (0, 1, and 2) of subitem nesting. +.SH OPTIONS .PP .TP 10 \fB-i\fR -索引リストファイルが指定されている場合でも、標準入力を索引リストとして使用します。 +Take input from stdin, even when index files are specified. .TP 10 \fB-l\fR -索引のソートを文字順で行います。指定されなければ単語順のソートになります(ソート方法については後述)。 +Set \'sort by character order\'. By default, \'sort by word order\' is used. +Details are described below. .TP 10 \fB-q\fR -静粛モードです。エラーおよび警告以外は標準エラー出力に出力しません。 +Quiet mode; send no message to \fIstderr\fR, except error +messages and warnings. .TP 10 \fB-r\fR -ページ範囲表現を無効にします。指定しないと、連続して出てくる索引については "1--5" のようにページ範囲で表現されます。 +Disable implicit page range formation. By default, three or +more successive pages are automatically abbreviated as a range +(e.g. 1\(en5). .TP 10 \fB-c\fR -スペースやタブといったブランクを短縮して、すべて1個の半角スペースにします。また、前後のブランクは削除されます。 +Compress sequence of intermediate blanks (space(s) and/or tab(s)) into a space +and ignore leading and trailing blank(s). +By default, blanks in the index key are retained. .TP 10 \fB-g\fR -日本語の頭文字の区切りを "あかさた・・・わ" にします。指定しないと "あいうえ・・・わをん" になります。 +Make Japanese index head \fIA\fR-line (\fIA, Ka, Sa, ...\fR) of the gojuon table (Japanese +syllabary). By default, all the characters in the gojuon table +are used. .TP 10 \fB-f\fR -辞書ファイルにない漢字も強制的に出力するモードです。 +Force to output Kanji characters even non-existent in dictionaries. .TP 10 \fB-s\fI sty\fR -\fIsty\fR ファイルをスタイルファイルと見なします。スタイルファイルを指定しなければ、デフォルトの索引形式で作成します。 +Employ \fIsty\fR as the style file. .TP 10 \fB-d\fI dic\fR -\fIdic\fR ファイルを辞書ファイルと見なします。辞書ファイルは日本語の <\fI熟語\fR\ \fI読み\fR> のリストで構成されます。 +Employ \fIdic\fR as the dictionary file. The dictionary file is +composed of lists of <\fIindex_word\fR\ \fIreading\fR>. .TP 10 \fB-o\fI ind\fR -\fIind\fR ファイルを出力ファイルと見なします。指定がない場合は最初の入力ファイルの拡張子を.indとしたもの、入力ファイルが標準入力のみであれば標準出力に出力します。 +Employ \fIind\fR as the output index file. By default, the file +name is created by appending the extension \fIind\fR to the base +name of the first input file. .TP 10 \fB-t\fI log\fR -\fIlog\fR ファイルをログファイルと見なします。指定がない場合は最初の入力ファイルの拡張子を.ilgとしたもの、入力ファイルが標準入力のみであれば標準エラー出力のみに出力されます。 +Employ \fIlog\fR as the transcript file. By default, the file name +is created by appending the extension \fIilg\fR to the base name +of the first input file. .TP 10 \fB-p\fI no\fR -\fIno\fR を索引ページの先頭ページとして指定します。また、TeXの.log ファイルを参照することにより \fIany\fR(最終ページの次のページから)、\fIodd\fR(最終ページの次の奇数ページから)、\fIeven\fR(最終ページの次の偶数ページから)といった指定の仕方も可能です。 +Set the starting page number of the output index list to be +\fIno\fR. The argument \fIno\fR may be numerical or one of +the following: \fIany\fR (the next page to the end of contents), \fIodd\fR +(the next odd page to the end of contents), \fIeven\fR (the next even page to the end of contents). .TP 10 \fB-E\fR -漢字コードをEUCに指定します。入力ファイル、出力ファイルともEUCとして扱います。 +Set input/output kanji encoding to EUC-JP. .TP 10 \fB-J\fR -漢字コードをJISに指定します。入力ファイル、出力ファイルともJISとして扱います。 +Set input/output kanji encoding to JIS (ISO-2022-JP). .TP 10 \fB-S\fR -漢字コードをShiftJISに指定します。入力ファイル、出力ファイルともShiftJISとして扱います。 +Set input/output kanji encoding to Shift_JIS. .TP 10 \fB-U\fR -漢字コードをUTF-8に指定します。入力ファイル、出力ファイルともUTF-8として扱います。 +Set input/output kanji encoding to UTF-8. .TP 10 \fB-I\fI enc\fR -内部バッファのコードを\fIenc\fR に指定します。\fIenc\fR には \fIeuc\fR(EUC-JP) または \fIutf8\fR(UTF-8)が指定可能です。 +Set internal encoding to \fIenc\fR. The argument \fIenc\fR +may be \fIeuc\fR (EUC-JP) or \fIutf8\fR (UTF-8). +The normal default is set to \fIeuc\fR, but the default is changed to \fIutf8\fR +when the option \fB-U\fR is specified explicitly. +.TP 10 +\fB--help\fR +Show summary of options. .TP 10 \fB--\fR -以降はオプション文字列と解釈しません。 +Arguments after \fB--\fR are not taken as options. +.SH "STYLE FILE" +The style file informs \fImendex\fR about the format of the +\fIidx\fR input files and the intended format of the final +output file. The format is upper compatible with the one for +\fImakeindex\fR. The style file contains a list of +<\fIspecifier\fR\ \fIattribute\fR> pairs. +There are two types of specifiers: input and output. +Pairs do not have to appear in any particular order. +A line begun by \'%\' is a comment. -.SH スタイルファイル -スタイルファイルは makeindex のものと上位互換です。 形式は <\fIスタイルパラメータ\fR\ \fI引数\fR> のリストで構成されます。パラメータの順序は自由です。 -以下にスタイルパラメータの一覧を示します。 -`%'以降はコメントと見なされます。 .PP -\fB 入力ファイルスタイルパラメータ\fR +\fBInput file style parameter\fR .TP 30 -\fBkeyword\fR <文字列> +\fBkeyword\fR <string> "\\\\indexentry" .RS -索引エントリを引数として持つコマンド。 +Command with an argument of index entry. .RE .TP 30 -\fBarg_open\fR <文字> +\fBarg_open\fR <char> \'{\' .RS -索引エントリ文字列開始を表す文字。 +Opening delimiter which shows the beginning of index entry. .RE .TP 30 -\fBarg_close\fR <文字> +\fBarg_close\fR <char> \'}\' .RS -索引エントリ文字列終了を表す文字。 +Closing delimiter which shows the end of index entry. .RE .TP 30 -\fBrange_open\fR <文字> +\fBrange_open\fR <char> \'(\' .RS -ページ範囲の開始を示す文字。 +Opening delimiter which shows the beginning of page range. .RE .TP 30 -\fBrange_close\fR <文字> +\fBrange_close\fR <char> \')\' .RS -ページ範囲の終了を示す文字。 +Closing delimiter which shows the end of page range. .RE .TP 30 -\fBlevel\fR <文字> +\fBlevel\fR <char> \'!\' .RS -従属レベルであることを示す文字。 +Delimiter which shows lower level. .RE .TP 30 -\fBactual\fR <文字> +\fBactual\fR <char> \'@\' .RS -このシンボルに続く文字列が実際の索引文字列として出力ファイルに書かれる。 +Symbol which shows the next sequence is to appear as index strings +in the output file. .RE .TP 30 -\fBencap\fR <文字> +\fBencap\fR <char> \'|\' .RS -このシンボルに続く文字列が、ページ番号に付くコマンド名として使われる。 +Symbol which shows the next sequence is to be used as command name +attached to the page number. .RE .TP 30 -\fBpage_compositor\fR <文字列> +\fBpage_compositor\fR <string> "-" .RS -階層化されたページ番号における階層間の区切り文字。 +Separator between page levels for a style with multi-levels of page numbers. .RE .TP 30 -\fBpage_precedence\fR <文字列> +\fBpage_precedence\fR <string> "rnaRA" .RS -ページ番号の記法の優先順位。\'R\'および\'r\'はローマ数字、\'n\'はアラビア数字、\'A\'および\'a\'はアルファベットによる記法を表す。 +Priority of expression for page number. +\'R\' and \'r\' correspond to Roman. \'n\' corresponds to arabic numeral. +\'A\' and \'a\' correspond to Latin alphabet. .RE .TP 30 -\fBquote\fR <文字> +\fBquote\fR <char> \'"\' .RS -mendexのパラメータ文字に対するエスケープキャラクタ。 +Escape character for \fImendex\fR parameters. .RE .TP 30 -\fBescape\fR <文字> +\fBescape\fR <char> \'\\\\\' .RS -一般的な文字に対するエスケープキャラクタ。 +Escape character for general scripts. .RE -\fB 出力ファイルスタイルパラメータ\fR - -\fBpreamble\fR <文字列> +\fBOutput file style parameter\fR +.TP 30 +\fBpreamble\fR <string> "\\\\begin{theindex}\\n" .RS -出力ファイルの文字列。 +Preamble of output file. .RE .TP 30 -\fBpostamble\fR <文字列> +\fBpostamble\fR <string> "\\n\\n\\\\end{theindex}\\n" .RS -出力ファイルの末尾の文字列。 +Postamble of output file. .RE .TP 30 -\fBsetpage_prefix\fR <文字列> +\fBsetpage_prefix\fR <string> "\\n \\\\setcounter{page}{" .RS -開始ページを設定するときの、ページ番号の前に付ける文字列。 +Prefix of page number if start page is designated. .RE .TP 30 -\fBsetpage_suffix\fR <文字列> +\fBsetpage_suffix\fR <string> "}\\n" .RS -開始ページを設定するときの、ページ番号の後に付ける文字列。 +Suffix of page number if start page is designated. .RE .TP 30 -\fBgroup_skip\fR <文字列> -"\\n\\n \\\\indexsapce\\n" +\fBgroup_skip\fR <string> +"\\n\\n \\\\indexspace\\n" .RS -新項目(頭文字)の前に挿入する縦スペースを表す文字列。 +Strings to insert vertical space before new section of index. .RE .TP 30 -\fBlethead_prefix\fR <文字列> +\fBlethead_prefix\fR <string> "" .RS -頭文字の前に付けるコマンド文字列。 +Prefix of heading for newly appeared heading letter. .RE .TP 30 -\fBheading_prefix\fR <文字列> +\fBheading_prefix\fR <string> "" .RS -lethead_prefixと同じ。 +Same as \fBlethead_prefix\fR. .RE .TP 30 -\fBlethead_suffix\fR <文字列> +\fBlethead_suffix\fR <string> "" .RS -頭文字の後に付けるコマンド文字列。 +Suffix of heading for newly appeared heading letter. .RE .TP 30 -\fBheading_suffix\fR <文字列> +\fBheading_suffix\fR <string> "" .RS -lethead_suffixと同じ。 +Same as \fBlethead_suffix\fR. .RE .TP 30 -\fBlethead_flag\fR <文字列> +\fBlethead_flag\fR <string> 0 .RS -頭文字の出力のフラグ。0のとき出力しない。0より大きいときは英字を大文字で、0より小さいときは小文字で出力する。 +Flag to control output of heading letters. +\'0\', \'1\' and \'-1\' respectively denotes no output, uppercase and lowercase. .RE .TP 30 -\fBheading_flag\fR <文字列> +\fBheading_flag\fR <string> 0 .RS -lethead_flagと同じ。 +Same as \fBlethead_flag\fR. .RE .TP 30 -\fBitem_0\fR <文字列> +\fBitem_0\fR <string> "\\n \\\\item " .RS -主エントリ間に挿入するコマンド。 +Command sequence inserted between primary level entries. .RE .TP 30 -\fBitem_1\fR <文字列> +\fBitem_1\fR <string> "\\n \\\\subitem " .RS -サブエントリ間に挿入するコマンド。 +Command sequence inserted between sub level entries. .RE .TP 30 -\fBitem_2\fR <文字列> +\fBitem_2\fR <string> "\\n \\\\subsubitem " .RS -サブサブエントリ間に挿入するコマンド。 +Command sequence inserted between subsub level entries. .RE .TP 30 -\fBitem_01\fR <文字列> +\fBitem_01\fR <string> "\\n \\\\subitem " .RS -主〜サブエントリ間に挿入するコマンド。 +Command sequence inserted between primaly and sub level entries. .RE .TP 30 -\fBitem_x1\fR <文字列> +\fBitem_x1\fR <string> "\\n \\\\subitem " .RS -主〜サブエントリ間に挿入するコマンド。(主エントリにページ番号がないとき) +Command sequence inserted between primary and sub level entries +when main entry does not have page number. .RE .TP 30 -\fBitem_12\fR <文字列> +\fBitem_12\fR <string> "\\n \\\\subsubitem " .RS -サブ〜サブサブエントリ間に挿入するコマンド。 +Command sequence inserted between sub and subsub level entries. .RE .TP 30 -\fBitem_x2\fR <文字列> +\fBitem_x2\fR <string> "\\n \\\\subsubitem " .RS -サブ〜サブサブエントリ間に挿入するコマンド。(サブエントリにページ番号がないとき) +Command sequence inserted between sub and subsub level entries +when sub level entry does not have page number. .RE .TP 30 -\fBdelim_0\fR <文字列> +\fBdelim_0\fR <string> ", " .RS -主エントリと最初のページ番号の間の区切り文字列。 +Delimiter string between primary level entry and first page number. .RE .TP 30 -\fBdelim_1\fR <文字列> +\fBdelim_1\fR <string> ", " .RS -サブエントリと最初のページ番号の間の区切り文字列。 +Delimiter string between sub level entry and first page number. .RE .TP 30 -\fBdelim_2\fR <文字列> +\fBdelim_2\fR <string> ", " .RS -サブサブエントリと最初のページ番号の間の区切り文字列。 +Delimiter string between subsub level entry and first page number. .RE .TP 30 -\fBdelim_n\fR <文字列> +\fBdelim_n\fR <string> ", " .RS -ページ番号間の区切り文字列。どのエントリレベルにも共通。 +Delimiter string between page numbers +commonly used for any entry level. .RE .TP 30 -\fBdelim_r\fR <文字列> +\fBdelim_r\fR <string> "--" .RS -ページ範囲を示すときの、ページ番号間の区切り文字列。 +Delimiter string between pages to show page range. .RE .TP 30 -\fBdelim_t\fR <文字列> +\fBdelim_t\fR <string> "" .RS -ページ番号のリストの終端に出力する文字列。 +Delimiter string output at the end of page number list. .RE .TP 30 -\fBsuffix_2p\fR <文字列> +\fBsuffix_2p\fR <string> "" .RS -ページ番号が2ページ連続する場合に、delim_n と2ページ目の番号の代わりに付加する文字列。 +String to be inserted in place of \fBdelim_n\fR and the next page +number when the two pages are contiguous. .RE -文字列が定義されている場合にのみ有効。 +It works only when the parameter is defined. .RE .TP 30 -\fBsuffix_3p\fR <文字列> +\fBsuffix_3p\fR <string> "" .RS -ページ番号が3ページ連続する場合に、delim_r と3ページ目の番号の代わりに付加する文字列。suffix_mp より優先される。 +String to be inserted in place of \fBdelim_r\fR and the last page +number when the three pages are contiguous. +The parameter is prior to \fBsuffix_mp\fR. .RE -文字列が定義されている場合にのみ有効。 +It works only when the parameter is defined. .RE .TP 30 -\fBsuffix_mp\fR <文字列> +\fBsuffix_mp\fR <string> "" .RS -ページ番号が3ページまたはそれ以上連続する場合に、delim_r と末尾のページ番号の代わりに付加する文字列。 +String to be inserted in place of \fBdelim_r\fR and the last page +number when the three or more pages are contiguous. .RE -文字列が定義されている場合にのみ有効。 +It works only when the parameter is defined. .RE .TP 30 -\fBencap_prefix\fR <文字列> +\fBencap_prefix\fR <string> "\\\\" .RS -ページ番号にコマンドを付けるときの、コマンド名の前に付ける文字列。 +Prefix for an encapsulating command +when the encapsulating command is added to the page number. .RE .TP 30 -\fBencap_infix\fR <文字列> +\fBencap_infix\fR <string> "{" .RS -ページ番号にコマンドを付けるときの、ページ番号の前に付ける文字列。 +Prefix just before the page number +when the encapsulating command is added to the page number. .RE .TP 30 -\fBencap_suffix\fR <文字列> +\fBencap_suffix\fR <string> "}". .RS -ページ番号にコマンドを付けるときの、ページ番号の後に付ける文字列。 +Suffix after the page number +when the encapsulating command is added to the page number. .RE .TP 30 -\fBline_max\fR <数値> +\fBline_max\fR <number> 72 .RS -1行の最大文字数。それを超えると折り返す。 +Maximum number of one line. +If exceed the number, lines are folded. .RE .TP 30 -\fBindent_space\fR <文字列> +\fBindent_space\fR <string> "\t\t" .RS -折り返した行の頭に挿入するスペース。 +Space for indent which inserted to +top of folded line. .RE .TP 30 -\fBindent_length\fR <数値> +\fBindent_length\fR <number> 16 .RS -折り返した行の頭に挿入されるスペースの長さ。 +Length of space for indent which inserted to top of folded line. .RE .TP 30 -\fBsymhead_positive\fR <文字列> +\fBsymhead_positive\fR <string> "Symbols" .RS -lethead_flag または heading_flag が正数の場合に数字・記号の頭文字として出力する文字列。 +Strings to output as heading letter for numbers and symbols +when lethead_flag or heading_flag is positive number. .RE .TP 30 -\fBsymhead_negative\fR <文字列> +\fBsymhead_negative\fR <string> "symbols" .RS -lethead_flag または heading_flag が負数の場合に数字・記号の頭文字として出力する文字列。 +Strings to output as heading letter for numbers and symbols +when lethead_flag or heading_flag is negative number. .RE .TP 30 -\fBsymbol\fR <文字列> +\fBsymbol\fR <string> "" .RS -symbol_flag が0でない場合に、数字・記号の頭文字として出力する文字列。 +Strings to output as heading letter for numbers and symbols +when symbol_flag is non zero. .RE -文字列が定義されていれば、symhead_positive および symhead_negative より優先される。(mendex専用) -.RE -このパラメータが定義された場合、symhead_positive および symhead_negative より優先される。(mendex専用) +If specified, the option is prior to symhead_positive and symhead_negative. +(Extended by mendex) .RE .TP 30 -\fBsymbol_flag\fR <数値> +\fBsymbol_flag\fR <number> 1 .RS -数字・記号の頭文字の出力フラグ。0のとき出力しない。(mendex専用) +Flag to output of symbol. If \'0\', do not output. +(Extended by mendex) .RE .TP 30 -\fBletter_head\fR <数値> +\fBletter_head\fR <number> 1 .RS -日本語の頭文字の出力のフラグ。1のときカタカナ、2のときひらがなで出力する。(mendex専用) +Flag of heading letter for Japanese Kana. +If \'1\' and \'2\', Katakana and Hiragana is used, respectively. +(Extended by mendex) .RE .TP 30 -\fBpriority\fR <数値> +\fBpriority\fR <number> 0 .RS -英字と日本語との混在した索引語のソート方法についてのフラグ。0でなければ英字と日本語との間に半角スペースを入れた状態でソートする。(mendex専用) +Flag of sorting method for index words composed of +Japanese and non-Japanese (ex. Latin scripts). +If non zero, one space (U+20) is inserted between +Japanese sequence and non-Japanese sequence in sorting procedure. +(Extended by mendex) .RE .TP 30 -\fBcharacter_order\fR <文字列> +\fBcharacter_order\fR <string> "SEJ" .RS -記号、英字、日本語の優先順位。\'S\'は記号、\'E\'は英字、\'J\'は日本語を表す。(mendex専用) +Order of scripts and symbols. +\'S\', \'E\' and \'J\' respectively denotes symbol, English and Japanese. +(Extended by mendex) .RE .PP -.SH 日本語の扱いについて +.SH ABOUT JAPANESE PROCESSING .PP -\fImendex\fR は日本語の索引をできるだけ楽に扱えるようになっています。 +\fImendex\fR has an additional feature to simplify the procedure of handling +Japanese indexes, compared to \fImakeindex\fR. Users can save the effort +of manually specifying a reading for every kanji word. .RE -makeindexでは日本語の索引が正しく辞書順にソートするためにはひらがなまたはカタカナに揃え、拗音、撥音、濁点を除いた読みを付けなければなりませんでした(自動的に揃えるバージョンもある)。 +Japanese kanji words are usually sorted by the syllables of their readings +(\fI\'Yomi\'\fR), which can be represented by kana (Hiragana, Katakana) scripts. +\fImendex\fR accepts index words specified in kana expression directly on +an input file, and also accepts conversion from index words to kana scripts +by referring to Japanese dictionaries. .RE -mendexではカナについてはすべて自動的に揃え、また漢字については辞書ファイルを設定することにより各索引語ごとに読みを付ける作業をかなり解消できます。 .LP -以下に内部でのカナの変換例を示します。 +Examples of internal simplification of syllables are shown below. .PP .RS .br @@ -418,13 +483,15 @@ mendexではカナについてはすべて自動的に揃え、また漢字に .br マッキントッシュ まつきんとつしゆ .br -ワープロ わあふろ +ワープロ わあふろ .RE .LP -辞書ファイルは<\fI熟語\ \ 読み\fR>のリストで構成されます。 -熟語と読みの区切りはタブまたはスペースです。 +The dictionary file consists of list with <\'index_word\' \'reading\'>. +The index word can be written in any scripts (kanji, kana, etc), +and the reading must be in Hiragana or Katakana scripts. +The delimiter between the index word and its reading is one or more tab(s) or space(s). .RE -以下に辞書の例を示します。 +An example of a Japanese dictionary is shown below. .PP .RS .br @@ -437,33 +504,45 @@ mendexではカナについてはすべて自動的に揃え、また漢字に α アルファ .RE .LP -辞書に登録する熟語については、読み方が1通りになるよう送り仮名を付けてください。 -「表」、「性質」のように送り仮名によらず2通りの読み方ができる語についてはどちらか1つしか登録できません。他の読み方については各索引語へ読みを付けることで対応してください。 -.RE -また、環境変数<\fIINDEXDEFAULTDICTIONARY\fR>に辞書ファイルを登録することにより、自動的に辞書を参照します。環境変数に登録した辞書は -d で指定した辞書と併用できます。 +Here, each index word is allowed to have only one Yomi. +Though some kanji words (ex. 「表」) may have more than one Yomi\'s +(ex. 「ひょう」 and 「おもて」), only one of them can be registered in the dictionary. +When some different Yomi\'s are needed, they should be specified explicitly +in kana expression (ex. \\index{ひょう@表} or \\index{おもて@表}) on the input file. +.RE +Moreover, a dictionary file is automatically referred +by setting the file name at an environment variable \fIINDEXDEFAULTDICTIONARY\fR. +The dictionary set by the environment variable can be used +together with file(s) specified by \fI-d\fR option. .PP -.SH ソート方法について +.SH ABOUT SORTING PROCEDURE .PP -\fImendex\fR は通常は入力された索引語をそのままソートします。\fI-l\fRオプションが付けられた場合、複数の単語で構成される索引語については、ソートするときに単語と単語の間のスペースを詰めてソートします。 -ここでは前者を単語順ソート、後者を文字順ソートと呼ぶことにします。 +\fImendex\fR sorts indexes as is (\'sort by word order\') by default. +Setting \fI-l\fR option, spaces between words in an index are truncated prior to +sorting procedure (\'sort by character order\'). .RE -文字順ソートの場合、実際に出力される文字列はスペースを含んだ状態のものですので、索引語自体が変化することはありません。 +Even when sort by character order, the index at output remains the original sequence +without the truncation. .RE -以下に例を示します。 +Follows show an example. .PP .RS -\fI単語順ソート 文字順ソート\fR +\fIsort by word order sort by character order\fR .br -X Window Xlib +X Window Xlib .br -Xlib XView +Xlib XView .br XView X Window .RE .LP -また、日本語〜英字間でも似たようなソート方法があります。スタイルファイルで\fIpriority\fRを0以外に指定した場合、隣接した日本語と英字の間にスペースを入れてソートします。 +In addition, two sorting methods can be applied for indexes +which contains both Japanese kana and other scripts (e.g. Latin script). +By setting \fIpriority\fR 0 (default) and 1 at a style file, +a space between Japanese Kana and other scripts is inserted and +not inserted respectively, prior to the sorting procedure. .RE -以下に例を示します。 +Follows show an example. .PP .RS \fIpriority=0 priority=1\fR @@ -473,28 +552,31 @@ index sort indファイル indファイル index sort .RE .PP -.SH 環境変数 -\fImendex\fR では以下のような環境変数を使用しています。 +.SH ENVIRONMENT VARIABLES +\fImendex\fR refers environment variables as follows. .PP .TP 10 \fIINDEXSTYLE\fR -索引スタイルファイルがあるディレクトリ +Directory where index style files exist. .TP 10 \fIINDEXDEFAULTSTYLE\fR -デフォルトで参照する索引スタイルファイル +Index style file to be referred to as default. .TP 10 \fIINDEXDICTIONARY\fR -辞書があるディレクトリ +Directory where dictionary files exist. .TP 10 \fIINDEXDEFAULTDICTIONARY\fR -常に参照する辞書ファイル +Dictionary file which is automatically read. .PP -.SH 詳細について -その他、詳細については \fImakeindex\fR に準拠。 +.SH DETAIL +Detailed specification is compatible with \fImakeindex\fR. .PP -.SH 問題点等 -複数のページ記法を使用する場合、ページ順に.idxファイルを与えないとページ番号を誤認することがあります。 +.SH KNOWN ISSUES +When plural page number expression is used, \fI.idx\fR files should be +specified along with the order of page numbers. Otherwise, +wrong page numbers might be output. .PP -.SH 参照 +.SH "SEE ALSO" tex(l), latex(l), makeindex(l) -.RE +.SH AUTHOR +This manual page was written by Japanese \*(TX Development Community. diff --git a/Build/source/texk/mendexk/mendex.1.ja b/Build/source/texk/mendexk/mendex.1.ja new file mode 100644 index 00000000000..c182c1bdf23 --- /dev/null +++ b/Build/source/texk/mendexk/mendex.1.ja @@ -0,0 +1,502 @@ +.if t .ds TX T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X +.if t .ds LX L\\h'-0.36m'\\v'-0.15v'\\s-2A\\s+2\\h'-0.15m'\\v'0.15v'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X +.TH MENDEX L +.SH 名称 +mendex \- 索引整形ツール +.SH 使用法 +\fBmendex\fR [-ilqrcgfEJSU] [\fB-s\fI sty\fR] [\fB-d\fI dic\fR] [\fB-o\fI ind\fR] [\fB-t\fI log\fR] [\fB-p\fI no\fR] [\fB-I\fI enc\fR] [\fB--help\fR] [\fB--\fR] [\fI idx0 idx1 idx2 ...\fR] +.SH 解説 +.PP +\fImendex\fR は文書の索引を作成するツールです。 LaTeX により抽出された索引リストファイル(\fI.idx\fR)を並べ替え、実際の索引のソースファイルの形に整形します。 \fImakeindex\fR と互換性があり、さらに「読み」の扱いの手間を減らすように特殊化されています。 +.RE +出力される索引の形式は、スタイルファイルに従って決定されます。また、辞書ファイルを与えることにより、索引中の熟語の読みが登録されます。 +.RE +索引の階層は3段階まで作成することができます。 +.SH オプション +.PP +.TP 10 +\fB-i\fR +索引リストファイルが指定されている場合でも、標準入力を索引リストとして使用します。 +.TP 10 +\fB-l\fR +索引のソートを文字順で行います。指定されなければ単語順のソートになります(ソート方法については後述)。 +.TP 10 +\fB-q\fR +静粛モードです。エラーおよび警告以外は標準エラー出力に出力しません。 +.TP 10 +\fB-r\fR +ページ範囲表現を無効にします。指定しないと、連続して出てくる索引については "1--5" のようにページ範囲で表現されます。 +.TP 10 +\fB-c\fR +スペースやタブといったブランクを短縮して、すべて1個の半角スペースにします。また、前後のブランクは削除されます。 +.TP 10 +\fB-g\fR +日本語の頭文字の区切りを "あかさた・・・わ" にします。指定しないと "あいうえ・・・わをん" になります。 +.TP 10 +\fB-f\fR +辞書ファイルにない漢字も強制的に出力するモードです。 +.TP 10 +\fB-s\fI sty\fR +\fIsty\fR ファイルをスタイルファイルと見なします。スタイルファイルを指定しなければ、デフォルトの索引形式で作成します。 +.TP 10 +\fB-d\fI dic\fR +\fIdic\fR ファイルを辞書ファイルと見なします。辞書ファイルは日本語の <\fI熟語\fR\ \fI読み\fR> のリストで構成されます。 +.TP 10 +\fB-o\fI ind\fR +\fIind\fR ファイルを出力ファイルと見なします。指定がない場合は最初の入力ファイルの拡張子を.indとしたもの、入力ファイルが標準入力のみであれば標準出力に出力します。 +.TP 10 +\fB-t\fI log\fR +\fIlog\fR ファイルをログファイルと見なします。指定がない場合は最初の入力ファイルの拡張子を.ilgとしたもの、入力ファイルが標準入力のみであれば標準エラー出力のみに出力されます。 +.TP 10 +\fB-p\fI no\fR +\fIno\fR を索引ページの先頭ページとして指定します。また、TeXの.log ファイルを参照することにより \fIany\fR(最終ページの次のページから)、\fIodd\fR(最終ページの次の奇数ページから)、\fIeven\fR(最終ページの次の偶数ページから)といった指定の仕方も可能です。 +.TP 10 +\fB-E\fR +漢字コードをEUC-JPに指定します。入力ファイル、出力ファイルともEUC-JPとして扱います。 +.TP 10 +\fB-J\fR +漢字コードをJIS (ISO-2022-JP)に指定します。入力ファイル、出力ファイルともJISとして扱います。 +.TP 10 +\fB-S\fR +漢字コードをShift_JISに指定します。入力ファイル、出力ファイルともShift_JISとして扱います。 +.TP 10 +\fB-U\fR +漢字コードをUTF-8に指定します。入力ファイル、出力ファイルともUTF-8として扱います。 +.TP 10 +\fB-I\fI enc\fR +内部バッファのコードを\fIenc\fR に指定します。\fIenc\fR には \fIeuc\fR (EUC-JP) または \fIutf8\fR (UTF-8)が指定可能です。 +このオプションが指定されていない場合のデフォルト値は \fIeuc\fR ですが、オプション \fB-U\fR が明示的に指定されている場合は \fIutf8\fR となります。 +.TP 10 +\fB--help\fR +オプションの要約を表示します。 +.TP 10 +\fB--\fR +以降はオプション文字列と解釈しません。 + + +.SH スタイルファイル +スタイルファイルは makeindex のものと上位互換です。 形式は <\fIスタイルパラメータ\fR\ \fI引数\fR> のリストで構成されます。パラメータの順序は自由です。 +以下にスタイルパラメータの一覧を示します。 +`%'以降はコメントと見なされます。 +.PP +\fB 入力ファイルスタイルパラメータ\fR +.TP 30 +\fBkeyword\fR <文字列> +"\\\\indexentry" +.RS +索引エントリを引数として持つコマンド。 +.RE +.TP 30 +\fBarg_open\fR <文字> +\'{\' +.RS +索引エントリ文字列開始を表す文字。 +.RE +.TP 30 +\fBarg_close\fR <文字> +\'}\' +.RS +索引エントリ文字列終了を表す文字。 +.RE +.TP 30 +\fBrange_open\fR <文字> +\'(\' +.RS +ページ範囲の開始を示す文字。 +.RE +.TP 30 +\fBrange_close\fR <文字> +\')\' +.RS +ページ範囲の終了を示す文字。 +.RE +.TP 30 +\fBlevel\fR <文字> +\'!\' +.RS +従属レベルであることを示す文字。 +.RE +.TP 30 +\fBactual\fR <文字> +\'@\' +.RS +このシンボルに続く文字列が実際の索引文字列として出力ファイルに書かれる。 +.RE +.TP 30 +\fBencap\fR <文字> +\'|\' +.RS +このシンボルに続く文字列が、ページ番号に付くコマンド名として使われる。 +.RE +.TP 30 +\fBpage_compositor\fR <文字列> +"-" +.RS +階層化されたページ番号における階層間の区切り文字。 +.RE +.TP 30 +\fBpage_precedence\fR <文字列> +"rnaRA" +.RS +ページ番号の記法の優先順位。\'R\'および\'r\'はローマ数字、\'n\'はアラビア数字、\'A\'および\'a\'はアルファベットによる記法を表す。 +.RE +.TP 30 +\fBquote\fR <文字> +\'"\' +.RS +mendexのパラメータ文字に対するエスケープキャラクタ。 +.RE +.TP 30 +\fBescape\fR <文字> +\'\\\\\' +.RS +一般的な文字に対するエスケープキャラクタ。 +.RE + +\fB 出力ファイルスタイルパラメータ\fR +.TP 30 +\fBpreamble\fR <文字列> +"\\\\begin{theindex}\\n" +.RS +出力ファイルの文字列。 +.RE +.TP 30 +\fBpostamble\fR <文字列> +"\\n\\n\\\\end{theindex}\\n" +.RS +出力ファイルの末尾の文字列。 +.RE +.TP 30 +\fBsetpage_prefix\fR <文字列> +"\\n \\\\setcounter{page}{" +.RS +開始ページを設定するときの、ページ番号の前に付ける文字列。 +.RE +.TP 30 +\fBsetpage_suffix\fR <文字列> +"}\\n" +.RS +開始ページを設定するときの、ページ番号の後に付ける文字列。 +.RE +.TP 30 +\fBgroup_skip\fR <文字列> +"\\n\\n \\\\indexspace\\n" +.RS +新項目(頭文字)の前に挿入する縦スペースを表す文字列。 +.RE +.TP 30 +\fBlethead_prefix\fR <文字列> +"" +.RS +頭文字の前に付けるコマンド文字列。 +.RE +.TP 30 +\fBheading_prefix\fR <文字列> +"" +.RS +lethead_prefixと同じ。 +.RE +.TP 30 +\fBlethead_suffix\fR <文字列> +"" +.RS +頭文字の後に付けるコマンド文字列。 +.RE +.TP 30 +\fBheading_suffix\fR <文字列> +"" +.RS +lethead_suffixと同じ。 +.RE +.TP 30 +\fBlethead_flag\fR <文字列> +0 +.RS +頭文字の出力のフラグ。0のとき出力しない。0より大きいときは英字を大文字で、0より小さいときは小文字で出力する。 +.RE +.TP 30 +\fBheading_flag\fR <文字列> +0 +.RS +lethead_flagと同じ。 +.RE +.TP 30 +\fBitem_0\fR <文字列> +"\\n \\\\item " +.RS +主エントリ間に挿入するコマンド。 +.RE +.TP 30 +\fBitem_1\fR <文字列> +"\\n \\\\subitem " +.RS +サブエントリ間に挿入するコマンド。 +.RE +.TP 30 +\fBitem_2\fR <文字列> +"\\n \\\\subsubitem " +.RS +サブサブエントリ間に挿入するコマンド。 +.RE +.TP 30 +\fBitem_01\fR <文字列> +"\\n \\\\subitem " +.RS +主〜サブエントリ間に挿入するコマンド。 +.RE +.TP 30 +\fBitem_x1\fR <文字列> +"\\n \\\\subitem " +.RS +主〜サブエントリ間に挿入するコマンド。(主エントリにページ番号がないとき) +.RE +.TP 30 +\fBitem_12\fR <文字列> +"\\n \\\\subsubitem " +.RS +サブ〜サブサブエントリ間に挿入するコマンド。 +.RE +.TP 30 +\fBitem_x2\fR <文字列> +"\\n \\\\subsubitem " +.RS +サブ〜サブサブエントリ間に挿入するコマンド。(サブエントリにページ番号がないとき) +.RE +.TP 30 +\fBdelim_0\fR <文字列> +", " +.RS +主エントリと最初のページ番号の間の区切り文字列。 +.RE +.TP 30 +\fBdelim_1\fR <文字列> +", " +.RS +サブエントリと最初のページ番号の間の区切り文字列。 +.RE +.TP 30 +\fBdelim_2\fR <文字列> +", " +.RS +サブサブエントリと最初のページ番号の間の区切り文字列。 +.RE +.TP 30 +\fBdelim_n\fR <文字列> +", " +.RS +ページ番号間の区切り文字列。どのエントリレベルにも共通。 +.RE +.TP 30 +\fBdelim_r\fR <文字列> +"--" +.RS +ページ範囲を示すときの、ページ番号間の区切り文字列。 +.RE +.TP 30 +\fBdelim_t\fR <文字列> +"" +.RS +ページ番号のリストの終端に出力する文字列。 +.RE +.TP 30 +\fBsuffix_2p\fR <文字列> +"" +.RS +ページ番号が2ページ連続する場合に、delim_n と2ページ目の番号の代わりに付加する文字列。 +.RE +文字列が定義されている場合にのみ有効。 +.RE +.TP 30 +\fBsuffix_3p\fR <文字列> +"" +.RS +ページ番号が3ページ連続する場合に、delim_r と3ページ目の番号の代わりに付加する文字列。suffix_mp より優先される。 +.RE +文字列が定義されている場合にのみ有効。 +.RE +.TP 30 +\fBsuffix_mp\fR <文字列> +"" +.RS +ページ番号が3ページまたはそれ以上連続する場合に、delim_r と末尾のページ番号の代わりに付加する文字列。 +.RE +文字列が定義されている場合にのみ有効。 +.RE +.TP 30 +\fBencap_prefix\fR <文字列> +"\\\\" +.RS +ページ番号にコマンドを付けるときの、コマンド名の前に付ける文字列。 +.RE +.TP 30 +\fBencap_infix\fR <文字列> +"{" +.RS +ページ番号にコマンドを付けるときの、ページ番号の前に付ける文字列。 +.RE +.TP 30 +\fBencap_suffix\fR <文字列> +"}". +.RS +ページ番号にコマンドを付けるときの、ページ番号の後に付ける文字列。 +.RE +.TP 30 +\fBline_max\fR <数値> +72 +.RS +1行の最大文字数。それを超えると折り返す。 +.RE +.TP 30 +\fBindent_space\fR <文字列> +"\t\t" +.RS +折り返した行の頭に挿入するスペース。 +.RE +.TP 30 +\fBindent_length\fR <数値> +16 +.RS +折り返した行の頭に挿入されるスペースの長さ。 +.RE +.TP 30 +\fBsymhead_positive\fR <文字列> +"Symbols" +.RS +lethead_flag または heading_flag が正数の場合に数字・記号の頭文字として出力する文字列。 +.RE +.TP 30 +\fBsymhead_negative\fR <文字列> +"symbols" +.RS +lethead_flag または heading_flag が負数の場合に数字・記号の頭文字として出力する文字列。 +.RE +.TP 30 +\fBsymbol\fR <文字列> +"" +.RS +symbol_flag が0でない場合に、数字・記号の頭文字として出力する文字列。 +.RE +文字列が定義されていれば、symhead_positive および symhead_negative より優先される。(mendex専用) +.RE +.TP 30 +\fBsymbol_flag\fR <数値> +1 +.RS +数字・記号の頭文字の出力フラグ。0のとき出力しない。(mendex専用) +.RE +.TP 30 +\fBletter_head\fR <数値> +1 +.RS +日本語の頭文字の出力のフラグ。1のときカタカナ、2のときひらがなで出力する。(mendex専用) +.RE +.TP 30 +\fBpriority\fR <数値> +0 +.RS +英字と日本語との混在した索引語のソート方法についてのフラグ。0でなければ英字と日本語との間に半角スペースを入れた状態でソートする。(mendex専用) +.RE +.TP 30 +\fBcharacter_order\fR <文字列> +"SEJ" +.RS +記号、英字、日本語の優先順位。\'S\'は記号、\'E\'は英字、\'J\'は日本語を表す。(mendex専用) +.RE +.PP +.SH 日本語の扱いについて +.PP +\fImendex\fR は日本語の索引をできるだけ楽に扱えるようになっています。 +.RE +makeindexでは日本語の索引が正しく辞書順にソートするためにはひらがなまたはカタカナに揃え、拗音、撥音、濁点を除いた読みを付けなければなりませんでした(自動的に揃えるバージョンもある)。 +.RE +mendexではカナについてはすべて自動的に揃え、また漢字については辞書ファイルを設定することにより各索引語ごとに読みを付ける作業をかなり解消できます。 + +.LP +以下に内部でのカナの変換例を示します。 +.PP +.RS +.br +かぶしきがいしゃ かふしきかいしや +.br +マッキントッシュ まつきんとつしゆ +.br +ワープロ わあふろ +.RE +.LP +辞書ファイルは<\fI熟語\ \ 読み\fR>のリストで構成されます。 +熟語と読みの区切りはタブまたはスペースです。 +.RE +以下に辞書の例を示します。 +.PP +.RS +.br +漢字 かんじ +.br +読み よみ +.br +環境 かんきょう +.br +α アルファ +.RE +.LP +辞書に登録する熟語については、読み方が1通りになるよう送り仮名を付けてください。 +「表」、「性質」のように送り仮名によらず2通りの読み方ができる語についてはどちらか1つしか登録できません。他の読み方については各索引語へ読みを付けることで対応してください。 +.RE +また、環境変数<\fIINDEXDEFAULTDICTIONARY\fR>に辞書ファイルを登録することにより、自動的に辞書を参照します。環境変数に登録した辞書は -d で指定した辞書と併用できます。 +.PP +.SH ソート方法について +.PP +\fImendex\fR は通常は入力された索引語をそのままソートします。\fI-l\fRオプションが付けられた場合、複数の単語で構成される索引語については、ソートするときに単語と単語の間のスペースを詰めてソートします。 +ここでは前者を単語順ソート、後者を文字順ソートと呼ぶことにします。 +.RE +文字順ソートの場合、実際に出力される文字列はスペースを含んだ状態のものですので、索引語自体が変化することはありません。 +.RE +以下に例を示します。 +.PP +.RS +\fI単語順ソート 文字順ソート\fR +.br +X Window Xlib +.br +Xlib XView +.br +XView X Window +.RE +.LP +また、日本語〜英字間でも似たようなソート方法があります。スタイルファイルで\fIpriority\fRを0以外に指定した場合、隣接した日本語と英字の間にスペースを入れてソートします。 +.RE +以下に例を示します。 +.PP +.RS +\fIpriority=0 priority=1\fR +.br +index sort indファイル +.br +indファイル index sort +.RE +.PP +.SH 環境変数 +\fImendex\fR では以下のような環境変数を使用しています。 +.PP +.TP 10 +\fIINDEXSTYLE\fR +索引スタイルファイルがあるディレクトリ +.TP 10 +\fIINDEXDEFAULTSTYLE\fR +デフォルトで参照する索引スタイルファイル +.TP 10 +\fIINDEXDICTIONARY\fR +辞書があるディレクトリ +.TP 10 +\fIINDEXDEFAULTDICTIONARY\fR +常に参照する辞書ファイル +.PP +.SH 詳細について +その他、詳細については \fImakeindex\fR に準拠。 +.PP +.SH 問題点等 +複数のページ記法を使用する場合、ページ順に.idxファイルを与えないとページ番号を誤認することがあります。 +.PP +.SH 参照 +tex(l), latex(l), makeindex(l) +.RE diff --git a/Build/source/texk/mendexk/mendex.doc b/Build/source/texk/mendexk/mendex.doc index 442fa4916bb..9f84155c4a0 100644 --- a/Build/source/texk/mendexk/mendex.doc +++ b/Build/source/texk/mendexk/mendex.doc @@ -4,7 +4,7 @@ mendex - 索引整形ツール 使用法 - mendex [-ilqrcgEJSU] [-s sty] [-d dic] [-o ind] [-d dic] [-t log] [-p no] [-I enc] [--] [idx0 idx1 idx2 ...] + mendex [-ilqrcgfEJSU] [-s sty] [-d dic] [-o ind] [-t log] [-p no] [-I enc] [--help] [--] [idx0 idx1 idx2 ...] 解説 @@ -57,19 +57,22 @@ mendex - 索引整形ツール ジの次の奇数ページから)、even (最終ページの次の偶数ページから)といっ た指定も可能です。 - -E 漢字コードをEUCに指定します。 - 入力ファイル、出力ファイルともEUCとして扱います。 + -E 漢字コードをEUC-JPに指定します。 + 入力ファイル、出力ファイルともEUC-JPとして扱います。 - -J 漢字コードをJISに指定します。 + -J 漢字コードをJIS (ISO-2022-JP)に指定します。 入力ファイル、出力ファイルともJISとして扱います。 - -S 漢字コードをShiftJISに指定します。 - 入力ファイル、出力ファイルともShiftJISとして扱います。 + -S 漢字コードをShift_JISに指定します。 + 入力ファイル、出力ファイルともShift_JISとして扱います。 -U 漢字コードをUTF-8に指定します。 入力ファイル、出力ファイルともUTF-8として扱います。 - -I enc 内部バッファのコードをencに指定します。enc には euc (EUC-JP) または utf8 (UTF-8)が指定可能です。 + -I enc 内部バッファのコードをencに指定します。enc には euc (EUC-JP) または utf8 (UTF-8) が指定可能です。 + このオプションが指定されていない場合のデフォルト値は euc ですが、オプション -U が明示的に指定されている場合は utf8 となります。 + + --help オプションの要約を表示します。 -- 以降はオプション文字列と解釈しません。 |