ci - クラウドでオンライン

プログラム：

NAME

ci-RCSリビジョンをチェックインします

SYNOPSIS

ci [オプション] file ...

DESCRIPTION

ci 新しいリビジョンを RCS ファイルに保存します。 RCS サフィックスに一致する各ファイル名が取得されます
RCSファイルである。 他のすべては、新しいリビジョンを含む作業ファイルであると見なされます。 ci
各作業ファイルの内容を対応するRCSファイルに保管します。 だけなら
作業ファイルが与えられ、 ci RCSサブディレクトリで対応するRCSファイルを見つけようとします
次に、作業ファイルのディレクトリに。 詳細については、以下のファイルの命名を参照してください。

ci アクセスリストが機能するためには、アクセスリストを除いて、発信者のログインがアクセスリストに含まれている必要があります。
が空であるか、呼び出し元がスーパーユーザーまたはファイルの所有者です。 新しいを追加するには
既存のブランチへのリビジョンの場合、そのブランチのチップリビジョンはによってロックされる必要があります
発信者。 それ以外の場合は、新しいブランチのみを作成できます。 この制限は適用されません
非厳密ロックが使用されている場合は、ファイルの所有者用（を参照） RCS（1））。 によって保持されているロック
他の誰かが壊れる可能性があります RCS

を除いて -f オプションが与えられ、 ci 寄託するリビジョンが異なるかどうかをチェックします
前のもの。 そうでない場合は、新しいリビジョンを作成する代わりに ci 前に戻る
XNUMX。 元に戻すには、通常 ci 作業ファイルとロックを削除します。 ci -l 維持し、 ci -u
ロックを解除すると、どちらもあたかも新しい作業ファイルを生成するかのようになります co -l or co -u
以前のリビジョンに適用されていました。 元に戻すときは、 -n および -s オプションが適用されます
前のリビジョンに。

寄託された改訂ごとに、 ci ログメッセージの入力を求めます。 ログメッセージは
変更を要約し、ファイルの終わりまたは以下を含む行で終了する必要があります . by
自体。 複数のファイルがチェックインされている場合 ci 以前のログを再利用するかどうかを尋ねる
メッセージ。 標準入力が端末でない場合、 ci プロンプトを抑制し、
すべてのファイルに同じログメッセージ。 も参照してください -m.

RCSファイルが存在しない場合は、 ci それを作成し、作業の内容を預けます
初期リビジョンとしてのファイル（デフォルト番号： 1.1）。 アクセス リストは次のように初期化されます。
空の。 ログメッセージの代わりに、 ci 説明テキストを要求します（を参照） -t 下）。

数 回転 寄託されたリビジョンの任意のオプションで指定できます -f, -i, -I,
-j, -k, -l, -M, -q, -rまたは -u. 回転 シンボリック、数値、または混合にすることができます。 の記号名
回転 すでに定義されている必要があります。 を参照してください -n および -N チェックイン時に名前を割り当てるためのオプション。
If 回転 is $, ci 作業ファイルのキーワード値からリビジョン番号を決定します。

If 回転 ピリオドで始まり、デフォルトのブランチ（通常はトランク）の前に
それ。 場合 回転 ブランチ番号の後にピリオドが続き、その最新のリビジョンです。
ブランチが使用されます。

If 回転 はリビジョン番号であり、ブランチの最新のものよりも大きい必要があります
回転 所属しているか、新しいブランチを開始する必要があります。

If 回転 はリビジョン番号ではなくブランチであり、新しいリビジョンがそれに追加されます
ブランチ。 レベル番号は、そのチップのリビジョン番号をインクリメントすることによって取得されます
ブランチ。 もしも 回転 存在しないブランチを示し、そのブランチは最初のブランチで作成されます
リビジョン番号付き 回転.1.

