オンラインマニュアルの参照

SunOS 上では、国際化された man コマンドと nroff およびその関連コマンドにより、日本語のオンラインマニュアルページを参照できます [ただし、troff の国際化は行われていないため、man コマンドの -t オプションを日本語マニュアルページの troff 出力に使うことはできません。　] 。日本語のオンラインマニュアルページおよびそのためのマクロパッケージは、JFP によって提供されます。

マニュアルページの参照

環境変数 LC_MESSAGES が日本語ロケール (ja または japanese) に設定されているか、LC_MESSAGES が設定されておらず LANG が日本語ロケールに設定されていれば、man コマンドで指定されたマニュアルページが日本語で存在している限り、日本語のマニュアルページが表示されます。例として、dumpcs(1) のマニュアルページを参照してみましょう。次のように入力します。

sun% man dumpcs
マニュアルを清書中です。しばらくお待ちください... 

しばらくすると dumpcs(1) の日本語マニュアルページが表示されます。

マニュアルを清書中です。しばらくお待ちください... 終了

dumpcs(1)               ユーザコマンド                dumpcs(1)          

【名前】
     dumpcs - 現在のロケールのコードセット一覧表を表示

【形式】
     dumpcs [ -0123vw ]

【機能説明】
     dumpcs は、ユーザの現在のロケールに対応するコードセットの印
--継続--(9%)

一時的に英文のマニュアルページを参照したい場合には、env(1) コマンドを使い、次のように「env LANG=C man dumpcs」と入力します。

sun% env LANG=C man dumpcs
Reformatting page.  Wait... 

Reformatting page.  Wait... done

dumpcs(1)                USER COMMANDS                  dumpcs(1)     

NAME
     dumpcs  - show the codeset table for the current locale

SYNOPSIS
     dumpcs [ -0123vw ]

DESCRIPTION
     dumpcs shows a list of printable characters for  the  user's
--More--(9%)

和文と英文のマニュアルページを両方とも頻繁に参照する場合は、"env LANG=C man" の部分を C シェルの別名 (alias) として登録しておくとよいでしょう。

清書済みオンラインマニュアルと windex の作成

オンラインマニュアルは、システムの出荷時には nroff(1) または troff(1) のソース形式で提供されます。catman(1M) コマンドによって、これらのマニュアルページをあらかじめ清書しておくと、man(1) コマンドによる表示の際の清書作業にかかる時間を節約できます (ただし、これによってさらにディスクスペースが消費されることに注意してください)。

また、catman コマンドは、whatis(1) および apropos(1) コマンドによって検索されるシステム機能の要約情報のデータベースファイル windex を作成します。-n オプションを用いるとこのデータベースは作成されず、-w オプションを用いるとこのデータベースの作成のみを行います。catman コマンドは、ユーザーが現在使用しているロケール名のディレクトリがオンラインマニュアルぺージのルートディレクトリに存在すると、その下のマニュアルページだけを清書します (たとえば、/usr/share/man/ja/man* がある場合は ja/man* を清書します)。英語のマニュアルページに対して常に翻訳マニュアルが用意されているとは限りませんので、必要に応じて次の例のように、ユーザーの通常の作業環境のロケールと、それが C ロケールではない場合には C ロケールと、それぞれでスーパーユーザーになって catman を実行してください。

sun# setenv LANG C
sun# catman 1 2 3
sun# setenv LANG ja
sun# catman 1 2 3

whatis による機能要約の参照

コマンドの機能の要約文だけを見たい場合には、whatis コマンドを使います。環境変数 LC_MESSAGES が日本語ロケール ja、 ja_JP.PCK または ja_JP.UTF-8 に設定されているか、LC_MESSAGES が設定されておらず LANG が日本語ロケールに設定されており、whatis コマンドで指定されたマニュアルページが日本語で存在し、その情報を含む windex データベースが作られていれば、日本語のコマンド機能要約を次のように表示できます。

sun% whatis dumpcs
dumpcs          dumpcs (1)      - 現在のロケールのコードセット一覧表を表示
sun%

apropos によるキーワード検索

whatis とは逆に、コマンド機能要約文中のキーワードからコマンド名を探したいときには apropos コマンドを使用できます。環境変数 LC_MESSAGES が日本語ロケール ja、ja_JP.PCK または ja_JP.UTF-8 に設定されているか、LC_MESSAGES が設定されておらず LANG が日本語ロケールに設定されており、apropos コマンドで指定されたマニュアルページが日本語で存在し、その情報を含む windex データベースが作られていれば、日本語のコマンド機能要約を次のように表示できます。

sun% apropos コードセット一覧表
dumpcs          dumpcs (1)      - 現在のロケールのコードセット一覧表を表示
sun%