名称

rlog - RCS ファイルのログメッセージとその他の関連情報を表示する

書式

rlog [ options ] file ...

解説

rlog は、RCS ファイルに関する情報を表示します。

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

デフォルト枝に関する情報を表示します。通常は、幹の最も大きな番号を持つ枝です。

-d dates

セミコロンで区切られた、 dates (登録日時) の範囲にあるリビジョンに関する情報を表示します。 d1 < d2 または d2 > d1 なる形式の範囲は、日時 d1 から日時 d2 までの間 (d1 と d2 は除く) に登録されたリビジョンを指定します。 < d または d > なる形式の範囲は、日時 d より前に登録されたすべてのリビジョンを指定します。 d < または > d なる形式の範囲は、日時 d より後を指定します。もし < または > に = が続いていれば、範囲は、両端を含むようになります。 d なる形式の範囲は、日時 d 以前の最新のリビジョンを指定します。 d, d1, と d2 は、 co(1) に記述されている自由形式の日時です。通常 < や > を使う場合には、クォートが必要です。要素の区切りがセミコロンであることに注意してください。

-l[ lockers]

ロックされているリビジョンに関する情報のみを表示します。コンマで区切られたユーザ名のリスト lockers が指定された場合は、 lockers が保持しているもの以外の他の全てのロックは、無視されます。すなわち、指定されたユーザがロックしたリビジョンに関する情報のみを表示します。例えば、 rlog -L -R -lwft RCS/* は、ユーザ wft がロックしている RCS ファイル名を表示します。

-r[ revisions]

コンマで区切られたリビジョンのリスト revisions で指定されたリビジョンに関する情報のみを表示します。範囲指定 rev1 : rev2 は、同じ枝でリビジョン rev1 から rev2 を意味し、 : rev は、枝の始まりから rev を含んむリビジョンを意味し、そして rev : は、 rev で始まり rev を含む枝の終りまでのリビジョンを意味します。引数に枝番号を指定した場合は、その枝上のすべてのリビジョンに関する情報が表示されます。枝番号による範囲指定は、範囲内の枝上のすべてのリビジョンを示します。 . があとに続いた枝番号は、その枝番号で最新のリビジョンを意味します。 revisions のない -r だけは、デフォルト枝番号 (通常は、幹) 上に最新のリビジョンを意味します。

-s states

状態が states であるリビジョンの情報のみを表示します。 states は、コンマで区切った状態名のリストです。

-w[ logins]

logins で指定したユーザが登録したリビジョンに関する情報のみを表示します。 logins は、コンマで区切ったユーザ名のリストです。 logins が省略された場合は、ログインしたユーザ名が用いられます。

-T

このオプションの効果はありません。ほかの RCS コマンドとの互換性を保つために存在しています。

-V

RCS システムのバージョンを表示します。

-V n

ログの生成時に、RCS システムのバージョン n のエミュレーションを行います。詳細は、 co(1) を参照してください。

-x suffixes

RCS ファイル suffixes (拡張子) を指定します。詳しくは、 ci(1) を参照してください。

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

-z zone

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

使用例

rlog -L -R RCS/* rlog -L -h RCS/* rlog -L -l RCS/* rlog RCS/*

最初のコマンドは、ロックされたサブディレクトリ RCS 中の、すべての RCS ファイル名を出力します。 2 番目のコマンドは、ロックされたすべての RCS ファイルのヘッダを出力します。 3 番目のコマンドは、ロックされたすべての RCS ファイルのヘッダとログメッセージを出力します。最後のコマンドは、すべての RCS ファイルに関するすべての情報を出力します。

環境変数

RCSINIT

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

診断

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

識別

作者: Walter F. Tichy. マニュアルページリビジョン: 50472;リリース日: 1999-08-27. Copyright © 1982, 1988, 1989 Walter F. Tichy. Copyright © 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.

関連項目

ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rcsfile(5) Walter F. Tichy, RCS--A System for Version Control, Software--Practice & Experience 15, 7 (July 1985), 637-654.

バグ

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