名称

rlog − RCS ファイルに関するログメッセージおよび他の情報をプリントする

形式

rlog [ options ] file ... 

解説

rlog は、RCS ファイルに関する情報をプリントします。 ‘,v’ で終わるファイルは RCS ファイルで、 その他のファイルは作業ファイルを意味します。 作業ファイルが与えられた場合には、 rlog コマンドは、co(1) で説明したように、 最初にディレクトリ ./RCSで、 次にカレントディレクトリで作業ファイルに対応する RCS ファイルを捜します。
 
rlog は、各 RCS ファイルごとに次のような情報をプリントします。 即ち、RCS ファイル名、作業ファイル名、 ヘッド（トランクの最新のリビジョン番号）、アクセスリスト、ロック、 シンボリック名、サフィックス、リビジョンの合計数、 プリントのため選択されたリビジョンの数、記述文などです。 これには、各ブランチに対して逆年代順に選択された リビジョンのエントリが続きます。 各リビジョンに対して rlog はリビジョン番号、著者、日付/時刻、 ステータス、追加／削除された行数（前のリビジョンとの関連）、 リビジョンをロッカー（ロックした人。もしある場合）、 およびログメッセージをプリントします。 オプションがなければ、rlog はすべての情報をプリントします。 次のオプションはこのような出力を制御します。

−L ロックをしていない RCS ファイルを無視します。 オプション −R、−h あるいは −l と共に使うと便利です。

−R RCS ファイル名だけプリントします。 作業ファイル名を RCS ファイル名にリネームするとき、便利です。

−h RCS ファイル名、および作業ファイル名、ヘッド、アクセスリスト、ロック、 シンボリック名、サフィックスだけをプリントします。

−t オプション −h と同じ項目に、記述文を加えてプリントします。

−ddates 指定範囲内のチェックイン日付/時刻を持つリビジョンについて、 情報をプリントします。 指定範囲は、セミコロンで区切られた date の リストによって与えられます。 d1<d2 あるいは d2>d1 という形式の範囲は、 d1 と d2 の間に保管されている リビジョンを選択します（包括的に）。 <d あるいは d> という形式の範囲は、 日付 d 以前のすべてのリビジョンを選択します。 d< あるいは >d という形式の範囲は、 日付 d 以後のすべてのリビジョンを選択します。 d だけの形式の範囲は、 日付 d 以前のリビジョンの中で最新のリビジョン１つを選択します。 日付/時間を表す文字列 d、d1 および d2 は、 co(1)で説明したようにフリーフォーマットです。 クォーティングは一般的に必要で、 特に < および > を使う場合には必須です。 セパレータはセミコロンであることに注意してください。

−l[lockers]
ロックされたリビジョンについての情報をプリントします。 コンマで区切られたロッカー（ロックした人）のログイン名 のリストが与えられた場合には、 指定されたログイン名によってロックされた リビジョンだけプリントされます。 もしリストが省略された場合には、 すべてのロックされたリビジョンがプリントされます。

−rrevisions
指定範囲のリビジョンについて、情報をプリントします。 指定範囲は、コンマで区切られたリスト revisions の中に 与えられます。rev1−rev2 という範囲は、 同じブランチ内の rev1 から rev2 までのリビジョンを意味し、 −rev という範囲はブランチの 最初から rev リビジョンまでを意味し、 rev− という範囲は rev から ブランチの最後までのリビジョンを意味します。 引数がブランチのときは、 そのブランチ中のすべてのリビジョンを意味します。 ブランチの範囲は、その範囲のブランチのすべてのリビジョンを意味します。

−sstates 指定するステータスの１つとステータス 属性がマッチするリビジョンについて、 情報をプリントします。 ステータスの指定は、コンマで区切られたリスト states で与えられます。

−w[logins]
指定されたログイン名のユーザによって チェックインされたリビジョンについて、情報をプリントします。 ログイン名の指定は、 コンマで区切られたログインリスト logins で与えられます。 logins が省略された場合には、ユーザのログイン名とみなされます。
 
rlog は、−b および −r に よって選択されたリビジョンの集合の中から、 −d、および −l、−s、−w に よって選択されたリビジョンの共通点をプリントします。

例

rlog  −L  −R  RCS/∗,v
rlog  −L  −h  RCS/∗,v
rlog  −L  −l  RCS/∗,v
rlog  RCS/∗ ,v

最初のコマンドは、サブディレクトリ ‘RCS’ の中でロックされている すべての RCS ファイル名をプリントします。 2番目のコマンドは、それらのファイルのヘッダをプリントします。 3番目のコマンドは、ヘッダに加えてロックされた リビジョンのログメッセージをプリントします。 最後のコマンドは完全な（すべての）情報をプリントします。

診断

終了ステータスは、最後に操作された RCS ファイルを参照します。 操作が成功した場合には 0、そうでない場合には 1 です。

識別

著者： Walter F. Tichy, Purdue University, West Lafayette, IN, 47907. 
リビジョン番号： 3.2 ; リリース日付: 83/05/11 .
Copyright © 1982 by Walter F. Tichy.

関連事項

ci (1), co (1), ident(1), rcs (1), rcsdiff (1), rcsintro (1), rcsmerge (1), rcsfile (5), sccstorcs (8). 
Walter F. Tichy, "Design, Implementation, and Evaluation of a Revision Control System," in Proceedings of the 6th International Conference on Software Engineering, IEEE, Tokyo, Sept. 1982. 

NEWS-OSRelease 3.3