Mule なしで日本語 Info を表示する !!

Mule なしで日本語 Info を表示 !!

●現時点で最新のGNU Texinfo version 4.1 のフルセットをメイクし、 OS/2での動作確認を終えたので公開します。
●makeinfo.exe は SJIS のソースを扱えます
● XFree86 for OS/2 でも快適に動作!

☆彡SNAPSHOTS!!

OS/2 シェルにて[info.png]
XFree86 for OS/2 にて[xinfo.png]

→ダウンロード

■ Info 形式のマニュアル（文書）について

Info は Free Sofware Foundation が開発・保守している文書の一形態です。１つの Texinfo のソースから、DVI, postscript, PDF, plain text , HTML そして Info と少なくとも 6 種類の形式の文書が生成できます。これらのうち最初の2つの形式は基本的に印刷するためのもので、他の4つはオンラインで（計算機の画面で）閲覧するのに適していると言えます。

個人の嗜好にもよりますが、オンラインのマニュアルの中で最も優れた形式は、相互参照や検索の機能に優れている Info だと私は断言します。HTML と PDF には次のような欠点があります。

X window などのウインドウ (GUI) 環境を必要とする
メモリを大量に消費する
検索や閲覧の機能自体が貧弱であり、しかも極めて遅い

plain text は HTML と PDF よりはましだと思います(less 等の PAGER で閲覧すると、高速の検索が可能で、メモリの消費も少ない)。もう一つ、Unix 標準の MANPAGE 形式がありますが、使っている方は御存知の通り、相互参照機能などなく、機能的には plain text とあまり変わりません。

以上、Info 形式の文書がオンラインマニュアルとして最良であると私が考える理由を述べました。

■ 日本語の Info マニュアルは mule がないと読めなかった
この数年間ずっと不満に思い続けてきたことがありました。日本語の Info 形式文書は emacs/mule からしか読めないことです。英語の Info マニュアルならばわざわざ重たい emacs を起動しなくとも、 info[.exe]というユーティリティで閲覧できるのにです。日本語の Info のためだけに mule を起動するのがわずらわしいために、私は日本語の Texinfo 文書はすべて印刷してきました。

これまでに何度か思い立ち、info[.exe] のソースに手を加えて日本語 Info を閲覧できるようにトライしてたのですが、私の能力では不可でした。

1999年2月7日に、突然思い立ち、文字列 "\\\\" で grep をかけたことを契機に、修正箇所が判明し、めでたく日本語 Info を info[.exe] で表示できるようになったのです。

OS/2 ユーザの中には日本語 Info に関する同じ不満を持っている方が少なくないと思い、実行ファイルとソースの差分ファイルをさっそく公開することにした次第です。

■ OS/2に移植された info.exe は X window では使えなかった
日本語 Info を使えるようにした勢いで、X window の kterm や rxvt からも info.exe を使用できるようにしました。もちろん、日本語 Info の表示はばっちりです。

■ 日本語 Info マニュアル対応の`info'をインストールする前提
emx 0.9d でメイクしたので、emx 0.9d のランタイム環境が必要です。 emx 0.9d をインストールしないで使いたい場合は、ソースから作りなおして下さい。前回はほとんど`info.exe'のみ置いていたので、`hobbes'のftpサイトなどからの Texinfo一式を導入してないといけなかったのですが、この度はフルセットでの公開としています。

OS/2 に移植されたrpm
emx 0.9d runtime = emxrt.zip [550 kb]: ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/ より

■ ダウンロード

最初に、次の二つのライブラリを（もしまだでしたら）インストールして下さい。

GNU intl library of gettext 0.10.40 and libiconv 1.7 intl40.zip[655 kb]
ncurses version 5.2: modified version: ncurses-5.2.zip[261kb]

rpmをインストールしている場合は、RPM パッケージを、そうでない場合は、ZIP の方をダウンロードして下さい。

ZIP アーカイブ: texinfo-4.1.zip[746 kb]
RPM パッケージ: texinfo-4.1-1.i386-OS2.rpm[681 kb]

実行ファイル、文書、ソースからの差分などが入っています。

■インストール
ZIP アーカイブをインストールする場合は、texinfo-4.1.zipを解凍してから READMEファイルに従って下さい。

