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
- デフォルト枝に関する情報を表示します。通常は、幹の最も大きな番号を持つ枝
です。
-
-ddates
- セミコロンで区切られた、登録日時の範囲にあるリビジョンに関する情報を
表示します。
d1<d2 または
d2>d1
なる形式の範囲は、日時
d1 から日時 d2
までの間 (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
を起動したユーザ名が用いられます。
- -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 で、伝統的な UTC の
RCS
形式ですが、タイムゾーンを示す表示はなく、
日付の部分を分割するのにスラッシュを用います
; 他では、ISO
形式でタイムゾーンの表示と一緒に時間を出力します。
例えば、ローカルタイムが
太平洋標準時の 1990 年 1
月 11 日、午後 8 時で、
UTC から 8
時間、西である(遅れている)場合、時間の出力は以下のようになります
:
option time output
-z 1990/01/12 04:00:00 (default)
-zLT 1990-01-11 20:00:00-08
-z+05:30 1990-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 &
Experience 15, 7 (July 1985), 637-654.
以前の版の
rlog では -r
オプションにおけるリビジョンの区切りは
- でした。
しかし、これはシンボリック名が
-
を含んでいるときに混乱を生じます。
従来の版との互換性のため、
-
を用いた記法もサポートしますが、この記法を用いた場合は
警告メッセージを表示します。