RLOG(1)

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

書式
rlog [ options ] file ...

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

RCS 拡張子にマッチするファイル名は RCS ファイルであるとみなし、その他 のファイル名はワークファイルであるとみなします。 ci(1) を参照してください。

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

-L  ロックされていない RCS ファイルを無視します。 -h 、 -l 、 -R オプションと組み合わせると便利です。

-R  RCS ファイル名のみを表示します。ワークファイルのパス名を RCS ファイル名に 変換するのに便利です。

-h  RCS ファイルのパス名、ワークファイルのパス名、ヘッド、デフォルト枝、 アクセスリスト、ロック者、シンボル名、拡張子を表示します。

-t  -h の情報に追加して内容記述を表示します。

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

-ddates
    セミコロンで区切られた、登録日時の範囲にあるリビジョンに関する情報を表示 します。 d1<d2 または d2>d1 なる形式の範囲は、日時 d1 から日時 d2 の間に登録されたリビジョンを指定します。 <d または d> なる形式の範囲は、日時 d 以前に登録されたリビジョンを指定します。 d< または >d なる形式の範囲は日時 d 以降を指定します。 d なる形式の範囲は日時 d 以前の最新のリビジョンを指定します。 d 、 d1 、 d2 は co(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 を起動したユーザ名が用いられます。

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

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

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

例

    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.
Revision Number: ; Release Date: .
Copyright © 1982, 1988, 1989 by Walter F. Tichy.
Copyright © 1990, 1991 by 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 オプションにおけるリビジョンの区切りは - でした。 しかし、これはシンボリック名が - を含んでいるときに混乱を生じます。従来の版との互換性のため、 - を用いた記法もサポートしますが、この記法 を用いた場合は警告メッセージを表示します。