patcol - クラウド上のオンライン

プログラム：

NAME

pat-パッチジェネレータツール

SYNOPSIS

パット [ -ああんV ] [ ファイルリスト ]
パチル [ -abfhnpqsV ] [ ファイルリスト ]
パディフ [ -アーンV ] [ ファイルリスト ]
パットベース [ -ああV ] [ ファイルリスト ]
パトログ [ -hnruV ]
パットメイク [ -hV ]
パッセンド [ -hiquV ] [ パッチリスト ] [ 受信者 ]
通知する [ -hquV ] [ 受信者 ]
パットポスト [ -hrV ] パッチリスト ニュースグループ
パットFTP [ -hV ] [ パッチリスト ]
パット名 [ -アンムV ] -v バージョン [ ファイルリスト ]
パットスナップ [ -ああV ] [ -o スナップショット ] [ ファイルリスト ]
パトコル [ -achnmsCV ] [ -d ディレクトリにジョブを開始します。 ] [ -f 手 ] [ -S スナップ ] [ ファイルリスト ]
パットクリーン [ -アンムV ] [ ファイルリスト ]
パットインデックス

DESCRIPTION

パット およびそれに関連するプログラムは、保存されているパッケージのパッチを生成します
RCSの下で。 これらのプログラムは、次の場合に邪魔になるRCSの詳細の多くを隠します。
パッケージの構築と保守。 新しいパッチを作成するために必要なのは、
ファイルを編集し、patを実行し、RCSと生成されたパッチにいくつかの説明を提供します
ファイル。 新しいRCSファイルを初期化する方法、コメント文字列の内容などの詳細
新しいブランチを作成する方法、サブディレクトリを処理する方法、差分を実行する方法、および
パッチファイルの整理は自動的に処理されます。

patプログラムを使用する前に、packinitを実行してパッケージを初期化する必要があります。
パッケージの最上位ディレクトリにあります。 これにより、すべての.packageファイルが生成されます。
distプログラムはを利用します。

ファイルリストが必要なプログラムのいずれかで、 -a 代わりに、
MANIFEST.newが処理されます。 パッチリストが必要なプログラムでは、null
patchlistは、現在のパッチを意味します。 ハイフン、コンマ、スペースを使用して区切ることができます
パッチ番号。 ハイフンの右側がヌル文字列の場合、現在のパッチレベル
最大値として想定されます。 で呼び出されるすべてのプログラム -h 小さな使用法を印刷します
使用可能な各オプションの意味を示すメッセージ。 NS -V オプションは現在を与えます
バージョンナンバー。

Pat自体は、patcil、patdiff、およびpatmakeを呼び出すラッパープログラムです。 通常はできます
patを呼び出して、他のすべてを無視するだけです。 Patは、マニフェストファイルを更新します。
必要（マニフェストが提供されている場合は、MANIFEST.newファイルの正確なコピーになります）
すでに存在していました）、最終的にはそれにpatcilを呼び出します。

指定した場合 -n ファイルリストの代わりに、patはより新しいすべてのファイルを検索します
patchlevel.hで、エディターに移動してリストを縮小し、そのファイルリストを使用します。 もしも
リストのすべてのファイルが削除され、 パット 中止されます。

パチル リストされたファイルに対してci-lを実行するために使用されます。 （あなたは常にしたいことを前提としています
ファイルをチェックアウトしておいてください。） -a スイッチ、あります -b どのスイッチ
一連のファイルのクイックチェックインを実行します。 各ファイルでrcsを呼び出す代わりに、rcsを呼び出します
ファイルの全リストにあります。 これは、トランクリビジョンをチェックインする場合に役立ちます。 あなたが
新しいトランクリビジョンをチェックインしている場合は、 -s フラグ
以前のリビジョンから古いRCSログエントリを削除して、最初からやり直すことができるようにします。
おそらく、 -f これはciに渡され、変更されません。
チェックインするファイル。新しいトランクリビジョンをチェックインするには、

パチル -s -f -a

Patcilは、ciにやらせる代わりにログエントリを要求し、少しプロンプターがあります
さまざまな方法でメッセージを操作できるようにする組み込み。 のリストを表示するには、hと入力します
あなたができること。 最も優れた点のXNUMXつは、エディターにポップアップできることです。
オプションで、前回のパッチ以降の変更の差分リストを使用します。
何を変えたか忘れてしまいました。 最初にCRを入力すると、前のCRが含まれます
ログメッセージ。 CRを使用してプロンプターを終了します。