If 回転 省略、 ci 呼び出し元の最後のロックから新しいリビジョン番号を取得しようとします。
呼び出し元がブランチのヒント リビジョンをロックしている場合、新しいリビジョンが追加されます
そのブランチ。 新しいリビジョン番号は、チップリビジョン番号をインクリメントすることによって取得されます。
呼び出し元が非ヒント リビジョンをロックした場合、新しいブランチがそのリビジョンで開始されます。
そのリビジョンで最大のブランチ番号をインクリメントします。 デフォルトの初期ブランチと
レベル番号は 1.

If 回転 は省略され、呼び出し元はロックを持っていませんが、ファイルを所有しており、ロックがに設定されていません
厳格な、次にリビジョンがデフォルトのブランチ（通常はトランク。を参照）に追加されます。
-b のオプション RCS（1））。

例外：トランクでは、リビジョンを最後に追加できますが、挿入することはできません。

OPTIONS

-r回転 リビジョンをチェックイン 回転.

-r 裸 -r オプション（リビジョンなし）は、 ci。 他の人と
RCS コマンド、むき出しの -r オプションは、デフォルトの最新のリビジョンを指定します
分岐しますが、 ci、裸 -r オプションは、のデフォルトの動作を再確立します
ロックを解除して作業ファイルを削除し、デフォルトを上書きするために使用されます
-l or -u シェルエイリアスまたはスクリプトによって確立されたオプション。

-l[回転]
のように動作します -r、追加の実行を除いて co -l 寄託された改訂について。
したがって、デポジットされたリビジョンはすぐに再度チェックアウトされ、ロックされます。 これは
後で編集を続けたいが、リビジョンを保存するのに便利です。
チェックイン。

-u[回転]
のように動作します -lただし、デポジットされたリビジョンはロックされていません。 これにより、
チェックイン後すぐに作業ファイルを読んでください。

　 -l、裸 -r, -u オプションは相互に排他的であり、それぞれをサイレントにオーバーライドします
他の。 例えば、 ci -u -r に相当します ci -r むき出しだから -r オーバーライド -u.

-f[回転]
預金を強制します。 新しいリビジョンは、それが
前のもの。

-k[回転]
作業ファイルでキーワード値を検索して、リビジョン番号を決定します。
作成日、状態、および作成者（を参照） co（1））、これらの値をに割り当てます
ローカルで計算するのではなく、寄託されたリビジョン。 また、
発信者のログインと実際のチェックイン日を示すデフォルトのログインメッセージ。
このオプションは、ソフトウェアの配布に役立ちます。 に送信されるリビジョン
いくつかのサイトをチェックインする必要があります -k これらのサイトで保存するオプション
元の番号、日付、作成者、および状態。 抽出されたキーワード値と
デフォルトのログメッセージは、オプションで上書きできます -d, -m, -s, -w、そしてany
リビジョン番号を含むオプション。

-q[回転]
クワイエットモード; 診断出力は印刷されません。 変わらないリビジョン
前のものからの預金は、 -f 与えられます。

-i[回転]
初期チェックイン; RCSファイルがすでに存在する場合は、エラーを報告してください。 これはレースを回避します
特定のアプリケーションの条件。

-j[回転]
チェックインするだけで初期化しないでください。 RCSファイルがエラーを報告しない場合はエラーを報告する
すでに存在しています。

-I[回転]
インタラクティブモード; 標準入力が
ターミナルではありません。

-d[date]
使用されます date チェックインの日時について。 の date 自由形式で次のように指定されます
で説明 co（1）。 これは、チェックイン日について嘘をついたり、 -k if
日付はありません。 もしも date 空、作業ファイルの最後の時刻
変更が使用されます。

-M[回転]
新しい作業ファイルの変更時刻を、取得した日付に設定します
リビジョン。 例えば、 ci -d -M -u f 変わらない fの変更時間
fキーワード置換により内容が変更されます。 このオプションは注意して使用してください。 できる
混乱させる makeとします。

-m[MSG]
文字列を使用します MSG チェックインしたすべてのリビジョンのログメッセージとして。 MSG is
省略した場合、デフォルトで「*** empty log message ***」になります。 慣例により、メッセージをログに記録します
で始まる # コメントであり、GNUEmacsのようなプログラムでは無視されます vc
パッケージ。 また、で始まるログメッセージ {クランプ名} (空白が続きます)
それらが関連付けられている場合でも、可能であれば一緒に凝集することを意図しています
異なるファイル; the {クランプ名} ラベルは凝集にのみ使用され、
ログメッセージ自体の一部と見なされます。

