Next: admin, Previous: Global options, Up: CVS commands
ここでは、複数の cvs コマンドで共通に使用できる ‘command_options’ について説明します。 これらのオプションは、 必ず ‘cvs_command’ の右側に付けられます。 以下に示すオプションは、全てのコマンドで使えるわけではありません。 各オプションは、それが意味をなすコマンドにおいてのみ使用可能です。 しかし以下のオプションを持つコマンドがあるならば、 そのオプションは他のコマンドのものと同じ動作であると考えて良いでしょう。 (各コマンドの固有オプションのほとんどは、 他の cvs コマンドのものとは異なる意味を持っています。)
警告: ‘history’ コマンドは例外です。このコマンドには、 ここに示す標準オプションと重複する固有オプションが多くあります。
-D
date_specこのオプションを用いて作業ファイルを取り出すと、
指定した日付が貼り付けられます。
つまり ‘-D’ オプションの引数が記録され、
これ以後の update
の際に同じ日付が用いられます
(貼り付いたタグ/日付についての詳細は see Sticky tags)。
‘-D’ は以下のコマンドで利用できます:
checkout
, diff
, export
, history
,
rdiff
, rtag
, update
.
(history
コマンドはこのオプションを少し違った方法で使用します。
see history options).
cvs では、様々な形式で日付を指定できます。 最も標準的なものは (International Standards Organization による) ISO8601 と (RFC 822 で規定され、RFC1123 で修正された) Internet e-mail の標準です。
ISO8601 はいろんな異種があります。すこし例を挙げます:
1972-09-24 1972-09-24 20:05
ISO8601 の日付様式にはいろいろなものがあり、CVS はそれらの多くを受け付 けますが、おそらくながーい話し全部を聞きたいとは思わないでしょ う :-)。
Internet e-mail で使用が認められている日付に加えて、 cvs では、いくつかのフィールドが省略されたものも使えます。 例えば、以下のようなものです:
24 Sep 1972 20:05 24 Sep
特定の標準時が指定されていない場合は、日付はローカルの標準時として解釈 されます。
この2つの書式の使用が好まれます。しかし、cvs は今は他の日付の書式 を幅広く受け付けます。それらはここでは故意に詳しくは説明されておらず、 cvs の将来のバージョンはそれら全ては受け付けないかもしれません。
そのような書式の中に
月/
日/
年. というものがあります。
これは月と日が逆の順番になっているものに慣れている人を混乱させます。
‘1/4/96’ は1月4日であり、4月1日ではありません。
シェルは空白を引数の区切りにするので、 ‘-D’ の引数を引用符で囲むのを忘れてはいけません。 ‘-D’ オプションを付けたコマンド行は、次の様になるでしょう:
$ cvs diff -D "1 hour ago" cvs.texinfo
-f
‘-f’ のときでさえ、指定したタグは存在していなければならないことに 注意してください (すなわち、必ずしも全てのファイルというわけではなく、 いくつかのファイルにおいて)。 これは cvs が、名前の入力を間違えた ときにエラーを出すことを続けられるようにするためです。
‘-f’ は以下のコマンドで利用できます:
annotate
, checkout
,
export
, rdiff
, rtag
, update
.
警告: commit
と remove
コマンドにも ‘-f’
オプションがありますが、異なる動作をします。See commit options,
Removing files 参照。
-k
kflagこのオプションを用いて作業ファイルを取り出すと、
kflag が貼り付けられます。
つまり、このオプションを checkout
や update
コマンドに
用いた場合、cvs は指定した kflag をそのファイルに結合します。
これ以後、同ファイルに対する update
コマンドには
kflag が使用され続けます。
この効果は別の指定を行なうまで止みません。
‘-k’ オプションは以下のコマンドで利用できます: add
,
checkout
, diff
, import
, update
.
-l
警告: ‘cvs_command’ の左側に指定する ‘cvs -l’ と混同しないようにして下さい。
以下のコマンドで利用できます: annotate
, checkout
,
commit
, diff
, edit
, editors
,
export
, log
, rdiff
, remove
, rtag
,
status
, tag
, unedit
, update
, watch
,
and watchers
.
-m
message-m
message以下のコマンドで利用できます: add
,
commit
, import
.
-n
checkout
/commit
/rtag
コマンド実行時に、
常には実行されるプログラムを実行しません。
各コマンド実行時のプログラムは、
管理用ファイル modules に記述されます
(see modules)。
つまり、このオプションは modules の記述を無効にします。
警告: ‘cvs_command’ の左側に指定する ‘cvs -n’ と混同しないようにして下さい。
以下のコマンドで利用できます:
checkout
, commit
, export
,
rtag
.
-P
-p
以下のコマンドで利用できます: checkout
, update
.
-R
以下のコマンドで使用可能です: annotate
, checkout
,
commit
, diff
, edit
, editors
,
export
, rdiff
, remove
, rtag
,
status
, tag
, unedit
, update
, watch
,
watchers
.
-r
tagtag
か rtag
コマンドで任意に定義されたタグの他に、
二つの特別なタグ ‘HEAD’ と ‘BASE’ が常に利用できます。
‘HEAD’ は、リポジトリにある最新のリビジョンを参照します。
‘BASE’ は、作業コピーの由来となるリビジョンを参照します。
タグを指定して checkout
や update
コマンドを実行し、
自分の作業ファイルを作った場合、そのタグは貼り付けられます。
つまりこのタグが記録され、以後他のものを指定するまで
update
に同じタグが使われ続けます
(貼り付いたタグ/日付についての詳細は see Sticky tags)。
tag には、Tags で説明されているような文字列や、 Branching and merging で説明されているような枝の名前のどちらであ ることもできます。
コマンド・オプション ‘-r’ と一緒に 広域オプション ‘-q’ を指定すると、 rcs ファイルが指定したタグを含まない場合に、 警告出力が抑止されるので便利です。
警告: ‘cvs_command’ の左側に指定する ‘cvs -r’ と混同しないようにして下さい!
‘-r’ は以下のコマンドで利用できます :checkout
,
commit
, diff
, history
, export
,
rdiff
, rtag
, update
.
-W
以下のコマンドで利用できます: import
, update
.