patcilを使用するにはXNUMXつの異なる方法があります。 自分でpatcilに電話するか、
パットはあなたのためにそれを呼び出します。 patを実行する前にpatcilを何度呼び出すかは関係ありません。
patdiffは、最後のパッチベースが何と比較されるかを知っているからです。 Patcilはで呼び出すことができます
任意のディレクトリ。 他のプログラムは、最上位ディレクトリで呼び出す必要があります（または
バグの場合、意味がある場合）。

特定のパッチレベルで新しいファイルを作成する場合は、 -p
オプション。 それ以外の場合は、新しいトランクリビジョンとしてチェックインされます。 の名前
ファイルがまだMANIFEST.newに表示されていない場合は、MANIFEST.newに追加されます。 名前が
説明と一緒に見つかった場合、その説明はrcsに渡されて適切に処理されます
RCSファイルを初期化します。

パトベース 廃棄したときにパッチベースを現在のバージョンにリセットするために使用できます
以前のパッチシーケンスと新しい配布キットを作成しています。 それが実際に行うことは
rcs -Nlastpat：REV。ここで、REVは現在のリビジョンです。 patdiffが爆破し、必要な場合
パッチベースを以前のバージョンに戻すには、rcs -Nlastpat：REVを呼び出す必要があります
あなた自身。

パディフ 実際にパッチに含まれるdiffを実行し、バージョンを比較します
-Nlastpatは、最後にチェックインされたバージョンを指します。 次に、-Nlastpatを更新します
現在のバージョンをポイントします。 差分をバグサブディレクトリに残します
拾うpatmake。 rcsdiff、または指定した選択したdiffコマンドのいずれかを使用できます
packinitを実行するとき、diffがrcsdiffよりも優れている場合に備えて。

パトログ によって呼び出されます パットメイク 通常、更新するには 変更履歴 ファイル（またはその名前
あなたが走ったときにファイルが与えられました パックイット）。 ログメッセージを収集し、起動します
必要な更新を行うためのエディタ。 パッケージを次のように構成した場合
RCSログをに含める 変更履歴、それらのために別のエディターセッションが開始されます。
最後に、最終ログがの候補エントリとして作成されます 変更履歴、あなたもそうかもしれません
必要に応じて変更します。

を構成していない場合 変更履歴 ファイル、 パトログ 情報のみを収集します
に渡す必要があります パットメイク 終了します。 自分で呼びたい場合は、
少なくともXNUMX回成功した後にそれを行う パディフ 走る。 私は使用することをお勧めします -n オプション
初めて、そしてそれから使用します -u オプションと一緒に -n ファイルを再作成するための後続の実行時
必要な場合のみ。 NS -r オプション（これは優先されます -u) 防止します パトログ 再作成から
古いファイルであっても、既存のファイル。

パトログ 電話します パチル と パディフ あなたの上 変更履歴 ファイル（詰め込んだ後
ファイルの先頭で編集した候補ログエントリ）。
-n オプション。 これは、発行されたパッチが更新されることを意味します 変更履歴 現在のパッチで
あなたがそれを期待するように、情報。

パトメイク パッチのすべての部分をXNUMXつのファイルに結合し、エディターを呼び出すので、
件名と説明を追加できます。 すべてのログメッセージをサブジェクトとしてスローし、
説明として、不要なものを削除する方が簡単であるという前提の下で
あなたがしたことすべてを覚えています。 説明の各項目も展開する必要があります
そのため、件名を繰り返すだけではありません。 あなたが持っている場合 変更履歴 ファイル、これは持っている必要があります
すでに行われている、またはあなたの 変更履歴 で説明されていることを正確に表していない
パッチは、次の場合にすでに更新されているため、 パットメイク すべてをまとめる
ピース（についてのメモを参照してください パトログ 上記）。

各パッチのサイズを適切なサイズに保つために、大きなパッチは分割されます。 この
自動的に処理されるので、気にする必要はありません。 各パッチの優先度
単に直感的です パットメイク、小さな変更には大きな変化があるという仮定を考えると
優先度。

Patsend、patpost、およびpatftpは、パッチを世界中に配布するために使用されます。 パッセンド
一連のパッチを一連の受信者にメールで送信します。 NS -u スイッチは現在すべてを追加します
パッチの郵送を要求した登録ユーザー、および
実行中に指定された受信者 パックイットを選択します。 -i スイッチには情報が含まれています
ユーザーが将来のパッチを受け取らないように自分自身の登録を解除する方法に関するパッチ
自動的; これは、 -u スイッチを使用します。 パットポスト セットを投稿する
ニュースグループのセットへのパッチの。 パットFTP パッチをパブリックFTPにコピーするだけです
ディレクトリにあります。

