RLOG

Section: User Commands (1)
Updated: 1999/08/27
IndexJM Home Page
 

名称

rlog - 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 時間、西である(遅れている)場合、時間の出力は以下のようになります :

optiontime output-z1990/01/12 04:00:00(default)-zLT1990-01-11 20:00:00-08-z+05:301990-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. 

関連項目

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 & Experience15, 7 (July 1985), 637-654. 

バグ

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


関連キーワード

リビジョン,rlog,ロック,rev,RLOG,ワーク,リスト,コンマ,メッセージ,logins 

Index

名称
書式
解説
使用例
環境変数
診断
作者
関連項目
バグ

This document was created byman2html, using the manual pages.
Time: 15:49:14 GMT, July 11, 2021