texinfo-4.1-1.i386-OS2.rpmをダウンロードしてから、rpm を用いてインストールするには次のようにします。


      x:\foo> rpm -i SOMEWHERE/texinfo-4.1-1.i386-OS2.rpm

texinfo-4.1-1.i386-OS2.rpmをダウンロードしないで直接インストールするにはこのようにします。

      x:\foo> rpm -i http://www2s.biglobe.ne.jp/~vtgf3mpr/gnu/texinfo-4.1-1.i386-OS2.rpm

この rpm パッケージの中身は "/emx" 以下にインストールされることになります。 /emx/doc/texinfo-4.1/にあるマニュアルを読んで環境設定してください。

ここから先は、後から読んだ方がいいでしょう。

■ 日本語 Texinfo のソースから SJIS の Info ファイルを作る手順
OS/2のテキストモードでは Shift JIS の日本語 Info が必要なので、基本的にソースから作りなおさねばばなりません。なぜなら、

skk,canna, mule, CDROM検索のEB libraryと関連ユーティリティ（eblook, lookup）等には、最初から日本語 Info マニュアルが付属してきますが、それらを単純に SJIS に変換したものでは、制御コードが入っているためにまともに閲覧できないことが多いからです。

次のような手順で SJIS の Info マニュアルを作成します。

makeinfo.exe を直接用いる方法

Texinfo ソースの漢字コード: EUC のものはSJISに変換して下さい
makeinfo.exe の実行と Info の SJIS への変換: nkf 等を用います。
```
      $ makeinfo --force foo.texi 
```
日本語 Texinfo に限らず、"--force"によりエラーチェックをはずさないと、しばしば Info マニュアルが生成されません。 "--force"によりエラーを無視して作った Info を実際に閲覧してみて本当に異常が認められたことは私の経験では皆無です。
"--output - " は標準出力にかき出すオプション。

注意その1: @setfilename !

      pmmule に付属する mule-2.3/man/*-jp.texi はすべて Info ファイルの
      生成ディレクトリが指定されています。

          例えば、mule-jp.texi の場合は、
       
              @setfilename ../info/mule-jp

       このようになっているので、

       > makeinfo --force --no-split foo.texi

    を実行すると、"../info/mule-jp" にファイルができるので

       > dir *.info
     
     としてもファイルが見つからず当惑します。このようなことを避けるためにも
     "--output -" オプションを用いて、nkf に出力を渡して一発で SJIS Info を
     作成するべきだと言えます。

注意その2: 他の Texinfo ソースを include していることがある
```
      foo.texi が bar.texi など他のソースをインクルードしていることが
      しばしばあります。たまたまインクルードされているファイルも日本語
      SJIS ならいいのですが、そうでない場合はエラーになります。
      
      従って、ソースのあるディレクトリの Texinfo ソースはすべて日本語 SJIS
      に変換しておいた方がいいです。
```
同梱のバッチファイル (jmakeinfo.cmd) は makeinfo.exe と nkf.exe を用いて、foo.texi の日本語コードが何であれ、SJIS の日本語 Info , foo.info を作ることになっています。しかしながら、上述の如く、他に取り込んでいるファイルがありそれが日本語 SJIS でないとエラーになることがあります。
emacs / mule を用いる方法私はつい最近まで mule を用いて Texinfo ソースから Info マニュアルを作成したことがないので、この2、3日の経験からすると、 mule を用いることは推奨しません。
1. Meta-x makeinfo-buffer: 次のようなエラーのため失敗
  This file documents is about Lookup a search interface.
  makeinfo --fill-column=70 k:/src/lookup-1.0pre8/texi/lookup.texi
  k:/src/lookup-1.0pre8/texi/lookup.texi: No such file or directory
  Compilation exited abnormally with code 2 at Tue Feb 9 00:46:18
2. Meta-x texinfo-format-buffer: 失敗することが多かった。次の如く。
  @dirca egory is not handled by texinfo
3. バッチモードで、"emacs -batch -funcall batch-texinfo-format foo.texi": やはり失敗することが多かった。

以上。

2002/3/24
                 沢田石 順 jsawa@ibm.net
                  http://www2s.biglobe.ne.jp/~vtgf3mpr/indxos2.htm

HOMEPAGEへ

OS/2,LaTeX,Postscriptのページへ