-n名 記号名を割り当てます 名 チェックインされたリビジョンの番号に。 ci プリント
次の場合のエラーメッセージ 名 すでに別の番号に割り当てられています。

-N名 と同じ -nの以前の割り当てをオーバーライドすることを除いて、 名.

-s状態
チェックインされたリビジョンの状態を識別子に設定します 状態。 デフォルト
状態は EXP.

-tfile 名前付きの内容から説明テキストを書き込みます file RCSファイルに、
既存のテキストを削除します。 The file で始めることはできません -.

-NS-文字列
から説明文を書く 文字列 RCSファイルに追加し、既存のファイルを削除します
テキスト。

　 -t オプションは、どちらの形式でも、最初のチェックイン時にのみ有効です。 それは
それ以外の場合は黙って無視されます。

最初のチェックイン時に、 -t 与えられていない、 ci 標準からテキストを取得します
入力、ファイルの終わりまたは次の行で終了 . それ自体で。 ユーザーは
対話が可能な場合、テキストの入力を求められます。 見る -I.

古いバージョンのRCSとの下位互換性のために、ベア -t オプションは無視されます。

-T 前者の場合は、RCSファイルの変更時刻を新しいリビジョンの時刻に設定します
後者に先行し、新しい改訂があります。 RCSファイルを保持します
それ以外の場合は変更時間。 リビジョンをロックしている場合は、 ci 通常は更新します
ロックが
RCS ファイルとロックを削除するには、RCS ファイルを変更する必要があります。 これにより、
XNUMXつの方法のいずれかで作業ファイルよりも新しいR​​CSファイル：最初に、 ci -M を作成することができます
現在の時刻より前の日付の作業ファイル。 第二に、に戻るとき
以前のリビジョンでは、作業ファイルを変更せずにRCSファイルを変更できます。
これらのXNUMXつのケースは、 make（1）の依存関係
RCSファイルの作業ファイル。 The -T オプションは、この再コンパイルを禁止します
RCSファイルの日付について嘘をついている。 このオプションは注意して使用してください。 抑制できる
ある作業ファイルのチェックインが別の作業ファイルに影響を与える場合でも再コンパイル
同じRCSファイルに関連付けられたファイル。 たとえば、RCSファイルの時刻を想定します
は01:00、（変更された）作業ファイルの時刻は02:00、その他のコピー
作業ファイルの時刻は 03:00 で、現在の時刻は 04:00 です。 それで ci -d -T
RCSファイルの時刻を通常の02:00ではなく04:00に設定します。 これは〜をひき起こす make(1)
他のコピーがRCSファイルよりも新しいと（誤って）考えること。

-wログイン
使用されます ログイン 寄託された改訂の著者フィールド用。 嘘をつくのに便利
著者、そしてのために -k 著者がいない場合。

-V RCSのバージョン番号を印刷します。

-Vn RCSバージョンをエミュレートする n。 見る co詳細は（1）。

-x接尾辞
RCS ファイルのサフィックスを指定します。 空でないサフィックスは、任意のファイル名と一致します
サフィックスで終わります。 空のサフィックスは、フォームの任意のファイル名と一致します RCS /断片
or フラグ1/RCS/フラグ2。 　 -x オプションは、で区切られたサフィックスのリストを指定できます /.
たとえば、 -x、v / XNUMXつのサフィックスを指定します。 ,v と空の接尾辞。 XNUMXつ以上の場合
サフィックスが指定されている場合、RCSファイルを検索するときに順番に試行されます。 the
最初に機能するものがそのファイルに使用されます。 RCS ファイルが見つからず、RCS ファイルが見つかった場合
ファイルを作成できる場合、新しい RCS を決定するためにサフィックスが試行されます
ファイルの名前。 のデフォルト 接尾辞 インストールに依存します。 通常はそうです
、v / ファイル名にコンマを使用でき、空である (つまり、単に
空の接尾辞) を他のホストに割り当てます。

