rlog(1) RCS ファイルのログメッセージや、その他の関連情報を表示する

書式

rlog [ options ] file ...

解説

rlogRCS ファイルに関する情報を表示します。

RCS 拡張子にマッチするファイル名は RCS ファイルであるとみなし、 その他のファイル名はワークファイルであるとみなします。 ci(1)で説明しているように、ファイル名はRCSファイルと ワークファイルのペアになっています。

rlog は、各 RCS ファイルの以下の情報を表示します: RCS ファイルのパス名、 ワークファイルのパス名、ヘッド(幹で最新のリビジョン)、デフォルト枝、 アクセスリスト、ロック状況、シンボル名、拡張子、総リビジョン数、 指定されたリビジョンの数、内容記述。以上の情報に加え、新しいものから順に 選択されたリビジョンのリストが表示されます。各リビジョンに関して、 rlog は、 リビジョン番号、作者、日時、状態、(直前のリビジョンから)追加/削除された行数、 ロック者、ログメッセージを表示します。 デフォルトでは、表示されるすべての時刻は協定世界時 (UTC) です ; これは -z オプションで書き換え可能です。 オプションを指定しない場合、 rlog は以上のすべての情報を表示します。 以下のオプションにより表示する内容を限定することができます。

-L
ロックされていない RCS ファイルを無視します。 -h-l-R オプションと組み合わせると便利です。
-R
RCS ファイル名のみを表示します。ワークファイルのパス名を RCS ファイル 名に変換するのに便利です。
-v[string]
ワーキングファイルの名前とデフォルト枝(の枝)の先端リビジョンだけを表示します。 [string] で指定した文字列は出力行の先頭に出力されます。
-h
RCS ファイルのパス名、ワークファイルのパス名、ヘッド、デフォルト枝、ア クセスリスト、ロック者、シンボル名、拡張子を表示します。
-t
-h の情報に追加して内容記述を表示します。
-N
シンボル名を表示しません。
-b
デフォルト枝に関する情報を表示します。通常は、幹の最も大きな番号を持つ枝 です。
-ddates
セミコロンで区切られた、登録日時の範囲にあるリビジョンに関する情報を 表示します。 d1<d2 または d2>d1 なる形式の範囲は、日時 d1 から日時 d2 までの間 (d1とd2は除く) に登録されたリビジョンを指定します。 <d または d> なる形式の範囲は、日時 d より前に登録されたすべてのリビジョンを指定します。 d< または >d なる形式の範囲は日時 d より後を指定します。 もし < または >= が続いていれば、範囲は両端を含むようになります。 d なる形式の範囲は日時 d 以前の最新のリビジョンを指定します。 dd1d2co(1) に記述されている自由形式の日時です。 通常 <> を使う場合にはクォートが必要です。要素の区切りがセミコロンであることに 注意してください。
-l[lockers]
ロックされているリビジョンに関する情報のみを表示します。コンマで区切られた ユーザ名のリスト lockers が指定された場合は、指定されたユーザがロックしたリビジョンに関する情報のみを 表示します。例えば、 rlog -L -R -lwft RCS/* はユーザ wft がロックしている RCS ファイル名を表示します。
-r[revisions]
コンマで区切られたリビジョンのリスト revisions で指定されたリビジョンに関する情報のみを表示します。 rev1:rev2 の形式の範囲指定は、同一枝上の rev1 から rev2 までを、 :rev は枝上の最初のリビジョンからリビジョン rev までを、 rev: はリビジョン rev から枝上の最後のリビジョンまでを示します。引数に枝番号を指定した場合は、 その枝上のすべてのリビジョンに関する情報が表示されます。 枝番号による範囲指定は、範囲内の枝上のすべてのリビジョンを示します。 revisions が省略された場合は、デフォルト枝(通常は幹)上の最新リビジョンの情報のみを 表示します。
-sstates
状態が states であるリビジョンの情報のみを表示します。 states はコンマで区切った状態名のリストです。
-w[logins]
logins で指定したユーザが登録したリビジョンに関する情報のみを表示します。 logins はコンマで区切ったユーザ名のリストです。 logins が省略された場合は、 rlog を起動したユーザ名が用いられます。
-T
このオプションの効果はありません ; ほかの RCS コマンドとの互換性を保つために存在しています。
-V
RCS システムのバージョンを表示します。
-Vn
ログの生成時に、RCS システムのバージョン n のエミュレーションを行います。詳細は co(1) を参照してください。
-xsuffixes
RCS ファイル拡張子を指定します。詳しくは ci(1) を参照してください。

rlog は指定されたオプション -d-l-s-w のすべてに適合し、かつ -b-r の いずれかに適合したリビジョンに関する情報のみを表示します。

-zzone
日時の出力形式を指定し、 -ddates オプションの date に対するデフォルトのタイムゾーンを指定します。 zone には何も指定しないか、数字の UTC を指定するか、ローカルタイムのための 特別な文字列 LT を指定します。 デフォルトは何も指定しない空の zone で、伝統的な UTCRCS 形式ですが、タイムゾーンを示す表示はなく、 日付の部分を分割するのにスラッシュを用います ; 他では、ISO 形式でタイムゾーンの表示と一緒に時間を出力します。 例えば、ローカルタイムが 太平洋標準時の 1990 年 1 月 11 日、午後 8 時で、 UTC から 8 時間、西である(遅れている)場合、時間の出力は以下のようになります :


option      time output
-z          1990/01/12 04:00:00          (default)
-zLT        1990-01-11 20:00:00-08
-z+05:30    1990-01-12 09:30:00+05:30

使用例

    rlog  -L  -R  RCS/*
ロックされたすべての RCS ファイル名を出力します。
    rlog  -L  -h  RCS/*
ロックされたすべての RCS ファイルのヘッダを出力します。
    rlog  -L  -l  RCS/*
ロックされたすべての RCS ファイルのヘッダとログメッセージを出力します。
    rlog  RCS/*
すべての RCS ファイルに関するすべての情報を出力します。

環境変数

RCSINIT
コマンドライン引数に先立って指定すべきオプションを指定します。オプションは 空白で区切って指定します。詳しくは ci(1) を参照してください。

診断

すべての動作が成功した場合に終了ステータス 0 を返します。

作者

Author: Walter F. Tichy.
Manual Page Revision: 1.8; Release Date: 1999/08/27.
Copyright © 1982, 1988, 1989 Walter F. Tichy.
Copyright © 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.

バグ

以前の版の rlog では -r オプションにおけるリビジョンの区切りは - でした。 しかし、これはシンボリック名が - を含んでいるときに混乱を生じます。 従来の版との互換性のため、 - を用いた記法もサポートしますが、この記法を用いた場合は 警告メッセージを表示します。