名称

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. 
リビジョン番号： 4.300 ; リリース日付: 91/06/08 .
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 4.1C