Perforce Software

P4Web "sync" Help Page

[Return to "How to Use P4Web"]

The Sync command allows you to update your client to reflect the mapping between your client view and the contents of the depot.

Sync adds files that are in the client view but which have not been retrieved before. Sync deletes previously retrieved files which are no longer in the client view or have been deleted from the depot. Sync updates files which are still in the client view and which have been updated in the depot.

Command:

Two versions of the Sync command are available:

Options:

Four options are provided:

Head revision:

Sync to the head revision (latest version) of the file.

This is the default option.

Revision number:

Sync to a specific version number of the file. Enter the revision number in the space provided.

Label, Changelist or Date:

Sync to the revision stored in the named label, as of the specified changelist number, or as of the specified date. Enter the label, changelist, or date in the space provided.

Same Revision:

Force a Sync to the revision last checked-out. (This option is typically used if you've deleted a file in your client workspace by means of your local operating system; since P4Web doesn't know the file is no longer in your workspace, you may need to explicitly tell it to refresh the file to get it back with a Sync.)
Additionally, you can "force" a Sync by checking the radio button marked "Force". "Forcing" a sync instructs the Perforce server to get a fresh copy of the file from the depot, even if Perforce thinks the revision you have in your client workspace is already up-to-date.

Files:

Specifies which files will be synced. Choose between:

All Files:

All files in the current client view will be included when looking at which files to sync.

This is the default option.

Files in //client-path:

  • ...and subdirectories:
    Files in the specified client path and all directories below will be synced.

    This is equivalent to the command line:
    p4 sync //client-path/...

  • ...at this level only:
    Only files in the specified client path will be synced. Any files in directories beneath the client path will be untouched.

    This is equivalent to the command line:
    p4 sync //client-path/*

Selected Files:

If files at the current directory level are eligible for the operation (e.g. unopened files for Open for Edit, already-opened files for Revert files), a list of such files will appear.

To include or exclude individual files from the operation, click on the checkboxes for each file, and activate the radio button for the Selected Files option.

[Return to "How to Use P4Web"]


Copyright 2000 Perforce Software
$Id: //depot/r99.2/p4-doc/manuals/p4web/help/sync.html#2 $