ファイルをディポからクライアントワークスペースに取得するには、p4 syncコマンドを発行します。自分のクライアントビューに存在しないファイルを同期させることはできません。クライアントビューの指定について詳しくは、ワークスペースビューを限定するを参照してください。

C:\bruno_ws>p4 sync
//depot/dev/main/bin/bin.linux24x86/readme.txt#1 - added as c:\bruno_ws\dev\main\bin\bin.linux24x86\readme.txt
//depot/dev/main/bin/bin.ntx86/glut32.dll#1 - added as c:\bruno_ws\dev\main\bin\bin.ntx86\glut32.dll
//depot/dev/main/bin/bin.ntx86/jamgraph.exe#2 - added as c:\bruno_ws\dev\main\bin\bin.ntx86\jamgraph.exe
[...]

p4 syncコマンドにより、クライアントワークスペース内のファイルが追加、更新、または削除され、ワークスペースの内容がディポと同期されます。あるファイルがディポ内の特定のサブディレクトリに存在し、そのディレクトリがクライアントワークスペースに存在しない場合、そのディレクトリはファイルを同期するときにクライアントワークスペースに作成されます。ファイルがディポから削除されている場合、p4 syncコマンド実行時にクライアントワークスペースからも削除されます。

ディポ内のファイルの最新リビジョンより前のリビジョンを同期させるには、リビジョン指定子を使用します。例えば、複数リビジョンのあるJamfileの1番目のリビジョンと同期させるには、次のコマンドを発行します。

p4 sync //depot/dev/main/jam/Jamfile#1

詳細については、ファイルリビジョンを指定するを参照してください。

ファイルの集合またはディレクトリ全体を同期させるには、ワイルドカードを使用します。例えば、jamフォルダとその配下にあるすべてのファイルを同期させるには、次のコマンドを発行します。

p4 sync //depot/dev/main/jam/...

詳細については、Perforceのワイルドカードを参照してください。

Perforceサービスでは、ユーザが同期させたリビジョンを記録しています。効率化を図るため、Perforceはすでに同期済みのファイルリビジョンを再度同期しません。手動で(おそらく不用意に)削除したファイルを再度同期するには、p4 syncコマンドの発行時に-fオプションを指定してください。

ファイルをディポに追加するには、ワークスペースでファイルを作成し、p4 addコマンドを発行します。p4 addコマンドにより、ファイルはデフォルト作業中チェンジリストでadd目的の作業状態になります。デフォルト作業中チェンジリストのサブミットが成功したとき、ファイルが追加されます。複数のファイルを追加目的の作業状態にするには、単一のp4 addコマンドでワイルドカードを使用します。ファイルを再帰的に追加するためにPerforceの「...」ワイルドカードを使用することはできません。

プラットフォーム固有の再帰的なファイル追加(サブディレクトリ内のファイル追加)について詳しくは、Perforce knowledge baseの「Adding a Directory Tree」を参照してください。

http://answers.perforce.com/articles/KB_Article/Adding-a-Directory-Tree

C:\bruno_ws\dev\main\docs\manuals>p4 add *.txt
//depot/dev/main/docs/manuals/installnotes.txt#1 - opened for add
//depot/dev/main/docs/manuals/requirements.txt#1 - opened for add

Change: new
Client: bruno_ws
User:   bruno
Status: new
Description:
        <enter description here>
Type:   public
Files:
    //depot/dev/main/docs/manuals/installnotes.txt   # add
    //depot/dev/main/docs/manuals/requirements.txt   # add

[Description:]フィールドにはコメントを入力しなければなりません。[Files:]フィールドからは行を削除しても構いません。このリストから削除されたファイルは、次のデフォルトチェンジリストに移動され、次回デフォルトチェンジリストをサブミットしたときにリスト表示されます。

ディポに存在しないディレクトリにファイルを追加すると、チェンジリストのサブミットが成功したときにディポのディレクトリが作成されます。

[Type:]フィールドをpublicからrestrictedに変更することにより、チェンジリストの可視性が制限できます。一般に、チェンジリストがrestrictedである場合、チェンジリスト内の1つ以上のファイルに対してlistアクセス権限を持つユーザに対してのみ、チェンジリストの説明が表示されます。

開発プロセスでは、ディポにサブミットすべきでない無関係なコンテンツが作成されることがあります。開発中にコンパイラによってオブジェクトファイルや実行可能モジュールが生成され、テキストエディタやワードプロセッサによってバックアップファイルが生成され、さらにユーザ自身が習慣として作業メモを保存する場合もあります。

ファイル(またはファイルのグループ)をその追加時に無視するには、無視するファイルの仕様をリストにしたファイルを作成し、P4IGNORE環境変数がこのファイルを指すように設定します。

ファイルを追加する際、追加対象ファイルの完全なローカルパスおよびその親ディレクトリが、P4IGNOREファイルと照合されます。P4IGNOREファイルが存在する場合、その中のルールがリストに追加され、追加対象ファイルに最も近いP4IGNOREルールが優先的に適用されます。