パトノティファイ 新しいパッチがリリースされたことをユーザーに通知するだけで、
興味があれば、アーカイブサイトから、または電子メールで自分で取得してください。 NS
-u スイッチを使用して、要求した現在登録されているすべてのユーザーを含めることができます
そのような通知。 メッセージには、パッチの優先度と説明、および
パッチを自動的にリクエストする方法の説明（これは、パッチを持っている場合にのみ機能します
メールエージェント インストールされています）。

両方 パッセンド と 通知する 実際に何かを送信する前に、アドレスリストを編集できます。
追加しない限り -q オプションを選択します。

パットネーム シンボリック名（で指定された）でファイルのセットにタグを付けるために使用できます -v）。 この
各ファイルの最新リビジョンの名前を設定します。

パットスナップ SNAPSHOTファイルを作成することでリリースのスナップショットを取得します（名前は
経由で変更 -o）ファイル名とそのファイルの最新のRCSリビジョン番号を一覧表示します。
このようなスナップショットを使用して、ランダムなパッチレベルでリリースを識別してから、
後でスナップショットファイルをにフィードすることで取得できます パトコル.

パトコル ロックされたバージョンのファイルを、最終的には別のディレクトリにチェックアウトします
（で指定 -d、したがって、配布ツリーをミラーリングします）。 ないすべてのファイル
RCSの対応物（例：patchlevel.h）は、patcolによって単純にコピーされます。 これはによって使用されます
キットを作成する前にディストリビューションを偽造するmakedist。 デフォルトでは、patcolは実行しません
著作権拡張処理ですが、クライアントは 作成日 そのを使用してそれを強制します -C
オプション。 または、チェックアウトしたバージョンをディレクトリに強制的にコピーすることもできます
使用して、 -c と連動して切り替える -d （または以前のスイッチは単に無視されます）。

パトコル SNAPSHOTファイルからファイルリストを取得することもできます。 -S スイッチ、その場合
スナップショットファイルで指定されたRCSバージョンを使用してファイルをチェックアウトします。
によって作成されたもの パットスナップ。 代わりに指定することができます -a, -m or -n それぞれすべてを使用するには
MANIFEST.new内のファイル、すべての変更されたファイル（ パチルed）、またはすべて
より新しいファイル パッチレベル.h.

パトクリーン すべての変更をチェックインした後、作業ファイルを削除します。 してもいいです
patcolを使用して作業ファイルを復元します。

パットインデックス トップレベルのディレクトリから、または バグ ディレクトリ。 そうなる
すべてのパッチとそのリスト 件名： 行。 このプログラムは圧縮パッチについて知っています
リストの作成中にそれらを解凍します。

RCS LAYER

このセクションでは、ツール内の何かが壊れた場合に備えて、RCSレイヤーについて説明します。
RCSファイルを修正して操作を再開する場合があります。

すべてのパッチツールは、メインのRCSトランクリビジョン番号を取得します 。パッケージ ファイル、言う
2.5です。 そして、あなたが走ったとき パックイット、パッチのブランチを選択しました。
通常は1番です。これは、すべての変更が2.5.1RCSに保存されることを意味します。
ブランチ。 時が来れば、ツールがブランチを作成します。

最後にリリースされた各リビジョンは、RCSでタグ付けされています ラストパット シンボル。 パッチが作成されたとき
by パディフ、2.5.1ブランチの最新バージョンは、次のようにタグ付けされたバージョンと比較されます。
ラストパット。 これが、複数の問題を安全に発行できる理由です。 パチル パッチを発行する前に
それでもすべてうまくいきました。 もちろん パディフ 移動します ラストパット タグを
特定のファイルを処理した後の最新のブランチリビジョン。

すべてのログメッセージと変更されたファイルは、 バグ ディレクトリ、非表示
ファイル（ドットで始まる名前）。 これらのログは、パッチが発行されたときに収集されます
変更されたファイルはによって使用されます パット's -m スイッチ。

パディフ パッチハンクを下に収集します バグ ディレクトリ、で終了するファイル内 .nn
拡張子、ここで nn 現在のパッチレベル+1を表します（これは次のパッチになります
パッチが作成されるときのパッチレベル パットメイク、大きすぎてXNUMXつに収まらない場合を除きます
ファイル）。

パトログ のためのファイルのセットを準備します パットメイク： .詰まり ファイルは次の情報を収集します
パッチ内の[説明：]セクションに移動し、 .xlog 収集するもの
変更履歴 候補エントリ。 ついに、 .rlog ファイルには、RCS情報が格納されます
に含まれる 変更履歴、要求された場合。 一番上のXNUMX行はゴミであり、
これらのファイルを処理するすべてのツールによって無視されます。

新しいベースラインを開始するために（つまり、RCSトランクのリビジョン番号を変更するために）、
再実行する必要があります パックイット その番号を変更します。 次に、新しいを発行します パチル、おそらく
-s, -a と -f オプション...

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