Date: 1998-12-24
Name: man-pages-ja-0.4/INSTALL

            ==========================================
            日本語マニュアル・ページのインストール方法
            ==========================================

1) 日本語 groff 及び日本語 less のインストール

  まだ日本語の groffをインストールしていない場合には、使用しているディ
  ストリビューションに対応した日本語パッケージの中から、jgroff-0.99 等
  をインストールしてください。日本語に対応した less も必要になりますの
  で、忘れずにインストールしておいてください。

2) 日本語 man コマンドのインストール

  同様に使用している日本語パッケージから、 日本語に対応した man コマン
  ドをインストールしてください。それでうまくいかなかった場合には、この
  アーカイブにも manコマンドの実行バイナリを添付しましたので、こちらを
  試してみてください。バイナリには、libc5 と glibc2 の両方のバイナリを
  準備しています。インストール時にどちらかを自動選択してします。

  附属 man コマンドのインストールは、展開後に作成されたディレクトリ 
  man-pages-ja-0.4/ で、

    make install_jman

  としてください。setuid,setgid はされていないので、必要ならば手作業で
  行なってください。

  ディレクトリ man-ja には、元の man-1.5f へのパッチ man-1.5f-ja.diff.gz
  がありますので、自分でコンパイルしたい人はご利用ください。

3) マニュアルのインストール

  まず最初に、展開後に作成されたディレクトリ man-pages-ja-0.4 で、

    make config 

  としてください。いくつかの設定を聞かれますので、それに答えてください。
  手順 2)でこのパッケージに附属する man コマンドをインストールした場合
  には全てデフォルトの設定のまま(Enter だけ)で良いはずです。

  設定が終ったら、

    su

  でスーパーユーザーになって、

    make install

  としてください。これにより各マニュアルがインストールされます。

  今回は whatis データベースは自動的に作成されません。whatisコマンドや
  apropos コマンドを使用したい人は、インストール後に、手動で 

    /usr/sbin/makewhatis

  を実行してください。

  以上でインストールは終了です。環境変数 LANG が ja_JP.ujis と正しく設
  定されていば日本語のマニュアルを見ることができるはずです。

     man man

  など色々と試してみてください。

4) その他の注意点

  今回アルファ版ということで、まだ重複マニュアルの管理ができていません。
  それ一部の重複のあるマニュアルは others ディレクトリの下に置いてあり
  ます。これらのマニュアルは自動的にはインストールされませんので、必要
  ならば手作業でインストールしてください。

5) トラブル・シューティング

  日本語のマニュアルが文字化けなどで正常に表示されない場合にはいくつか
  の可能性があります。以下のチェックを行なってみてください。

  イ) 端末の漢字モード
     端末の漢字モードが正しく「日本語 EUC」になっているか確認してみて
     ください。kterm ならば 「Ctrl キー」 +「マウスの中ボタン」で出る
     メニューで "Japanese EUC mode" になっているか確認してください。
     また  telnet 等で他のマシンに入って作業している場合には telnetが
     8bit 透過になっているかどうかも確認してください。

  ロ) 日本語 less コマンドのインストール
     日本語 less がインストールされているか確認してください。 less -V 
     とすると less のバージョンが表示されます。 iso242 などと表示され
     ない場合には less が日本語対応でない可能性があります。

  ハ) less の設定
     less  で普通の日本語ファイルを見ることができるか確認してみてくだ
     さい。 例えばこのファイルを less で見ることができますか？ 見るこ
     とができない場合には環境変数  LESSCHARSET または JLESSCHARSET に
     japanese-euc などを設定してみてください。

  ニ) 日本語 groff コマンドのインストール
     本当に 日本語 groff かインストールされているかを確認してください。
     groff -V -Tnippon  を実行してみて invalid device 'nippon' という
     エラーになるようならば、その groff は日本語対応ではありません。

  ホ) LANG 環境変数
     日本語ではなく、常に英語のマニュアルが表示されるようならば環境変
     数 LANG の設定が間違っている可能性があります。printenv LANG など
     で LANG 環境変数が正しく ja_JP.ujis になっているか確認してくださ
     い。また LANG として他の値(例えば ja_JP.eucJPなど)を使用する場合
     には、日本語マニュアルのインストール先をそれに合わせて変更する必
     要があります。

  ヘ) 日本語 man コマンドのインストール
     日本語 man  コマンドが正しくインストールされているか確認ください。
     うまくいかない場合には、このパッケージに附属の manコマンドを試し
     てみてください。
     附属 man コマンドでは環境変数 LANG が正しく設定されていれば
     man -h で日本語ヘルプを表示させることができます。
     man -d ls のようにすることでデバック情報が表示されます。よく確認
     してみてください。

  ト) その他(苦笑)
     一部のマニュアルのみが英語で表示される場合には、単にそのマニュア
     ルの日本語訳がまだ存在しない可能性高いです。 JM プロジェクトでは
     常に翻訳スタッフを募集しておりますので、よろしくお願いします。

     一部のマニュアルだけが文字化けする場合には、そのマニュアルページ
     の文字コードやコマンド等が変になっている可能性があります。そのよ
     うなマニュアルを見つけられた場合には jman@linux.or.jp まで連絡い
     ただければ幸いです。

以上
