目次(まとめ)

◾️ コマンドのマニュアルは、"man" コマンドで確認できる

◾️ 日本語マニュアルを公式サイトからダウンロードしてインストールする

◾️ "man" コマンドの設定ファイルを修正して、日本語マニュアルを表示する

こんにちは、みっちゃんです。

コマンドを使うときに、オプションなどを忘れてしまうのですが、コマンドのマニュアルを手軽に調べる方法はありますか?

コマンドのマニュアルは、"man" コマンドというコマンドで確認することができます。ただし、デフォルトでは、英語のマニュアルしか見ることができません。

今回の記事では、"man" コマンドの使い方と、その日本語表示の方法について紹介します。

コマンドのマニュアルは、"man" コマンドで確認できる

Macのターミナルなどで使えるLinuxコマンドには、いろいろな種類があります。

このブログの中でも、以下の表に示すように、わたしが頻繁に使用しているコマンドを紹介してきました。

コマンド内容紹介記事
catファイルの中身を表示する(標準出力)こちら
lessファイルの中身を表示するこちら
sort並び替えるこちら
awk列を取り出すこちら
find検索するこちら
sed指定行を取り出すこちら
grep指定文字列を含む行を取り出すこちら
screen仮想画面で実行するこちら
wgetURLを指定してファイルをダウンロードするこちら
cut指定列を削除するこちら
paste複数のファイルを列方向に結合するこちら

頻繁に使っているとは言っても、「あれ?catコマンドはどうやって使うんだったっけ?」といった風になる状況もあります。

そんなときには、"man" コマンドを使って、マニュアルを確認します。

実行方法は、以下の通りです(ターミナル上で実行している例です)。

$ man cat

これを実行すると、以下のような使い方マニュアルが表示されます。

CAT(1)                    BSD General Commands Manual                   CAT(1)

NAME
     cat -- concatenate and print files

SYNOPSIS
     cat [-benstuv] [file ...]

DESCRIPTION
     The cat utility reads files sequentially, writing them to the standard
     output.  The file operands are processed in command-line order.  If file
     is a single dash (`-') or absent, cat reads from the standard input.  If
     file is a UNIX domain socket, cat connects to it and then reads it until
     EOF.  This complements the UNIX domain binding capability available in
     inetd(8).

     The options are as follows:

     -b      Number the non-blank output lines, starting at 1.
     :

下矢印などでスクロールすることで全体をみることができます。マニュアルを閉じる場合には、"q" キーを押します。

このマニュアルを見ると、"cat" コマンドには、いろいろなオプション("b", "e", "n", "s", "t", "u", "v")があることがわかり、それぞれの使い方を確認することもできます。

しかし、デフォルトの状態では「英語」表記です。

これは、英語版のマニュアルしかインストールされていないからであり、日本語版のマニュアルをインストールできれば、日本語で表示させることが可能です。

日本語マニュアルを公式サイトからダウンロードしてインストールする

日本語マニュアルは、公式Webサイト(http://linuxjm.osdn.jp/download.html)からダウンロードできます。

ダウンロードした圧縮ファイルを解凍すると、"Downloads" ディレクトリに "man-pages-ja-20201015" というディレクトリができています。

Macのターミナル上で、"man-pages-ja-20201015" に移動します。

$ cd ~/Downloads/man-pages-ja-20201015

以下のように、インストールしていきます。

$ make config

これを実行すると、以下のように表示されます。

perl -w script/configure.perl
[INSTALLATION INFORMATION]
(just Return if you accept default)

引き続き、インストールに関する設定のための質問がつづきます。

#質問回答
1Install directory [/usr/share/man/ja_JP.UTF-8] ?/usr/local/share/man/ja_JP.UTF-8
2compress manual with..
0: none 1: gzip 2: bzip2 3: compress
select [0..3] :
0
3uname of page owner [root]root
4group of page owner [root] ?wheel

ここまで回答すると、以下のように確認されますので、"C" を押して、設定を続けます。

   Directory:    /usr/local/share/man/ja_JP.UTF-8
   Compression:  none
   Page uid/gid: root/wheel

All OK? (Yes, [C]ontinue / No, [R]eselect) : 
#質問回答
5[INSTALL PACKAGE SELECTION]
(just Return if you accept default choice)

※ここでは、120個ほど質問がつづきますが、"Enter" キーを押し続ければ大丈夫です。
Enter

ここまで回答すると、再度、以下のように確認されますので、"C" を押して、設定を続けます。

All OK? (Yes, [C]ontinue / No, [R]eselect) : 
#質問回答
6[RESOLVE CONFLICTS]
(just Return if you accept item 0)

※ここでは、166個ほど質問がつづきますが、"Enter" キーを押し続ければ大丈夫です。
Enter

ここまで回答すると、再度、以下のように確認されますので、"C" を押して、設定を続けます。

All OK? (Yes, [C]ontinue / No, [R]eselect) : 

これで質問への回答は終わりで、設定が完了します。

この設定にしたがってインストールするために、以下のように実行します。

$ sudo make install

パスワードが求められますので、パスワードを入力します(見えませんが入力されています)。

これでインストールは完了ですが、インストールができたかどうかを確認するためには、以下のように実行します(ここでは、"cat" コマンドを例に確認しています)。

$ man cat -w                 
/usr/local/share/man/ja_JP.UTF-8/man1/cat.1

このように、インストールの設定の際に指定していた "/usr/local/share/man/ja_JP.UTF-8" のディレクトリ内にあるマニュアルをみえるようになっていればOKです。

日本語マニュアルを見るためには、以下のように実行することになります。

$ man cat

もし、何も表示されない場合には、以下の手順を参考に、"/etc/man.conf" ファイル("man" コマンドの設定ファイル)の修正を行います。

"man" コマンドの設定ファイルを修正して、日本語マニュアルを表示する

"man" コマンドの設定ファイルは、"/etc/man.conf" ですので、管理者権限のもと、Emacsなどで開いて編集します(Emacsについてはこちらの記事をご参照ください)。

$ sudo emacs /etc/man.conf

修正すべき点は、以下の3点です。

行番号修正前(デフォルト)修正後
96JNROFF /usr/bin/groff -Tnippon -mandocj -cJNROFF /usr/local/bin/groff -Dutf8 -Tutf8 -mandoc -mja -E
106PAGER /usr/bin/less -isPAGER /usr/bin/less -isr
107BROWSER /usr/bin/less -isBROWSER /usr/bin/less -isr

これで、再度、以下のように実行すれば、日本語マニュアルを確認できます。

$ man cat
CAT(1)                                                    ユーザーコマンド                                                    CAT(1)

名前
       cat - ファイルの内容を連結して標準出力に出力する

書式
       cat [オプション]... [ファイル]...

説明
       ファイル (複数可) の内容を結合して標準出力に出力します。

       ファイルの指定がなかったり、 - であった場合, 標準入力から読み込みます。

       -A, --show-all           -vET と同じ

       -b, --number-nonblank
              空行以外に行番号を付ける。-n より優先される
        :