--- logger.1.orig	2020-12-21 12:51:09.681683115 +0900
+++ logger.1	2020-12-21 12:51:27.445683700 +0900
@@ -36,6 +36,18 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
+.\"
+.\" Translated Sat Aug 28 JST 1993 by NetBSD jman proj. <jman@spa.is.uec.ac.jp>
+.\" Updated Sun Jun 18 JST 2000 by Kentaro Shirakata <argrath@ub32.org>
+.\" Updated Tue Jan  9 13:53:03 JST 2001
+.\"      by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
+.\" Updated Sat Nov 17 15:05:36 JST 2001
+.\"      by Yuichi SATO <ysato@h4.dion.ne.jp>
+.\" Updated & Modified Sun Mar  2 16:39:57 JST 2003 by Yuichi SATO
+.\" Updated & Modified (util-linux 2.36) Mon Dec 14 15:44:47 JST 2020
+.\"      by Yuichi SATO <ysato444@ybb.ne.jp>
+.\"      and Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
+.\"
 .TH LOGGER 1 "November 2015" util\-linux "User Commands"
 .SH 名前
 logger \- システムログにメッセージを書き込む
@@ -101,7 +113,7 @@
     DOGS=bark
     CARAVAN=goes on
     end\fP
-.IP
+.sp
     \fBlogger \-\-journald=entry.txt\fP
 .fi
 .IP
@@ -150,6 +162,26 @@
 の組み合わせで指定してもよい。たとえば、\fB\-p local3.info\fP
 と指定すると、ファシリティが local3、レベルは informational
 としてメッセージが記録される。デフォルトは \fBuser.notice\fP である。
+.RS
+.IP "[\fB訳注\fP]" 8
+ファシリティ (facility) というのは、わかりにくい言葉だ。
+だが、logger コマンドでは、ファシリティの値のそれぞれを、出力するメッセージの分類
+(対象分野) ぐらいに考えておけばよいのではないかと思う。ファシリティが mail なら当然
+mail 関係だし、auth ならセキュリティや認証関係のメッセージということだ。user や
+local は、その他といったところだろうか。レベル (level) は「重大度、深刻度」。
+そして、こうしたファシリティとレベルにより、\fI/etc/syslog.conf\fP
+(または \fI/etc/rsyslog.conf\fP)
+の設定に基づいて、出力先のログファイルが決まるわけである。
+.sp
+ファシリティやレベルの数値による表現については、
+「\fBファシリティとレベル\fP」セクションをご覧いただきたい。
+.sp
+なお、手元で試してみたところでは、この \fB\-\-priority\fP
+オプションでは、レベルを数値で指定することはできるが、
+ファシリティを数値で指定することはできないようだ。
+数値をそのまま使うのも、\fB\-\-prio\-prefix\fP のように
+8 倍してレベルを足すのも、うまく行かなかった。
+.RE
 .TP 
 \fB\-\-prio\-prefix\fP
 標準入力から読み込むすべての行で sysylog の接頭辞 (prefix)
@@ -164,6 +196,18 @@
 で指定された優先度 \fIpriority\fP を使ってログに記録される。
 .sp
 このオプションは、コマンドライン引き数として指定したメッセージに対しては働かない。
+.RS
+.IP "[\fB訳注\fP]" 8
+別の角度から説明すると、
+これは、入力するメッセージの行中でファシリティとレベルを指定する方法だと言えるだろう。
+メッセージをファイル、または標準入力から入力するとき
+(コマンドラインの引き数としてではない)、\fBlogger\fP コマンドに
+\fB\-\-prio\-prefix\fP オプションを付け、メッセージ各行の行頭には
+\fB<134>\fP などと書いておく。そうすると、\fBlogger\fP
+がその行を優先度 \fBlocal0.info\fP
+のメッセージなどと解釈して、適切なログファイルに送ってくれるのである。
+\fB<134>\fP などの接頭辞がログに書き込まれるわけではない。
+.RE
 .TP 
 \fB\-\-rfc3164\fP
 リモートサーバにメッセージを送るのに RFC 3164 の BSD syslog プロトコルを使用する。
@@ -271,7 +315,7 @@
 システムコールを使用するメッセージ処理と同じことである。\fBlogger\fP(1) も、
 バージョン 2.26 より前は openlog を使用していた。そのため、Unix
 ソケットに送信したメッセージが消失しても、当時は検出できなかったのである。
-.IP
+.sp
 デフォルトの mode は、\fBauto\fP
 である。エラー表示が有効ではないと、メッセージの消失があっても、通知されず、\fBlogger\fP
 の実行は、成功のステータスで終わることになる。
@@ -304,6 +348,10 @@
 \fBlogger\fP ユーティリティは、実行に成功すると、0
 の終了ステータスで、エラーが起きた場合は、0 より大きい終了ステータスで終了する。
 .SH ファシリティとレベル
+.IP "[\fB訳注\fP]"
+以下、ファシリティやレベル名の後ろに、カッコに入れて、数値による表現を付けておく。
+こうした数値は、\fB\-\-prio\-prefix\fP で使用できる。
+.PP
 有効なファシリティ名 (メッセージの分類):
 .IP
 .nr WI \n(.lu-\n(.iu-\w'\fBauthpriv\fR'u-3n
@@ -317,7 +365,8 @@
 \fBftp\fP(11)
 \fBkern\fP(0):T{
 ユーザスペースのプロセスからは生成できない。たとえ
-\fBkern\fP を指定しても、自動的に \fBuser\fP に変更されるT}
+\fBkern\fP を指定しても、自動的に \fBuser\fP に変更される
+T}
 \fBlpr\fP(6)
 \fBmail\fP(2)
 \fBnews\fP(7)
@@ -362,21 +411,15 @@
 .SH 作者
 オリジナルの \fBlogger\fP コマンドが書かれたのは、カルフォルニア大学で、1983
 年から 1993 年のことだった。その後、次の者たちが書き直した。
-.MT kzak@redhat.com
-Karel Zak
-.ME ,
-.MT rgerhards@adiscon.com
-Rainer Gerhards
-.ME
-及び
-.MT kerolasa@iki.fi
-Sami Kerola
-.ME .
+.PP
+Karel Zac <kzak@redhat.com>
+.br
+Rainer Gerhards <rgerhards@adiscon.com>
+.br
+Sami Kerola <kerolasa@iki.fi>
 .SH 関連項目
 \fBjournalctl\fP(1), \fBsyslog\fP(3), \fBsystemd.journal\-fields\fP(7)
 .SH 入手方法
-この logger コマンドは Util\-linux パッケージの一部であり、
-.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util\-linux/
-Linux Kernel Archive
-.UE
+この logger コマンドは Util\-linux パッケージの一部であり、Linux Kernel Archive
+<https://www.kernel.org/pub/linux/utils/util\-linux/>
 から入手できる。
