                        Texinfo for Windows
                    --- texinfo-w32.tar.xz ---

[1] 始めに

これは，前に texinfotools-w32.tar.xz という名前のパッケージで配布して
いたものから，Windows で使用されることは，ほぼ無いと考えられる
deref.exe, install-info.exe, makeinfo.exe を除き，Texinfo をバージョン
6.7 にアプデートし，TeX engines によるTexinfoソースのタイプセッティング
だけをサポートしたものです。Texinfo 用インデックス作成プログラム 
texindex.exe は実際には wrapper であり，内部で森下 お代官様
ＭａＮＭＯＳ さんによるパッチ(texindex-japanese-patch)によって
Shift_JIS コード用に日本語化されたもの(ptexindex.exe と名前を変更して
あります)を実行しています。UTF-8 を Shift_JIS に変換してから ptexindex
を走らせ，結果を UTF-8 に戻しているわけですが，当然 Shift_JIS に変換
不可能なインデックスがあった場合，そのインデックスはタイプセットされ
ないと思われます。これは制限事項です。
この場合，日本語が含まれていない場合には，texi2pdf および texi2dvi の
オプション --awkindex によって，Texinfo に含まれるオリジナルの
texindex を使うことができます。これは awk スクリプトによるものです。
日本語がある場合にも使用できますが，\initial{} が正しくならないよう
です。殆どのTexinfo ファイルは，日本語を含んでいないので，通常
--awkindex オプションを使うのが最も安全かもしれません。

DVI モードで使用される texi2dvi.exe が使用するデフォルトのTeX engine
は etex ですが，環境変数TEX で変更できます。例えば cmd.exe のコマンド
プロンプトで

set TEX=eptex& texi2dvi --verbose filename.texi

とすると，engine として eptex が使用されます。

texi2dvi.exe が機能しない場合には

eptex foo.texi
eptex foo.texi
texindex foo.??
eptex foo.texi
eptex foo.texi

などとすればよいでしょう。完了していない旨のメッセージが出るよう
なら，適当にコマンドを繰り返して下さい。texi2dvi.exe は必要な回数を
自動判断するので，便利です。

PDF モードでは texi2pdf.exe を使います。 これは texi2dvi --pdf
と同等です。PDF モードのデフォルトのエンジンは pdftex ですが，
環境変数 PDFTEX で変更することができます。

[2] サポートする TeX engines

この Texinfo は tex, etex, pdftex, luatex, luahbtex, xetex, ptex, eptex
で動作します。 然し，e-TeX 拡張されていない, tex と ptex の場合は，
場合により texi2dvi.exe がうまく動作せず，無限ループに陥ることがある
ようなので，可能な限り tex と ptex は使わないようにして下さい。
代わりに etex と eptex を使うようにして下さい。
e-TeX 拡張されていない tex と ptex を使う理由は，現在ではありません。

(1) tex, etex
    dvi ドライバは dvips -> ps2pdf
    コマンドライン:
    set TEX=tex& texi2dvi --verbose filename.texi
    texi2dvi --verbose filename.texi
    など。
(2) pdftex
    dvi ドライバは内臓されるもの
    コマンドライン:
    texi2dvi --pdf --verbose filename.texi
    これと同じコマンドとして texi2pdf.exe を使うと
    texi2pdf --verbose filename.texi
    となります。
(3) luatex, luahbtex
    dvi ドライバは内臓されるもの
    コマンドライン:
    set PDFTEX=luatex& texi2pdf --verbose filename.texi
    set PDFTEX=luahbtex& texi2pdf --verbose filename.texi
    など。
(4) xetex
    dvi ドライバは xdvipdfmx。通常自動で使用される。
    -no-pdf オプションを使うときは，あとで xdvipdfmx にかける。
    コマンドライン:
    set PDFTEX=xetex& texi2pdf --verbose filename.texi
    など。
(5) ptex, eptex
    dvi ドライバは dvipdfmx。
    コマンドライン:
    set TEX=ptex& texi2dvi --verbose filename.texi
    set TEX=eptex& texi2dvi --verbose filename.texi
    など。

(1), (4), (5) の場合は，outline 等に ASCII backslash があると，
dvi ドライバをかけるとき，warnings があって，outline 等に文字化け
が現れることがあります。(5) の場合は，dvipdfmx にかける直前に

allow5c filename.dvi

