Provided by: manpages-ja_0.5.0.0.20221215+dfsg-1_all
名称
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 オプションにおけるリビジョンの区切りは - でした。 しかし、これはシ ンボリック名が - を含んでいるときに混乱を生じます。 従来の版との互換性のため、 - を用いた 記法もサポートしますが、この記法を用いた場合は 警告メッセージを表示します。