P4IGNOREファイルの構文は、Perforceの構文と同じではありません。むしろ、他のバージョン化システムで使用されるものに似ています。ファイルはローカルシンタックスで指定されます。行頭の#文字はコメントを示し、行頭の!文字はそのファイル仕様を除外し、ワイルドカード*はサブ文字列に一致します。Perforceのワイルドカードの「...」は使用できません。

# Ignore .p4ignore files
.p4ignore
# Ignore object files, shared libraries, executables
*.dll
*.so
*.exe
*.o
# Ignore all text files except readme file
*.txt
!readme.txt

P4IGNOREファイルをオーバーライド(または無視)するには、p4 add、p4 reconcile、p4 statusの各コマンドに-Iオプションを付けます。

ファイルをedit目的で作業状態にするには、p4 editコマンドを発行します。ファイルを編集目的の作業状態にすると、Perforceはユーザのワークスペースのファイルに対し書き込み許可を与え、そのファイルをチェンジリストに追加します。ファイルがディポには存在してもユーザのワークスペースには存在しない場合、編集目的の作業状態にする前にそのファイルを同期させる必要があります。また、ファイルを編集する前に、編集目的の作業状態にしなければなりません。

p4 sync //depot/dev/command.c
//depot/dev/command.c#8 - added as c:\bruno_ws\dev\command.c

p4 edit //depot/dev/command.c
//depot/dev/command.c#8 - opened for edit

作業状態にしたファイルをチェンジリストから削除して、それまで行った変更を破棄するには、p4 revertコマンドを発行します。ファイルを元に戻すと、Perforceは最後にワークスペースに同期されたバージョンをリストアします。追加目的で作業状態にしたファイルを元に戻す場合、ファイルはチェンジリストからは削除されますがワークスペースからは削除されません。

p4 revert *.txt
//depot/dev/main/docs/manuals/installnotes.txt#none - was add, abandoned
//depot/dev/main/docs/manuals/requirements.txt#none - was add, abandoned

実際にはファイルを元に戻さずに、元に戻す操作の結果をプレビューするには、p4 revertコマンドの発行時に-nオプションを指定します。

ファイルをディポから削除するには、p4 deleteコマンドを発行して削除対象ファイルを作業状態にし、それらが作業状態にされているチェンジリストをサブミットします。ファイルをディポから削除しても以前のリビジョンは存在したままで、「削除済み」とマークされた新しい最新リビジョンが追加されます。したがってファイルの古いリビジョンを同期させることは依然として可能です。

p4 deleteコマンドを発行すると、ファイルはワークスペースからは削除されますがディポからは削除されません。削除目的で作業状態にされたファイルを復元すると、それらはワークスペースに復元されます。ファイルが作業状態にされたチェンジリストのサブミットが成功すると、ファイルはディポから削除されます。

p4 delete //depot/dev/main/docs/manuals/vendor.doc
//depot/dev/main/docs/manuals/vendor.doc#1 - opened for delete

番号付チェンジリストを作成するには、p4 changeコマンドを発行します。このコマンドによりチェンジリストフォームが表示されます。コメントを入力し、必要な変更を行ってからフォームを保存し、エディタを終了します。

デフォルトチェンジリストで作業状態になっているすべてのファイルが新しいチェンジリストに移動します。テキストエディタを終了すると、チェンジリストに番号が割り当てられます。ファイルをこのチェンジリストから削除すると、それらのファイルはデフォルトチェンジリストに戻ります。

C:\bruno_ws\>p4 sync //depot/dev/main/jam/*.c
[list of files synced...]

C:\bruno_ws>p4 edit //depot/dev/main/jam/*.c
[list of files opened for edit...]

C:\bruno_ws\dev\main\docs\manuals>p4 change

    [Enter description and save form]

Change 777 created with 33 open file(s).

サブミット済みチェンジリストに割り当てられる番号は、チェンジリストがサブミットされた順番を表します。チェンジリストがサブミットされるとき、以下の例で示すようにPerforceが番号を付け替える場合があります。

作業中チェンジリストをサブミットするには、p4 submitコマンドを発行します。p4 submitコマンドを発行すると、フォームが表示され、チェンジリストにあるファイルがそこにリストされます。このリストからファイルを取り除くこともできます。取り除いたファイルは、サブミットまたは復元を行わない限り、デフォルトの作業中チェンジリスト内に作業状態のまま残ります。

デフォルトチェンジリストで作業状態にされている特定のファイルをサブミットするには、p4 submit filenameコマンドを発行します。ファイルの集合を指定するには、ワイルドカードを使用します。例えば、デフォルトチェンジリストで作業状態にされているすべてのテキストファイルをサブミットするには、p4 submit "*".txtと入力します。(エスケープコードとして引用符を*ワイルドカードの前後に付けて、ローカルコマンドシェルにより解釈されないようにしてください)。

チェンジリストフォームを保存してテキストエディタを終了すると、チェンジリストがPerforceサービスにサブミットされ、ディポのファイルが更新されます。チェンジリストのサブミットが成功すると、それを変更できるのはPerforce管理者のみとなり、変更可能なフィールドはコメントおよびユーザ名のみになります。

