--- whereis.1.orig	2021-03-05 09:33:38.998453764 +0900
+++ whereis.1	2021-03-07 10:16:04.135073614 +0900
@@ -35,6 +35,16 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
+.\"
+.\" Japanese Version Copyright (c) 2001-2021 Yuichi SATO
+.\"         and 2021 Yoichi Chonan
+.\"         all rights reserved.
+.\" Translated Sat Feb 17 03:19:58 JST 2001
+.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
+.\" Updated & Modified (util-linux 2.36) Sun Mar  7 09:36:18 JST 2021
+.\"         by Yuichi SATO <ysato444@ybb.ne.jp>
+.\"         and Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
+.\"
 .TH WHEREIS 1 "October 2014" util\-linux "User Commands"
 .SH 名前
 whereis \- コマンドのバイナリ、ソース、マニュアルファイルがどこにあるかを突き止める
@@ -49,7 +59,11 @@
 を使用したことによる \fBs.\fP という接頭辞への対応も行われる。\fBwhereis\fP
 は、それから、検索対象のプログラムなどを Linux の標準的な場所と、\fB$PATH\fP
 や　\fB$MANPATH\fP によって指定されている場所で見つけ出そうとする。
-.sp
+.IP "[\fB訳注\fP]" 8
+「\fBs.\fP という接頭辞への対応」というのは、たとえば、ls
+のソースファイルの探索を求められたときに、ls.c だけでなく、s.ls.c
+といったファイルも捜しに行くようにすることである。
+.PP
 検索対象の限定 (オプション \fB\-b\fP, \fB\-m\fP, \fB\-s\fP)
 は累加式であり、コマンドラインで後に続く \fIname\fP というパターンに適用される。
 なお、検索対象の限定をやり直すと、検索の条件が再設定されることになる。たとえば、
@@ -84,6 +98,13 @@
 1 つではないことである。従って、'\fBwhereis \-m \-u *\fP' というコマンドは、
 カレントディレクトリのファイルのうちで、文書ファイルがまったく存在しないか、2
 つ以上存在するものを求めることになる。
+.RS
+.IP "[\fB訳注\fP]"
+この説明は古くなっているのではないかと思う。実際には、手元の
+util-linux 2.36 で '\fBwhereis -m -u *\fP'
+を実行しても、文書ファイルのまったく存在しないものについては、何も表示されない。2
+つ以上存在するものだけが表示される。
+.RE
 .IP "\fB\-B \fP\fIlist\fP"
 \fBwhereis\fP がバイナリを捜す場所を限定する。\fIlist\fP
 は、ホワイトスペース (訳注: スペースやタブ) で区切ったディレクトリのリストである。
@@ -120,15 +141,19 @@
 .IP WHEREIS_DEBUG=all
 デバッグ出力を有効にする。
 .SH 用例
-\fI/usr/\:bin\fP にあるファイルの内、\fI/usr/\:man/\:man1\fP にマニュアルがないか、
-\fI/usr/\:src\fP にソースのないものをすべて見つけ出す。
+\fI/usr/bin\fP にあるファイルの内、\fI/usr/man/man1\fP にマニュアルがないか、
+\fI/usr/src\fP にソースのないものをすべて見つけ出す。
 .IP
 \fBcd /usr/bin\fP
 .br
 \fBwhereis \-u \-ms \-M /usr/man/man1 \-S /usr/src \-f *\fP
+.IP "[\fB訳注\fP]"
+上記のコマンドは、少なくとも手元の util-linux 2.36
+では、指定したディレクトリにマニュアルやソースがないものの表示はせず、たとえば
+passwd.1.gz と passwd.1ssl.gz のように、そうしたものが
+2 つ以上ある場合だけ表示するようだ。\fB-u\fP オプションの訳注も参照。なお、
+当方の場合、マニュアルがあるのは、/usr/share/man/man1 である。
 .SH 入手方法
-この whereis コマンドは util\-linux パッケージの一部であり、
-.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/
-Linux Kernel Archive
-.UE
+この whereis コマンドは util\-linux パッケージの一部であり、Linux Kernel Archive
+<https://www.kernel.org/pub/linux/utils/util\-linux/>
 から入手できる。