とすると，殆どの場合この不具合が解消するはずです。

[3] 日本語のサポート

TeX エンジンが, xetex, luatex, luahbtex, ptex, eptex の場合には
日本語 Texinfo がサポートされます。ただしどの場合も日本語コード
は UTF-8 だけがサポートされます。Windows 用 ptex, eptex は新しい
ものは，デフォルトの input encoding が UTF-8 なので，オプション
が不要ですが，古い ptex, eptex の場合は -kanji=utf8 なるオプション
を付けないとだめです。インデックス作成が不可能となります。

(1) xetex, luatex, luahbtex の場合，
    \input texinfo-ja.tex @c -*-texinfo-*-
    @documentencoding UTF-8
    @documentlanguage ja

    のような書き出しとして下さい。
    日本語フォントは，HaranoAji フォントが使用されます。

(2) ptex, eptex の場合，
    \input texinfo.tex @c -*-texinfo-*-

    あるいは，
    \input texinfo.tex @c -*-texinfo-*-
    @documentlanguage jp

    のような書き出しにして下さい。
    @documentlanguage ja
    ではなく，
    @documentlanguage jp
    であることに注意して下さい。

    @documentencoding 文は書かないで下さい。もし書く場合は，
    @documentencoding US-ASCII
    だけが許されます。

    日本語フォントは kanjix.map によりますが，最新の場合は
    HaranoAji フォントを使うように設定しています。

[4] サンプル

yatex-lx.texi   : 広瀬さんの古い yatex 用マニュアルから作成したもの
                  で，xetex, luatex, luahbtex 用です。yatex-lx.pdf
                  は xetex で作成したものです。
yatex-ep.texi   : 広瀬さんの古い yatex 用マニュアルから作成したもの
                  で，ptex, eptex 用です。yatex-ep.pdf は ptex と
                  dvipdfmx で作成したものです。

[5] Shift_JIS Texinfo を処理したいとき

ptex, eptex の場合には，以下のようにすると，以前のように Shift-JIS
のファイルを処理することができます。

    一番簡単な
    \input texinfo.tex @c -*-texinfo-*-
    という書き出しにして下さい。
    @documentlanguage 文を書いてはいけません。

    texi2dvi.exe にオプション --sjis を指定します:

    set TEX=ptex -kanji=sjis& texi2dvi --sjis --verbose sjisfile.texi
    allow5c sjisfile.dvi
    dvipdfmx sjisfile.dvi

    あるいは
    set TEX=eptex -kanji=sjis& texi2dvi --sjis --verbose sjisfile.texi
    allow5c sjisfile.dvi
    dvipdfmx sjisfile.dvi

[6] 通常 TeX Live を使っているが，この Texinfo を使いたい場合

TeX Live W32 用の Texinfo addin は
CTAN/systems/win32/w32tex/TLTEXINFO/ で配布していますが，これは
ptex, eptex 用の拡張を含んでいません。しかし通常は配布しているもの
で十分でしょう。 W32TeX 用の，ptex, eptex 用の拡張を含む，この Texinfo
を TeX Live W32 の場合にも使用したい場合には以下のようにすると，
最少のインストールで使うことができます。

    CTAN などから，W32TeX のただ一つのファイル
    (1) texinfo-w32.tar.xz
    を入手します。

    Texinfo 専用のディレクトリ，例えば c:\myprog\texinfo を作ります。
    (1) を c:\myprog\texinfo で展開します:
    cd /d c:\myprog\texinfo
    tar xvf texinfo-w32.tar.xz

    c:\myprog\texinfo に
    texinfo.bat
    なるバッチファイルを作成しておきます。内容は次のようにします:

@echo off
set PATH=c:\myprog\texinfo\bin;%PATH%
set TEXINPUTS=c:/myprog/texinfo/share/texmf-dist/tex/texinfo;

    TEXINPUTS における，最後のセミコロン ; に
    注意して下さい。このセミコロンを忘れると TeX によるコンパイル
    ができなくなります。
    これでインストールは終了です。

    使用するときは
    c:\myprog\texinfo\texinfo.bat
    を実行して環境をととのえれば OK です。
    texi2dvi を使うとき，最初 texmf.cnf が見つからないとの
    warning が表示されますが，実際に必要なときには見つかるように
    なっているので，この warning は無視して下さい。

-- 
Akira Kakuto