-zゾーン キーワード置換で日付出力形式を指定し、デフォルトを指定します
のタイムゾーン date セクションに -ddate オプション。 ザ· ゾーン 空である必要があります、数値UTC
オフセット、または特別な文字列 LT 現地時間。 デフォルトは空です ゾーン,
これは、タイムゾーンの表示なしでUTCの従来のRCS形式を使用します。
日付の部分をスラッシュで区切ります。 それ以外の場合、時間はISOで出力されます
タイムゾーン表示付きの8601形式。 たとえば、現地時間が11月XNUMX日の場合、
1990年、太平洋標準時の午後8時、UTCの西XNUMX時間、時刻が出力されます
次のように：

オプション 時間 出力
-z 1990/01/12 04:00:00 （デフォルト）
-zLT 1990-01-11 20：00：00-08
-z + 05：30 1990-01-12 09:30:00+05:30

　 -z このオプションは、常にUTCであるRCSファイルに保存されている日付には影響しません。

FILE ネーミング

RCSファイルと作業ファイルのペアはXNUMXつの方法で指定できます（例も参照してください）
セクション）。

1）RCSファイルと作業ファイルの両方が提供されます。 RCSファイル名の形式は
フラグ1/ワークファイルX 作業ファイル名は次の形式です フラグ2/ワークファイル コラボレー フラグ1/ および
フラグ2/ （おそらく異なるか空の）ファイル名であり、 ワークファイル はファイル名であり、 X あります
RCS サフィックス。 もしも X 空です、 フラグ1/ で始まる必要があります RCS / または含まれている必要があります /RCS/.

2）RCSファイルのみが提供されます。 次に、作業ファイルが現在のディレクトリに作成されます
その名前は、RCS ファイル名から フラグ1/ とサフィックス X.

3) 作業ファイルのみが提供されます。 それで ci 各RCSサフィックスを考慮します X 順番に、見て
フォームのRCSファイルの場合 フラグ2/RCS/ワークファイルX または（前者が見つからず、 X is
空でない） フラグ2/作業ファイルX.

1）および2）でRCSファイルがファイル名なしで指定されている場合、 ci RCSファイルを探します
ディレクトリの最初に ./RCS 次に、現在のディレクトリにあります。

ci RCSファイルを開こうとして異常な理由で失敗した場合、たとえ
RCSファイルの名前は、いくつかの可能性のXNUMXつにすぎません。 たとえば、の使用を抑制するために
ディレクトリ内のRCSコマンド d、という名前の通常のファイルを作成します d/ RCS カジュアルな試み
RCS コマンドを使用するには d 失敗する理由 d/ RCS ディレクトリではありません。

例

仮に ,v はRCSサフィックスであり、現在のディレクトリにはサブディレクトリが含まれています RCS ととも​​に
RCSファイル io.c,v。 次に、次の各コマンドは、のコピーをチェックインします。 io.c に
RCS / io.c、v 最新のリビジョンとして、削除 io.c.

ci io.c; ci RCS / io.c、v; ci io.c、v;
ci io.c RCS / io.c、v; ci io.c io.c、v;
ci RCS / io.c、v io.c; ci io.c,v io.c;

代わりに、空のサフィックスがRCSサフィックスであり、現在のディレクトリに次のものが含まれているとします。
サブディレクトリ RCS RCSファイルで io.c. 次の各コマンドは、
新しいリビジョン。

ci io.c; ci RCS/io.c;
ci io.c RCS/io.c;
ci RCS/io.c io.c;

FILE モード

によって作成された RCS ファイル ci 作業ファイルから読み取り権限と実行権限を継承します。
RCSファイルがすでに存在する場合は、 ci 読み取り権限と実行権限を保持します。 ci 常に
RCSファイルのすべての書き込み権限をオフにします。

onworks.netサービスを使用してciをオンラインで使用する