デフォルトチェンジリストのサブミットの際にエラーが発生した場合、Perforceはサブミットしようとしたファイルを含む番号付チェンジリストを作成します。問題の修正後、-cオプションを使用して番号付チェンジリストをサブミットしなければなりません。

Perforceは編集目的で作業状態にしたファイルを書き込み可能にして、それらのファイルを含むチェンジリストのサブミットが成功したときに書き込み禁止にします。Perforceによるワークスペース管理と衝突しないようにするため、ファイルの書き込み権限を手動で変更しないでください。

チェンジリストをコミットする前に、p4 submitは少しの間、サブミットされるすべてのファイルをロックします。ロックもサブミットもされないファイルが存在する場合、そのファイルは番号付き作業中チェンジリストにおいて作業状態のままになります。既定では、サブミット操作に失敗したファイルは、submit.unlocklocked構成可能変数が設定されていない限り、ロックされたままになります。サブミットに失敗した場合、たとえサブミット前に手動でロックされていたとしても、submit.unlocklockedが設定されていれば、ファイルのロックは解除されます。

作業中チェンジリストを削除するには、まずそのチェンジリストに関連付けられているすべてのファイルおよびジョブを削除した後、p4 change -d changenumコマンドを発行します。関連する操作には以下のものが含まれます。

既にサブミットされたチェンジリストの削除は、Perforce管理者のみが実行可能です。詳細については、『Perforceサーバ管理者ガイド: 基本』を参照してください。

ファイルのリネームまたは移動を行うには、まずファイルを追加または編集目的で作業状態にしてから、p4 moveコマンドを使用します。

p4 move source_file target_file

ファイルの集合を移動するには、source_file指定子とtarget_file指定子とで一致するワイルドカードを使用します。ファイルを移動するには、指定されたファイルに対するPerforceのwrite権限が必要です。Perforce権限に関して詳しくは、『Perforceサーバ管理者ガイド: 基本』を参照してください。

p4 moveを使用してファイルのリネームまたは移動を行うとき、バージョン化サービスは削除された先行ファイルにリンクする反映記録も作成して、ファイルの履歴を保存します。反映操作はブランチの作成および変更の伝達にも使用されます。詳細については、変更を反映させるを参照してください。

Perforceの保留機能では、チェンジリストをディポにチェックインすることなく、自分のファイルのコピーを他のユーザが使用できるようにすることができます。

保留機能は、変更をチェックインする前にタスクを切り替えたり、クロスプラットフォームテストを実行したりする個々の開発者にとって有効です。また、保留機能により、チームに変更を容易に引き継ぐことやコードレビューを実行することが可能です。

$ p4 edit //depot/dev/command.c
//depot/dev/command.c#9 - opened for edit
...

$ p4 shelve
Change 123 created with 1 open file(s).
Shelving files for change 123.
edit //depot/dev/command.c#9
Change 123 files shelved.

保留されたファイルは、それらを保留したときのチェンジリスト内で作業状態のまま残されます。(既存の保留状態のチェンジリストにファイルを追加するには、まずそのファイルを当該チェンジリストで作業状態にしなければなりません。)ユーザは保留されたファイルに影響を与えることなく、ワークスペース内のファイルへの作業を続行することができます。保留されたファイルは、他のユーザが所有するワークスペースも含め、他のワークスペースに同期させることができます。例:

C:\bruno_ws\dev> p4 unshelve -s 123 //depot/dev/command.c
//depot/dev/command.c#9 - unshelved, opened for edit

ファイルを保留すると、保留状態のバージョンは、ユーザがワークスペースで実行するコマンド(他の作業を行うためにファイルを元に戻す操作も含めて)の影響を受けません。

$ p4 revert //depot/dev/command.c
//depot/dev/command.c#9 - was edit, reverted

$ p4 unshelve -s 123 -c 124 //depot/dev/command.c
//depot/dev/command.c#9 - unshelved, opened for edit

p4 submitコマンドには-eオプションがあり、これを使用すると保留されたファイルを直接チェンジリストからサブミットできます。保留状態のチェンジリストにあるすべてのファイルが最新であり、衝突解決されている必要があります。ストリームターゲットに保留されているファイルには、その他の制限が適用される場合があります。詳しくは、『P4コマンドリファレンス』を参照してください。(これらの制限に対処せずに済むように、チェンジリストをサブミットする前に、保留状態のファイルをいつでも新しい作業中チェンジリストに移動することができます。)

C:\bruno_ws\dev> p4 shelve -d -c 124
Shelve 124 deleted.

C:\bruno_ws\dev> p4 submit -c 124
Change 124 submitted.

チェンジリストの簡潔な情報を表示するには、p4 changesコマンドを使用します。詳細な情報を表示するには、p4 describeコマンドを使用します。以下の表に有用なレポートコマンドおよびオプションをいくつか記述します。

詳細については、チェンジリストのレポートを参照してください。